Catatan Kaki dan Catatan Akhir

Aspose.Words FOSS untuk .NET merepresentasikan catatan kaki dan catatan akhir dengan satu kelas node Footnote yang dibedakan oleh properti FootnoteType-nya, bersama dengan kelas opsi penomoran terpisah dan kelas pemisah di namespace Aspose.Words.Notes.

Membaca Konten Catatan Kaki dan Catatan Akhir

Footnote adalah node cerita komposit — seperti Body atau sel tabel, ia berisi Paragraphs dan Tables — yang menyimpan teks satu catatan kaki atau catatan akhir. Properti FootnoteType-nya (nilai enum FootnoteType, Footnote atau Endnote) membedakan jenisnya. ReferenceMark mengembalikan karakter tanda referensi yang dikonfigurasi, ActualReferenceMark mengembalikan tanda yang sebenarnya dirender (memperhitungkan penomoran otomatis), dan IsAuto melaporkan apakah tanda tersebut diberi nomor otomatis. ParentParagraph menemukan paragraf dalam badan dokumen utama tempat referensi catatan kaki atau catatan akhir muncul. GetText() mengekstrak konten teks polos dari catatan kaki, meniru metode yang tersedia pada node tingkat cerita lainnya.

Mengonfigurasi Penomoran dan Posisi

Perilaku penomoran dan penempatan dikontrol secara terpisah untuk catatan kaki dan catatan akhir melalui FootnoteOptions dan EndnoteOptions, keduanya mengimplementasikan antarmuka bersama IFootnoteOptions. FootnoteOptions.Position (nilai FootnotePosition — BottomOfPage atau BeneathText) dan EndnoteOptions.Position (nilai EndnotePosition — EndOfSection atau EndOfDocument) mengontrol dimana masing-masing tipe ditempatkan. Kedua-nya mengekspos NumberStyle, StartNumber, dan RestartRule (nilai FootnoteNumberingRule — Continuous, RestartSection, RestartPage, atau Default) untuk mengontrol urutan penomoran. FootnoteOptions juga mengekspos Columns, untuk menata catatan kaki di bagian bawah halaman dalam beberapa kolom.

Pemisah Catatan Kaki dan Catatan Akhir

FootnoteSeparator adalah node cerita yang menyimpan konten yang Word sisipkan antara badan dokumen utama dan catatan kaki/akhir—garis horizontal pendek secara default, tetapi dapat berisi konten paragraf apa pun. Properti SeparatorTypenya (nilai FootnoteSeparatorType) membedakan enam peran pemisah yang didefinisikan Word: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice, dan setara catatan akhir. FootnoteSeparatorCollection menyediakan akses tipe ke semua node pemisah dalam dokumen melalui GetByFootnoteSeparatorType(FootnoteSeparatorType).

Tips dan Praktik Terbaik

Periksa Footnote.FootnoteType sebelum menganggap node Footnote adalah catatan kaki — kelas yang sama mewakili baik catatan kaki maupun catatan akhir.
Gunakan ActualReferenceMark alih-alih ReferenceMark ketika Anda memerlukan tanda sebagaimana sebenarnya ditampilkan, karena tanda bernomor otomatis berbeda dari karakter tanda yang dikonfigurasi.
Konfigurasikan FootnoteOptions dan EndnoteOptions sebelum menambahkan konten catatan kaki/akhir sehingga aturan penomoran diterapkan secara konsisten sejak catatan pertama.
Konten FootnoteSeparator jarang disesuaikan — kebanyakan dokumen mengandalkan pemisah default Word — namun sepenuhnya dapat diakses jika sebuah dokumen memerlukan pemberitahuan lanjutan khusus.

Masalah Umum

Masalah	Penyebab	Perbaikan
Catatan kaki dan catatan akhir bingung dalam logika pemrosesan	Keduanya menggunakan kelas `Footnote` yang sama	Cabang pada `Footnote.FootnoteType`
Teks penanda referensi tidak cocok dengan output yang dihasilkan	Menggunakan `ReferenceMark` alih-alih `ActualReferenceMark`	Baca `ActualReferenceMark` untuk tanda yang sudah dirender
Penomoran dimulai ulang secara tak terduga per halaman/bagian	`RestartRule` diatur ke `RestartPage` atau `RestartSection`	Atur `RestartRule` ke `Continuous` untuk penomoran di seluruh dokumen
Kolom catatan kaki diabaikan di bagian bawah halaman	`FootnoteOptions.Columns` tidak diatur	Atur `Columns` secara eksplisit pada `FootnoteOptions`

FAQ

Bagaimana saya membedakan catatan kaki dengan catatan akhir dalam kode?

Periksa properti FootnoteType pada objek Footnote — properti ini mengembalikan FootnoteType.Footnote atau FootnoteType.Endnote.

Apakah catatan kaki dan catatan akhir dapat memiliki aturan penomoran yang berbeda?

Ya — FootnoteOptions dan EndnoteOptions dikonfigurasi secara independen, masing-masing dengan Position, NumberStyle, StartNumber, dan RestartRule miliknya.

Untuk apa `FootnoteSeparator` digunakan?

Ini mewakili konten yang disisipkan Word untuk memisahkan secara visual badan dokumen utama dari catatan kaki atau catatan akhirnya, serta pemberitahuan yang ditampilkan ketika sebuah catatan kaki berlanjut ke halaman berikutnya.

Apakah `Footnote` mendukung tabel di dalam catatan?

Ya — Footnote mengekspos properti Tables bersama Paragraphs, karena ia merupakan node cerita komposit seperti badan dokumen utama.

API Reference Ringkasan

Kelas / Metode	Deskripsi
`Footnote`	Node kontainer untuk konten satu catatan kaki atau catatan akhir
`FootnoteType`	Enum: `Footnote`, `Endnote`
`FootnoteOptions`	Pengaturan penomoran dan posisi catatan kaki untuk dokumen/bagian
`EndnoteOptions`	Pengaturan penomoran dan posisi catatan akhir untuk dokumen/bagian
`FootnotePosition` / `EndnotePosition`	Enum untuk penempatan (`BottomOfPage`/`BeneathText`, `EndOfSection`/`EndOfDocument`)
`FootnoteNumberingRule`	Enum yang mengontrol kapan penomoran dimulai kembali
`FootnoteSeparator`	Node cerita untuk konten pemisah catatan kaki/akhir
`FootnoteSeparatorCollection`	Akses bertipe ke semua node `FootnoteSeparator`
`FootnoteSeparatorType`	Enum yang mengidentifikasi peran pemisah mana dari enam peran yang diwakili oleh sebuah node

Lihat Juga

Aspose.Words for .NET — Enterprise Documentation

Catatan Kaki dan Catatan Akhir