Làm việc với đoạn văn
Đoạn văn là một tập hợp các ký tự được kết hợp thành một khối logic và kết thúc bằng một ký tự đặc biệt – ngắt đoạn. Trong Aspose.Words, một đoạn văn được thể hiện bằng lớp Paragraph.
Chèn một đoạn văn
Để chèn một đoạn văn mới vào tài liệu, trên thực tế, bạn cần chèn ký tự ngắt đoạn vào đó. DocumentBuilder.writeln cũng chèn một chuỗi văn bản vào tài liệu nhưng ngoài ra, nó còn thêm dấu ngắt đoạn.
Định dạng phông chữ hiện tại cũng được xác định bởi thuộc tính font và định dạng đoạn văn hiện tại được xác định bởi thuộc tính paragraph_format.
Ví dụ mã sau đây cho thấy cách chèn một đoạn văn vào tài liệu:
Định dạng đoạn
Định dạng đoạn văn hiện tại được thể hiện bằng đối tượng ParagraphFormat được thuộc tính paragraph_format trả về. Đối tượng này đóng gói các thuộc tính định dạng đoạn văn khác nhau có sẵn trong Microsoft Word. Bạn có thể dễ dàng đặt lại định dạng đoạn văn về mặc định thành Kiểu bình thường, căn trái, không thụt lề, không khoảng cách, không viền và không đổ bóng bằng cách gọi clear_formatting.
Ví dụ mã sau đây cho biết cách đặt định dạng đoạn văn:
Áp dụng kiểu đoạn văn
Một số đối tượng định dạng như kiểu hỗ trợ Font hoặc ParagraphFormat. Một kiểu dựng sẵn hoặc do người dùng xác định được thể hiện bằng một đối tượng Style chứa các thuộc tính kiểu tương ứng như tên, kiểu cơ sở, phông chữ và định dạng đoạn văn của kiểu đó, v.v.
Hơn nữa, đối tượng Style cung cấp thuộc tính Style.style_identifier trả về mã định danh kiểu độc lập với miền địa phương được biểu thị bằng giá trị liệt kê StyleIdentifier. Vấn đề là tên của các kiểu tích hợp trong Microsoft Word được bản địa hóa cho các ngôn ngữ khác nhau. Bằng cách sử dụng mã định danh kiểu, bạn có thể tìm thấy kiểu chính xác bất kể ngôn ngữ tài liệu. Các giá trị liệt kê tương ứng với các kiểu dựng sẵn Microsoft Word như Bình thường, Tiêu đề 1, Tiêu đề 2, v.v. Tất cả các kiểu do người dùng xác định đều được gán giá trị StyleIdentifier.USER
Ví dụ mã sau đây cho thấy cách áp dụng kiểu đoạn văn:
Chèn dấu phân cách kiểu để đặt các kiểu đoạn văn khác nhau
Có thể thêm dấu phân cách kiểu vào cuối đoạn văn bằng cách sử dụng phím tắt Ctrl + Alt + Enter trong MS Word. Tính năng này cho phép sử dụng hai kiểu đoạn văn khác nhau trong một đoạn văn được in logic. Nếu bạn muốn một số văn bản ở đầu một tiêu đề cụ thể xuất hiện trong Mục lục nhưng không muốn toàn bộ tiêu đề đó trong Mục lục, bạn có thể sử dụng tính năng này
Ví dụ mã sau đây cho thấy cách chèn dấu phân cách kiểu để phù hợp với các kiểu đoạn văn khác nhau:
Xác định dấu phân cách kiểu đoạn văn
Aspose.Words cung cấp một thuộc tính công khai break_is_style_separator thành một lớp Paragraph cho phép xác định Đoạn phân cách kiểu dáng như trong ví dụ đưa ra dưới đây:
Áp dụng viền và tô bóng cho đoạn văn
Biên giới được đại diện bởi BorderCollection. Đây là tập hợp các đối tượng Border được truy cập theo chỉ mục hoặc theo loại đường viền. Kiểu đường viền được thể hiện bằng bảng liệt kê BorderType. Một số giá trị của bảng liệt kê có thể áp dụng cho một số hoặc chỉ một phần tử tài liệu. Ví dụ: BorderType.BOTTOM có thể áp dụng cho một đoạn văn hoặc ô bảng trong khi BorderType.DIAGONALDOWN chỉ chỉ định đường viền chéo trong ô bảng.
Cả bộ sưu tập đường viền và mỗi đường viền riêng biệt đều có các thuộc tính tương tự như màu sắc, kiểu đường kẻ, độ rộng đường kẻ, khoảng cách từ văn bản và bóng tùy chọn. Chúng được đại diện bởi các thuộc tính cùng tên. Bạn có thể đạt được các loại đường viền khác nhau bằng cách kết hợp các giá trị thuộc tính. Ngoài ra, cả hai đối tượng BorderCollection và Border đều cho phép bạn đặt lại các giá trị này về mặc định bằng cách gọi phương thức Border.clear_formatting.
Aspose.Words còn có lớp Shading chứa các thuộc tính đổ bóng cho các thành phần tài liệu. Bạn có thể đặt kết cấu bóng mong muốn và màu sắc được áp dụng cho nền và nền trước của phần tử.
Kết cấu bóng được đặt bằng giá trị liệt kê TextureIndex cho phép áp dụng các mẫu khác nhau cho đối tượng Shading. Ví dụ: để đặt màu nền cho thành phần tài liệu, hãy sử dụng giá trị TextureIndex.TEXTURE_SOLID và đặt màu bóng nền trước cho phù hợp. Ví dụ dưới đây cho thấy cách áp dụng đường viền và bóng cho một đoạn văn.
Ví dụ mã sau đây cho thấy cách áp dụng đường viền và tô bóng cho một đoạn văn: