Documentation – Tổng quan về trình Tạo tài liệu trong C++

Cpp: Điều hướng với Con Trỏ trong C++

Mon, 01 Jan 0001 00:00:00 +0000

Trong khi làm việc với một tài liệu, ngay cả khi nó là một tài liệu ngắn hoặc dài, bạn sẽ cần phải điều hướng qua tài liệu của mình. Điều hướng bằng con trỏ ảo thể hiện khả năng điều hướng giữa các nút khác nhau trong tài liệu.

Trong một tài liệu ngắn, di chuyển xung quanh trong một tài liệu rất đơn giản vì bạn có thể di chuyển điểm chèn ngay cả bằng cách sử dụng các phím mũi tên của bàn phím hoặc bằng cách nhấp chuột để xác định vị trí điểm chèn bất cứ nơi nào bạn muốn. Nhưng một khi bạn có một tài liệu lớn có nhiều trang, những kỹ thuật cơ bản này sẽ không đủ.

Bài viết này giải thích cách di chuyển trong tài liệu và điều hướng bằng con trỏ ảo đến các phần khác nhau của nó.

Phát Hiện Vị Trí Con Trỏ Hiện Tại

Trước khi bắt đầu quá trình điều hướng qua tài liệu của bạn, bạn sẽ cần lấy nút hiện đang được chọn. Bạn có thể lấy vị trí chính xác của con trỏ tại một nút đã chọn bằng cách sử dụng thuộc tính CurrentNode. Ngoài ra, thay vì lấy nút hiện tại, bạn có thể lấy đoạn hiện được chọn hoặc phần hiện được chọn bằng cách sử dụng thuộc tính CurrentParagraph và CurrentSection.

Bất kỳ thao tác chèn nào bạn thực hiện bằng DocumentBuilder sẽ được chèn trước CurrentNode. Khi đoạn hiện tại trống hoặc con trỏ được định vị ngay trước khi kết thúc đoạn, CurrentNode trả về nullptr.

Điều Hướng Các Phương thức Trong Tài liệu

Khi bạn đang chỉnh sửa văn bản, điều quan trọng là phải biết cách điều hướng tài liệu của bạn và nơi chính xác để di chuyển trong đó. Aspose.Words cho phép bạn di chuyển xung quanh trong một tài liệu và điều hướng đến các phần và phần khác nhau của nó – điều này tương tự như chức năng của Ngăn Điều hướng trong Microsoft Word để chuyển đến một trang hoặc tiêu đề trong Tài liệu Word mà không cần cuộn.

Phương pháp chính là có thể di chuyển vị trí con trỏ đến một nút cụ thể trong tài liệu của bạn, bạn có thể đạt được điều này bằng cách sử dụng phương thức MoveTo.

Ví dụ mã sau đây cho thấy cách di chuyển DocumentBuilder đến các nút khác nhau trong tài liệu:

Nhưng bên cạnh phương pháp MoveTo cơ bản, còn có những phương pháp cụ thể hơn.

Điều hướng Đến Đầu Hoặc Cuối Tài liệu

Bạn có thể đi đến đầu hoặc cuối tài liệu của mình bằng các phương thức MoveToDocumentStart và MoveToDocumentEnd.

Ví dụ mã sau đây cho thấy cách di chuyển vị trí con trỏ đến đầu hoặc cuối tài liệu:

Điều Hướng Với Dấu Trang

Bạn có thể đánh dấu một nơi mà bạn muốn tìm và di chuyển đến đó một cách dễ dàng. Bạn có thể chèn bao nhiêu dấu trang vào tài liệu của mình tùy thích, sau đó điều hướng qua chúng bằng cách xác định các dấu trang có tên duy nhất. Bạn có thể di chuyển đến dấu trang bằng cách sử dụng phương thức MoveToBookmark.

Các ví dụ mã sau đây cho thấy cách di chuyển vị trí con trỏ đến dấu trang:

Điều hướng Đến Các Ô Bảng

Bạn có thể di chuyển đến một ô bảng bằng cách sử dụng phương thức MoveToCell. Phương pháp này sẽ cho phép bạn điều hướng con trỏ của mình vào bất kỳ ô nào trong một bảng cụ thể. Ngoài ra, bạn có thể chỉ định một chỉ mục để di chuyển con trỏ đến bất kỳ vị trí hoặc ký tự được chỉ định nào trong một ô trong phương thức MoveToCell.

Ví dụ mã sau đây cho thấy cách di chuyển vị trí con trỏ đến một ô bảng được chỉ định:

Điều hướng Đến Một Lĩnh vực

Bạn có thể di chuyển đến một trường cụ thể trong tài liệu của mình bằng cách sử dụng phương thức MoveToField. Ngoài ra, bạn có thể di chuyển đến một trường hợp nhất cụ thể bằng cách sử dụng phương thức MoveToMergeField.

Ví dụ mã sau đây cho thấy cách di chuyển con trỏ trình tạo tài liệu sang một trường cụ thể:

Điều hướng Đến Tiêu đề hoặc Chân Trang

Bạn có thể di chuyển đến đầu tiêu đề hoặc chân trang bằng cách sử dụng phương thức MoveToHeaderFooter.

Ví dụ mã sau đây cho thấy cách di chuyển con trỏ trình tạo tài liệu sang tiêu đề hoặc chân trang tài liệu:

Điều hướng Đến Một Phần hoặc Đoạn văn

Bạn có thể chuyển đến một phần hoặc đoạn cụ thể bằng cách sử dụng các phương thức MoveToParagraph hoặc MoveToSection. Ngoài ra, bạn có thể chỉ định một chỉ mục để di chuyển con trỏ đến bất kỳ vị trí nào hoặc một ký tự được chỉ định trong một đoạn trong phương thức MoveToParagraph.

Ví dụ mã sau đây cho thấy cách di chuyển đến một phần cụ thể và một đoạn cụ thể trong tài liệu:

Cpp: Sử dụng DocumentBuilder Để Chèn Các Phần Tử Tài liệu

Mon, 01 Jan 0001 00:00:00 +0000

DocumentBuilder được sử dụng để sửa đổi tài liệu. Bài viết này giải thích và mô tả cách thực hiện một số nhiệm vụ:

Chèn Một Chuỗi Văn Bản

Chỉ cần chuyển chuỗi văn bản bạn cần chèn vào tài liệu sang phương thức DocumentBuilder.Write. Định dạng văn bản được xác định bởi thuộc tính Font. Đối tượng này chứa các thuộc tính phông chữ khác nhau (tên phông chữ, kích thước phông chữ, màu sắc, v. v.). Một số thuộc tính phông chữ quan trọng cũng được thể hiện bằng các thuộc tính DocumentBuilder để cho phép bạn truy cập chúng trực tiếp. Đây là Các thuộc tính Boolean Font.Bold, Font.Italic và Font.Underline.

Lưu ý rằng định dạng ký tự bạn đặt sẽ áp dụng cho tất cả văn bản được chèn từ vị trí hiện tại trong tài liệu trở đi.

Ví dụ Dưới Đây Chèn văn bản được định dạng bằng DocumentBuilder.

Chèn Một Đoạn Văn

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 một đoạn ngắt. Định dạng phông chữ hiện tại cũng được chỉ định bởi thuộc tính DocumentBuilder.Font và định dạng đoạn hiện tại được xác định bởi thuộc tính DocumentBuilder.ParagraphFormat. Ví dụ dưới đây cho thấy cách chèn một đoạn vào tài liệu.

Chèn Một Bảng

Thuật toán cơ bản để tạo bảng bằng DocumentBuilder rất đơn giản:

Bắt đầu bảng bằng DocumentBuilder.StartTable.
Chèn một ô bằng DocumentBuilder.InsertCell. Điều này tự động bắt đầu một hàng mới. Nếu cần, hãy sử dụng thuộc tính DocumentBuilder.CellFormat để chỉ định định dạng ô.
Chèn nội dung ô bằng phương thức DocumentBuilder.
Lặp lại các bước 2 và 3 cho đến khi hàng hoàn tất.
Gọi DocumentBuilder.EndRow để kết thúc hàng hiện tại. Nếu cần, hãy sử dụng thuộc tính DocumentBuilder.RowFormat để chỉ định định dạng hàng.
Lặp lại các bước 2 - 5 cho đến khi bảng hoàn tất.
Gọi DocumentBuilder.EndTable để hoàn thành việc xây dựng bảng. Các phương pháp tạo bảng DocumentBuilder thích hợp được mô tả dưới đây.

Bắt Đầu Một Bảng

Gọi DocumentBuilder.StartTable là bước đầu tiên trong việc xây dựng một bảng. Nó cũng có thể được gọi bên trong một ô, trong trường hợp đó nó bắt đầu một bảng lồng nhau. Phương thức tiếp theo để gọi là DocumentBuilder.InsertCell.

Chèn Một Ô

Sau khi bạn gọi DocumentBuilder->InsertCell, một ô mới được tạo và bất kỳ nội dung nào bạn thêm bằng các phương thức khác của lớp DocumentBuilder sẽ được thêm vào ô hiện tại. Để bắt đầu một ô mới trong cùng một hàng, hãy gọi lại DocumentBuilder->InsertCell. Sử dụng thuộc tính DocumentBuilder.CellFormat để chỉ định định dạng ô. Nó trả về một đối tượng CellFormat đại diện cho tất cả các định dạng cho một ô bảng.

Kết thúc Một Hàng

Gọi DocumentBuilder.EndRow để hoàn thành hàng hiện tại. Nếu bạn gọi DocumentBuilder->InsertCell ngay sau đó, thì bảng tiếp tục trên một hàng mới.

Sử dụng thuộc tính DocumentBuilder.RowFormat để chỉ định định dạng hàng. Nó trả về một đối tượng RowFormat đại diện cho tất cả các định dạng cho một hàng bảng.

Kết Thúc Một Bảng

Gọi DocumentBuilder.EndTable để hoàn thành bảng hiện tại. Phương thức này chỉ nên được gọi một lần sau khi DocumentBuilder->EndRow được gọi. Khi được gọi, DocumentBuilder.EndTable di chuyển con trỏ ra khỏi ô hiện tại đến một vị trí ngay sau bảng. Ví dụ sau đây cho thấy cách xây dựng một bảng được định dạng có chứa các hàng 2 và các cột 2.

Chèn Một Break

Nếu bạn muốn bắt đầu rõ ràng một dòng, đoạn văn, cột, phần hoặc trang mới, hãy gọi DocumentBuilder.InsertBreak. Chuyển đến phương thức này loại ngắt bạn cần chèn được biểu thị bằng liệt kê BreakType. Ví dụ dưới đây cho thấy cách chèn ngắt trang vào tài liệu.

Chèn Một Hình ảnh

DocumentBuilder cung cấp một số quá tải của phương thức DocumentBuilder->InsertImage cho phép bạn chèn một hình ảnh nội tuyến hoặc nổi. Nếu hình ảnh là một metafile EMF hoặc WMF, nó sẽ được chèn vào tài liệu ở định dạng metafile. Tất cả các hình ảnh khác sẽ được lưu trữ ở định dạng PNG. Phương thức DocumentBuilder->InsertImage có thể sử dụng hình ảnh từ các nguồn khác nhau:

Từ một tệp hoặc URL bằng cách truyền tham số chuỗi DocumentBuilder->InsertImage.
Từ một luồng bằng cách truyền tham số Stream DocumentBuilder->InsertImage.
Từ một Đối tượng Hình ảnh bằng cách chuyển Một Tham số Hình ảnh DocumentBuilder->InsertImage.
Từ một mảng byte bằng cách truyền tham số mảng byte DocumentBuilder.InsertImage.Đối với mỗi phương thức DocumentBuilder->InsertImage, có những quá tải khác cho phép bạn chèn hình ảnh với các tùy chọn sau:
Nội tuyến hoặc nổi ở một vị trí cụ thể, ví dụ: DocumentBuilder->InsertImage.
Tỷ lệ phần trăm hoặc kích thước tùy chỉnh, ví dụ: DocumentBuilder.InsertImage. Hơn nữa, phương thức DocumentBuilder->InsertImage trả về một đối tượng Shape vừa được tạo và chèn để bạn có thể sửa đổi thêm các thuộc tính của Hình dạng.

Chèn Một Hình Ảnh Nội tuyến

Chuyển một chuỗi duy nhất đại diện cho một tệp chứa hình ảnh đến DocumentBuilder->InsertImage để chèn hình ảnh vào tài liệu dưới dạng đồ họa nội tuyến. Ví dụ dưới đây cho thấy cách chèn hình ảnh nội tuyến ở vị trí con trỏ vào tài liệu.

Chèn Hình Ảnh Nổi (Vị Trí Tuyệt Đối)

Ví dụ này chèn một hình ảnh nổi từ một tệp hoặc URL ở một vị trí và kích thước được chỉ định.

Chèn Dấu Trang

Để chèn dấu trang vào tài liệu, bạn nên làm như sau:

Gọi DocumentBuilder->StartBookmark chuyển cho nó tên mong muốn của dấu trang.
Chèn văn bản dấu trang bằng các phương thức DocumentBuilder.
Gọi DocumentBuilder.EndBookmark chuyển nó cùng tên mà bạn đã sử dụng với DocumentBuilder->StartBookmark.
Dấu trang có thể chồng chéo và kéo dài bất kỳ phạm vi nào. Để tạo dấu trang hợp lệ, bạn cần gọi cả DocumentBuilder->StartBookmark và DocumentBuilder->EndBookmark có cùng tên dấu trang.

