Chú thích và chú giải cuối

Chú thích dưới chân và chú thích cuối

Aspose.Words FOSS for .NET đại diện cho chú thích dưới chân và chú thích cuối bằng một lớp nút Footnote duy nhất được phân biệt bằng thuộc tính FootnoteType của nó, cùng với các lớp tùy chọn đánh số và phân cách riêng trong không gian tên Aspose.Words.Notes.

Đọc nội dung chú thích dưới chân và chú thích cuối

Footnote là một nút câu chuyện tổng hợp — giống như Body hoặc một ô bảng, nó chứa Paragraphs và Tables — dùng để giữ văn bản của một chú thích dưới chân hoặc chú thích cuối. Thuộc tính FootnoteType của nó (một giá trị enum FootnoteType, Footnote hoặc Endnote) phân biệt loại nào. ReferenceMark trả về ký tự dấu tham chiếu đã cấu hình, ActualReferenceMark trả về dấu thực tế được hiển thị (tính đến việc đánh số tự động), và IsAuto báo cáo liệu dấu có được đánh số tự động hay không. ParentParagraph xác định đoạn văn trong phần thân tài liệu chính nơi tham chiếu chú thích dưới chân hoặc cuối xuất hiện. GetText() trích xuất nội dung văn bản thuần của chú thích, phản chiếu phương pháp có sẵn trên các nút cấp câu chuyện khác.

Cấu hình đánh số và vị trí

Hành vi đánh số và vị trí được kiểm soát riêng cho chú thích dưới chân và chú thích cuối thông qua FootnoteOptions và EndnoteOptions, cả hai đều thực thi giao diện chung IFootnoteOptions. FootnoteOptions.Position (một giá trị FootnotePosition — BottomOfPage hoặc BeneathText) và EndnoteOptions.Position (một giá trị EndnotePosition — EndOfSection hoặc EndOfDocument) kiểm soát nơi mỗi loại được đặt. Cả hai đều cung cấp NumberStyle, StartNumber, và RestartRule (một giá trị FootnoteNumberingRule — Continuous, RestartSection, RestartPage, hoặc Default) để điều khiển chuỗi đánh số. FootnoteOptions còn cung cấp Columns, để bố trí các chú thích dưới chân ở cuối trang thành nhiều cột.

Dấu phân cách chú thích dưới chân và chú thích cuối

FootnoteSeparator là một nút câu chuyện chứa nội dung mà Word vẽ giữa phần thân tài liệu chính và các chú thích/chân chú — đường ngang ngắn theo mặc định, nhưng nó có thể chứa bất kỳ nội dung đoạn văn nào. Thuộc tính SeparatorType của nó (một giá trị FootnoteSeparatorType) phân biệt sáu vai trò bộ ngăn cách mà Word định nghĩa: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice, và các tương đương cho chú thích cuối. FootnoteSeparatorCollection cung cấp truy cập kiểu cho tất cả các nút ngăn cách trong tài liệu thông qua GetByFootnoteSeparatorType(FootnoteSeparatorType).

Mẹo và Thực hành Tốt nhất

Kiểm tra Footnote.FootnoteType trước khi cho rằng một nút Footnote là chú thích — cùng một lớp đại diện cho cả chú thích và chú thích cuối.
Sử dụng ActualReferenceMark thay vì ReferenceMark khi bạn cần dấu hiển thị thực tế, vì các dấu được đánh số tự động khác với ký tự dấu đã cấu hình.
Cấu hình FootnoteOptions và EndnoteOptions trước khi thêm nội dung chú thích/chân chú để các quy tắc đánh số áp dụng nhất quán từ ghi chú đầu tiên.
Nội dung FootnoteSeparator hiếm khi được tùy chỉnh — hầu hết tài liệu dựa vào bộ ngăn cách mặc định của Word — nhưng nó hoàn toàn có thể truy cập nếu tài liệu yêu cầu thông báo tiếp tục tùy chỉnh.

Vấn đề Thường gặp

Vấn đề	Nguyên nhân	Cách khắc phục
Chân trang và chú giải cuối bị nhầm lẫn trong logic xử lý	Cả hai đều sử dụng cùng lớp `Footnote`	Nhánh dựa trên `Footnote.FootnoteType`
Văn bản dấu tham chiếu không khớp với đầu ra đã hiển thị	Đã dùng `ReferenceMark` thay vì `ActualReferenceMark`	Đọc `ActualReferenceMark` để biết dấu đã được hiển thị
Việc đánh số khởi động lại một cách bất ngờ theo trang/mục	`RestartRule` được đặt thành `RestartPage` hoặc `RestartSection`	Đặt `RestartRule` thành `Continuous` để đánh số trên toàn bộ tài liệu
Các cột chú thích chân trang bị bỏ qua ở cuối trang	`FootnoteOptions.Columns` chưa được đặt	Đặt `Columns` một cách rõ ràng trên `FootnoteOptions`

FAQ

Làm sao tôi phân biệt chú thích dưới trang với chú thích cuối trong mã?

Kiểm tra thuộc tính FootnoteType trên đối tượng Footnote — nó trả về FootnoteType.Footnote hoặc FootnoteType.Endnote.

Chú thích dưới trang và chú thích cuối có thể có các quy tắc đánh số khác nhau không?

Có — FootnoteOptions và EndnoteOptions được cấu hình độc lập, mỗi cái có Position, NumberStyle, StartNumber, và RestartRule riêng của nó.

`FootnoteSeparator` được dùng để làm gì?

Nó đại diện cho nội dung mà Word chèn vào để trực quan tách phần thân tài liệu chính khỏi các chú thích dưới trang hoặc chú thích cuối, và thông báo được hiển thị khi một chú thích dưới trang tiếp tục sang trang tiếp theo.

Liệu `Footnote` có hỗ trợ bảng bên trong ghi chú không?

Có — Footnote cung cấp một thuộc tính Tables cùng với Paragraphs, vì nó là một nút câu chuyện tổng hợp giống như phần thân tài liệu chính.

API Reference Tóm tắt

Lớp / Phương thức	Mô tả
`Footnote`	Nút chứa cho nội dung của một chú thích chân trang hoặc chú thích cuối
`FootnoteType`	Enum: `Footnote`, `Endnote`
`FootnoteOptions`	Cài đặt đánh số và vị trí chú thích chân trang cho tài liệu/phần
`EndnoteOptions`	Cài đặt đánh số và vị trí chú thích cuối cho tài liệu/phần
`FootnotePosition` / `EndnotePosition`	Các enum cho vị trí (`BottomOfPage`/`BeneathText`, `EndOfSection`/`EndOfDocument`)
`FootnoteNumberingRule`	Enum điều khiển thời điểm khởi động lại việc đánh số
`FootnoteSeparator`	Nút story cho nội dung phân cách chú thích dưới trang/cuối tài liệu
`FootnoteSeparatorCollection`	Truy cập kiểu cho tất cả các nút `FootnoteSeparator`
`FootnoteSeparatorType`	Enum xác định một trong sáu vai trò phân tách mà một nút đại diện

Xem thêm

Aspose.Words for .NET — Enterprise Documentation