Dấu trang hoặc dấu trang bị lỗi với tên trùng lặp sẽ bị bỏ qua khi tài liệu được lưu.

Ví dụ dưới đây cho thấy cách chèn dấu trang vào tài liệu bằng trình tạo tài liệu.

Chèn Trường <code>Form</code>

Các trường biểu mẫu là một trường Hợp Cụ thể của Các trường Từ cho phép “tương tác” với người dùng. Các trường biểu mẫu trong Microsoft Word bao gồm hộp văn bản, hộp tổ hợp và hộp kiểm.DocumentBuilder cung cấp các phương thức đặc biệt để chèn từng loại trường biểu mẫu vào tài liệu: DocumentBuilder.InsertTextInput, DocumentBuilder->InsertCheckBox và DocumentBuilder.InsertComboBox. Lưu ý rằng nếu bạn chỉ định tên cho trường biểu mẫu, thì dấu trang sẽ tự động được tạo với cùng tên.

Chèn Một Đầu Vào Văn Bản

DocumentBuilder.InsertTextInput để chèn một hộp văn bản vào tài liệu. Ví dụ dưới đây cho thấy cách chèn trường biểu mẫu nhập văn bản vào tài liệu.

Chèn Một Hộp Kiểm

Gọi DocumentBuilder.InsertCheckBox để chèn hộp kiểm vào tài liệu. Ví dụ dưới đây cho thấy cách chèn trường biểu mẫu hộp kiểm vào tài liệu.

Chèn Một Hộp Tổ hợp

Gọi DocumentBuilder.InsertComboBox để chèn một hộp tổ hợp vào tài liệu. Ví dụ dưới đây cho thấy cách chèn trường biểu mẫu hộp tổ hợp vào tài liệu.

Chèn Ngôn ngữ Ở Cấp Trường

Khách hàng có thể chỉ định Ngôn ngữ ở cấp trường ngay bây giờ và có thể đạt được kiểm soát tốt hơn. Id miền địa phương có thể được liên kết với mỗi trường bên trong DocumentBuilder. Các ví dụ dưới đây minh họa cách sử dụng tùy chọn này.

Chèn Một Siêu Liên kết

Sử dụng DocumentBuilder.InsertHyperlink để chèn một siêu liên kết vào tài liệu. Phương pháp này chấp nhận ba tham số: văn bản của liên kết sẽ được hiển thị trong tài liệu, đích liên kết (URL hoặc tên của dấu trang bên trong tài liệu) và tham số boolean phải đúng nếu URL là tên của dấu trang bên trong tài liệu.DocumentBuilder.InsertHyperlink gọi nội bộ DocumentBuilder.InsertField.Phương pháp này luôn thêm dấu nháy đơn ở đầu và cuối URL. Lưu ý rằng bạn cần chỉ định định dạng phông chữ cho văn bản hiển thị siêu liên kết một cách rõ ràng bằng thuộc tính Font. Ví dụ dưới đây chèn một siêu liên kết vào tài liệu bằng DocumentBuilder.

Chèn Đối Tượng Ole

Nếu bạn muốn Gọi Đối tượng Ole DocumentBuilder.InsertOleObject. Chuyển đến phương thức này ProgId rõ ràng với các tham số khác. Ví dụ dưới đây cho thấy cách chèn Đối tượng Ole vào tài liệu.

Đặt Tên Tệp và Phần Mở rộng khi Chèn Đối tượng Ole

OLE gói là một cách di sản và “không có giấy tờ” để lưu trữ đối tượng nhúng nếu trình xử lý OLE không xác định. Các phiên bản đầu Windows như Windows 3.1, 95 và 98 có Packager.ứng dụng exe có thể được sử dụng để nhúng bất kỳ loại dữ liệu nào vào tài liệu. Bây giờ, ứng dụng này bị loại trừ khỏi Windows Nhưng MS Word và các ứng dụng khác vẫn sử dụng nó để nhúng dữ liệu nếu trình xử lý OLE bị thiếu hoặc không xác định. Lớp OlePackage cho phép truy cập Thuộc tính Gói OLE. Ví dụ dưới đây cho thấy cách đặt tên tệp, tiện ích mở rộng và tên hiển thị Cho Gói OLE.

Chèn HTML

Bạn có thể dễ dàng chèn một chuỗi HTML có chứa một đoạn HTML hoặc toàn bộ tài liệu HTML vào Tài liệu Word. Chỉ cần chuyển chuỗi này sang phương thức DocumentBuilder->InsertHtml. Một trong những triển khai hữu ích của phương thức là lưu trữ chuỗi HTML trong cơ sở dữ liệu và chèn nó vào tài liệu trong Mail Merge để thêm nội dung được định dạng thay vì xây dựng nó bằng các phương pháp khác nhau của trình tạo tài liệu. Ví dụ dưới đây cho thấy chèn HTML vào tài liệu bằng DocumentBuilder.

Chèn Quy Tắc Ngang vào Tài Liệu

Ví dụ Be low code cho thấy cách chèn hình dạng quy tắc ngang vào tài liệu bằng phương thức DocumentBuilder->InsertHorizontalRule.

Cpp: Sử dụng DocumentBuilder Để Sửa Đổi Tài liệu Một Cách Dễ Dàng

Mon, 01 Jan 0001 00:00:00 +0000

Chỉ Định Định Dạng

Định Dạng Phông Chữ

Định dạng phông chữ hiện tại được biểu thị bằng một đối tượng Font được trả về bởi thuộc tính DocumentBuilder.Font. Lớp Font chứa nhiều thuộc tính phông chữ có thể có trong Microsoft Word. Ví dụ dưới đây cho thấy cách đặt định dạng phông chữ.

Định Dạng Đoạn Văn

Định dạng đoạn văn hiện tại được biểu diễn bằng một đối tượng ParagraphFormat được trả về bởi thuộc tính DocumentBuilder.ParagraphFormat. Đố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 thành 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 tô bóng bằng cách gọi ParagraphFormat.ClearFormatting. Ví dụ dưới đây cho thấy cách đặt định dạng đoạn văn.

Làm Việc Với Kiểu Chữ Châu Á

Tự Động Điều Chỉnh Không gian Giữa Văn Bản châu á và Latin, Số

Nếu bạn đang thiết kế một mẫu có cả văn bản Đông Á và latinh và bạn muốn nâng cao diện mạo của mẫu biểu mẫu bằng cách kiểm soát khoảng cách giữa cả hai loại văn bản, bạn có thể định cấu hình mẫu biểu mẫu của mình để tự động điều chỉnh khoảng cách giữa hai loại văn bản này. Bạn có thể sử dụng thuộc tính AddSpaceBetweenFarEastAndAlpha và AddSpaceBetweenFarEastAndDigit của lớp ParagraphFormat để đạt được điều này.

Ví dụ mã sau đây cho thấy cách sử dụng thuộc tính ParagraphFormat.AddSpaceBetweenFarEastAndAlpha và ParagraphFormat.AddSpaceBetweenFarEastAndDigit.

Thay Đổi Khoảng Cách Đoạn Văn Châu á và Thụt Lề

Ví dụ mã sau đây cho thấy cách thay đổi Khoảng Cách Đoạn Văn Và thụt Lề Châu á.

Đặt Tùy Chọn Ngắt Dòng

Tab kiểu chữ châu á của hộp thoại Paragraph thuộc tính trong MS Word có nhóm ngắt dòng. Các tùy chọn của nhóm này có thể được thiết lập bằng cách sử dụng FarEastLineBreakControl, WordWrap, HangingPunctuation thuộc tính của lớp ParagraphFormat. Ví dụ Be low code cho thấy cách sử dụng các thuộc tính này.

Định Dạng Ô

Định dạng ô được sử dụng trong quá trình xây dựng bảng. Nó được biểu diễn bằng một đối tượng CellFormat được trả về bởi thuộc tính DocumentBuilder.CellFormat. CellFormat đóng gói các thuộc tính ô bảng khác nhau như chiều rộng hoặc căn chỉnh dọc. Ví dụ dưới đây cho thấy cách tạo một bảng chứa một ô được định dạng duy nhất.

Định Dạng Hàng

Định dạng hàng hiện tại được xác định bởi một đối tượng RowFormat được trả về bởi thuộc tính DocumentBuilder.RowFormat. Đối tượng đóng gói thông tin về tất cả các định dạng hàng bảng. Ví dụ dưới đây cho thấy cách tạo một bảng có chứa một ô duy nhất và áp dụng định dạng hàng.

Định Dạng Danh Sách

Aspose.Words cho phép dễ dàng tạo danh sách bằng cách áp dụng định dạng danh sách. DocumentBuilder cung cấp thuộc tính DocumentBuilder.ListFormat trả về đối tượng ListFormat. Đối tượng này có một số phương thức để bắt đầu và kết thúc một danh sách và để tăng/giảm thụt lề. Có hai loại danh sách chung trong Microsoft Word: dấu đầu dòng và số.

Để bắt đầu một danh sách dấu đầu dòng, hãy gọi ListFormat.ApplyBulletDefault.
Để bắt đầu một danh sách được đánh số, hãy gọi ListFormat.ApplyNumberDefault.

Dấu đầu dòng hoặc số và định dạng được thêm vào đoạn hiện tại và tất cả các đoạn tiếp theo được tạo bằng DocumentBuilder cho đến khi ListFormat.RemoveNumbers được gọi để dừng định dạng danh sách dấu đầu dòng. Trong Tài liệu Word, danh sách có thể bao gồm tối đa chín cấp độ. Định dạng danh sách cho mỗi cấp chỉ định viên đạn hoặc số nào được sử dụng, thụt lề trái, khoảng trắng giữa viên đạn và văn bản, v. v.

Để tăng mức danh sách của đoạn hiện tại lên một cấp, hãy gọi ListFormat.ListIndent.
Để giảm mức danh sách của đoạn hiện tại xuống một cấp, hãy gọi ListFormat.ListOutdent.

Các phương thức thay đổi cấp danh sách và áp dụng các thuộc tính định dạng của cấp độ mới.

Bạn cũng có thể sử dụng thuộc tính ListFormat.ListLevelNumber để lấy hoặc đặt mức danh sách cho đoạn văn. Các cấp danh sách được đánh số 0 đến 8.

Ví dụ dưới đây cho thấy cách xây dựng danh sách đa cấp.

Thiết lập trang Và Định dạng Phần

Các thuộc tính thiết lập trang và phần được đóng gói trong đối tượng PageSetup được trả về bởi thuộc tính DocumentBuilder.PageSetup. Đối tượng chứa tất cả các thuộc tính thiết lập trang của một phần (lề trái, lề dưới, kích thước giấy, v. v.) làm thuộc tính. Ví dụ dưới đây cho thấy cách đặt các thuộc tính như kích thước trang và hướng cho phần hiện tại.

Áp dụng Một Phong cách

Một số đối tượng định dạng Như phông chữ hoặc kiểu hỗ trợ ParagraphFormat. Một kiểu được tích hợp sẵn hoặc do người dùng xác định được biểu thị 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, một đối tượng Style cung cấp thuộc tính Style.StyleIdentifier trả về một đị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ê Style.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. Sử dụng mã định danh kiểu, bạn có thể tìm đúng kiểu 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 tích hợp 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 được gán StyleIdentifier.User value. Ví dụ dưới đây cho thấy cách áp dụng kiểu đoạn văn.

Biên giới và Bóng

Biên giới được đại diện bởi BorderCollection. Đây là tập hợp Các Đối tượng Đường Viền được truy cập theo chỉ mục hoặc theo loại đường viền. Loại đường viền được biểu thị bằng cách liệt kê BorderType. Một số giá trị của bảng liệt kê được áp dụng cho một số hoặc chỉ một phần tử tài liệu. Ví dụ: BorderType.Bottom được áp dụng cho một ô đoạn văn hoặc ô bảng trong khi BorderType.DiagonalDown 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 thẳng, chiều rộng đường thẳng, 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 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.ClearFormatting. Lưu ý rằng khi các thuộc tính đường viền được đặt lại về giá trị mặc định, đường viền là vô hình. Lớp Shading chứa các thuộc tính đổ bóng cho các phần tử tài liệu. Bạn có thể đặt kết cấu tô bóng mong muốn và màu sắc được áp dụng cho nền và tiền cảnh của phần tử.

Kết cấu tô bóng được đặt với 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 phần tử tài liệu, hãy sử dụng giá trị TextureIndex.TextureSolid và đặt màu tô 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à tô bóng cho một đoạn văn.

Chụp Vào Lưới

Aspose.Words cung cấp hai thuộc tính ParagraphFormat.SnapToGrid và Font.SnapToGrid để lấy và đặt snap thuộc tính đoạn thành lưới.

Di chuyển Con Trỏ

Phát hiện Vị trí Con Trỏ Hiện Tại

Bạn có thể lấy nơi con trỏ của người xây dựng hiện đang được định vị bất cứ lúc nào. Thuộc tính DocumentBuilder.CurrentNode trả về nút hiện được chọn trong trình xây dựng này. Nút là một con trực tiếp của một đoạn văn. Bất kỳ thao tác chèn nào bạn thực hiện bằng DocumentBuilder sẽ chèn trước DocumentBuilder.CurrentNode. Khi đoạn hiện tại trống hoặc con trỏ được định vị ngay trước khi kết thúc đoạn, DocumentBuilder.CurrentNode trả về null.

Ngoài ra, bạn có thể sử dụng thuộc tính DocumentBuilder.CurrentParagraph, nhận đoạn văn hiện được chọn trong DocumentBuilder này. Ví dụ dưới đây cho thấy cách truy cập nút hiện tại trong trình tạo tài liệu. Bạn có thể tải xuống tệp mẫu của ví dụ này từ đây.

Di Chuyển đến Bất Kỳ Nút Nào (Đoạn văn và Con Cái của Họ)

Nếu bạn có một nút đối tượng tài liệu, là một đoạn văn hoặc một con trực tiếp của một đoạn văn, bạn có thể trỏ con trỏ của người xây dựng đến nút này. Sử dụng phương pháp DocumentBuilder.MoveTo để thực hiện việc này. Ví dụ dưới đây cho thấy cách di chuyển vị trí con trỏ đến một nút được chỉ định. Bạn có thể tải xuống tệp mẫu của ví dụ này từ đây.

Chuyển Đến Tài Liệu Bắt Đầu/Kết Thúc

Nếu bạn cần di chuyển đến đầu tài liệu, hãy gọi DocumentBuilder.MoveToDocumentStart. Nếu bạn cần di chuyển đến cuối tài liệu, hãy gọi DocumentBuilder.MoveToDocumentEnd. Ví dụ dưới đây cho thấy cách di chuyển vị trí con trỏ đến đầu hoặc cuối tài liệu. Bạn có thể tải xuống tệp mẫu của ví dụ này từ đây.

Di chuyển Đến Một Phần

Nếu bạn đang làm việc với một tài liệu có chứa nhiều phần, bạn có thể di chuyển đến một phần mong muốn bằng cách sử dụng DocumentBuilder.MoveToSection. Phương pháp này di chuyển con trỏ đến đầu một phần được chỉ định và chấp nhận chỉ mục của phần bắt buộc. Khi chỉ mục phần lớn hơn hoặc bằng 0, nó chỉ định một chỉ mục từ đầu tài liệu với 0 là phần đầu tiên. Khi chỉ mục phần nhỏ hơn 0, nó chỉ định một chỉ mục từ cuối tài liệu với -1 là phần cuối cùng. Ví dụ dưới đây cho thấy cách di chuyển vị trí con trỏ đến phần được chỉ định. Bạn có thể tải xuống tệp mẫu của ví dụ này từ đây.

Chuyển sang Tiêu Đề/Chân Trang

Khi bạn cần đặt một số dữ liệu vào đầu trang hoặc chân trang, trước tiên bạn nên di chuyển đến đó bằng DocumentBuilder.MoveToHeaderFooter. Phương thức chấp nhận giá trị liệt kê HeaderFooterType xác định loại đầu trang hoặc chân trang đến nơi con trỏ nên được di chuyển. Nếu bạn muốn tạo tiêu đề và chân trang khác nhau cho trang đầu tiên, bạn cần đặt thuộc tính PageSetup.DifferentFirstPageHeaderFooter thành true. Nếu bạn muốn tạo tiêu đề và chân trang khác nhau cho các trang chẵn và lẻ, bạn cần đặt PageSetup.OddAndEvenPagesHeaderFooter thành true.

Nếu bạn cần quay lại câu chuyện chính, hãy sử dụng DocumentBuilder.MoveToSection để di chuyển ra khỏi đầu trang hoặc chân trang. Ví dụ dưới đây tạo tiêu đề và chân trang trong tài liệu bằng DocumentBuilder.

Chuyển sang Một Đoạn Văn

Sử dụng DocumentBuilder.MoveToParagraph để di chuyển con trỏ đến một đoạn mong muốn trong phần hiện tại. Bạn nên chuyển hai tham số cho phương thức này: paragraphIndex (chỉ mục của đoạn văn để di chuyển đến) và characterIndex (chỉ mục của ký tự bên trong đoạn văn).

Điều hướng được thực hiện bên trong câu chuyện hiện tại của phần hiện tại. Đó là, nếu bạn di chuyển con trỏ đến tiêu đề chính của phần đầu tiên, thì paragraphIndex chỉ định chỉ mục của đoạn bên trong tiêu đề đó của phần đó.

Khi paragraphIndex lớn hơn hoặc bằng 0, nó chỉ định một chỉ mục từ đầu phần với 0 là đoạn đầu tiên. Khi paragraphIndex nhỏ hơn 0, nó chỉ định một chỉ mục từ cuối phần với -1 là đoạn cuối cùng.

Chỉ mục ký tự hiện chỉ có thể được chỉ định là 0 để di chuyển đến đầu đoạn hoặc -1 để di chuyển đến cuối đoạn. Ví dụ dưới đây cho thấy cách di chuyển vị trí con trỏ đến đoạn được chỉ định. Bạn có thể tải xuống tệp mẫu của ví dụ này từ đây.

Di chuyển đến Một Ô Bảng

Sử dụng DocumentBuilder.MoveToCell nếu bạn cần di chuyển con trỏ đến một ô bảng trong phần hiện tại. Phương pháp này chấp nhận bốn tham số:

tableIndex - chỉ số của bảng để di chuyển đến.
rowIndex - chỉ số của hàng trong bảng.
columnIndex - chỉ số của cột trong bảng.
characterIndex - chỉ số của ký tự bên trong ô.

Điều hướng được thực hiện bên trong câu chuyện hiện tại của phần hiện tại. Đối với các tham số chỉ mục, khi chỉ mục lớn hơn hoặc bằng 0, nó chỉ định một chỉ mục ngay từ đầu với 0 là phần tử đầu tiên. Khi chỉ mục nhỏ hơn 0, nó chỉ định một chỉ mục từ cuối với -1 là phần tử cuối cùng.

Ngoài ra, lưu ý rằng characterIndex hiện chỉ có thể chỉ định 0 để di chuyển đến đầu ô hoặc -1 để di chuyển đến cuối ô. Ví dụ dưới đây cho thấy cách di chuyển vị trí con trỏ đến ô bảng được chỉ định. Bạn có thể tải xuống tệp mẫu của ví dụ này từ đây.

Di chuyển đến Dấu Trang

Dấu trang được sử dụng thường xuyên để đánh dấu các vị trí cụ thể trong tài liệu nơi các phần tử mới sẽ được chèn. Để di chuyển đến dấu trang, hãy sử dụng DocumentBuilder.MoveToBookmark. Phương pháp này có hai quá tải. Cái đơn giản nhất không chấp nhận gì ngoài tên của dấu trang nơi con trỏ sẽ được di chuyển. Ví dụ dưới đây cho thấy cách di chuyển vị trí con trỏ đến dấu trang. Bạn có thể tải xuống tệp mẫu của ví dụ này từ đây.

Quá tải này di chuyển con trỏ đến một vị trí ngay sau khi bắt đầu dấu trang với tên được chỉ định. Một quá tải khác DocumentBuilder.MoveToBookmark di chuyển con trỏ đến dấu trang với độ chính xác cao hơn. Nó chấp nhận hai tham số boolean bổ sung:

isStart xác định xem nên di chuyển con trỏ đến đầu hay đến cuối dấu trang.
isAfter xác định xem có nên di chuyển con trỏ đến sau vị trí bắt đầu hoặc kết thúc dấu trang hay di chuyển con trỏ đến trước vị trí bắt đầu hoặc kết thúc dấu trang.

Ví dụ dưới đây cho thấy cách di chuyển vị trí con trỏ đến ngay sau khi dấu trang kết thúc.

So sánh cho cả hai phương pháp không phân biệt chữ hoa chữ thường.

Chèn văn bản mới theo cách này không thay thế văn bản hiện có của dấu trang. Lưu ý rằng một số dấu trang trong tài liệu được gán cho các trường biểu mẫu. Di chuyển đến một dấu trang như vậy và chèn văn bản ở đó chèn văn bản vào mã trường biểu mẫu. Mặc dù điều này sẽ không làm mất hiệu lực trường biểu mẫu, văn bản được chèn sẽ không hiển thị vì nó trở thành một phần của mã trường.

Cách Chuyển Đổi Giữa Các Đơn Vị Đo Lường

Hầu hết các thuộc tính đối tượng được cung cấp trong Aspose.Words API đại diện cho một số phép đo (chiều rộng/chiều cao, lề và các khoảng cách khác nhau) chấp nhận các giá trị tính bằng điểm (1 inch bằng 72 điểm). Đôi khi điều này không thuận tiện nên có lớp ConvertUtil cung cấp các hàm trợ giúp để chuyển đổi giữa các đơn vị đo lường khác nhau. Nó cho phép chuyển đổi inch thành điểm, điểm sang inch, pixel thành điểm và điểm thành pixel. Khi pixel được chuyển đổi thành điểm và ngược lại, nó có thể được thực hiện ở độ phân giải 96 dpi (chấm trên inch) hoặc ở độ phân giải dpi được chỉ định. ConvertUtil