Lábjegyzetek és végjegyzetek

Aspose.Words FOSS for .NET a lábjegyzeteket és végjegyzeteket egyetlen Footnote csomópont osztállyal jeleníti meg, amelyet a FootnoteType tulajdonsága különböztet meg, valamint külön számozási opciókat és elválasztó osztályokat a Aspose.Words.Notes névtérben.

Lábjegyzet és végjegyzet tartalmának olvasása

Footnote egy összetett történetcsomópont — mint a Body vagy egy táblázatcellá, tartalmazza a Paragraphs és a Tables elemeket — amely egy lábjegyzet vagy végjegyzet szövegét tárolja. A FootnoteType tulajdonsága (egy FootnoteType felsorolt érték, Footnote vagy Endnote) megkülönbözteti, hogy melyik típusról van szó. ReferenceMark visszaadja a beállított hivatkozásjel karaktert, ActualReferenceMark visszaadja a ténylegesen megjelenített jelet (figyelembe véve az automatikus számozást), és IsAuto jelzi, hogy a jel automatikusan számozott-e. ParentParagraph megtalálja azt a bekezdést a fő dokumentumtörzsben, ahol a lábjegyzet vagy végjegyzet hivatkozás előfordul. GetText() kinyeri a lábjegyzet egyszerű szöveges tartalmát, tükrözve a többi történetszintű csomóponton elérhető módszert.

Számozás és pozíció beállítása

A számozási és elhelyezési viselkedést külön-külön a lábjegyzetek és végjegyzetek esetén a FootnoteOptions és EndnoteOptions segítségével szabályozzák, mindkettő a közös IFootnoteOptions interfészt valósítja meg. FootnoteOptions.Position (egy FootnotePosition érték — BottomOfPage vagy BeneathText) és EndnoteOptions.Position (egy EndnotePosition érték — EndOfSection vagy EndOfDocument) határozza meg, hogy az egyes típusok hol kerülnek elhelyezésre. Mindkettő a NumberStyle, StartNumber és RestartRule (egy FootnoteNumberingRule érték — Continuous, RestartSection, RestartPage vagy Default) tulajdonságokat teszi elérhetővé a számozási sorozat vezérléséhez. FootnoteOptions továbbá a Columns lehetőséget biztosítja, a lábjegyzetek többoszlopos elrendezéséhez az oldal alján.

Lábjegyzet és végjegyzet elválasztók

FootnoteSeparator egy történetcsomópont, amely a Word a fő dokumentumtörzs és a lábjegyzetek/végjegyzetek között megjelenő tartalmat tartalmazza — alapértelmezés szerint a rövid vízszintes vonalat, de bármilyen bekezdéstartalmat is tartalmazhat. A SeparatorType tulajdonsága (egy FootnoteSeparatorType érték) megkülönbözteti a Word által definiált hat elválasztó szerepet: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice, és a végjegyzet megfelelői. A FootnoteSeparatorCollection típusos hozzáférést biztosít a dokumentum összes elválasztó csomópontjához a GetByFootnoteSeparatorType(FootnoteSeparatorType) segítségével.

Tippek és bevált gyakorlatok

Ellenőrizze a Footnote.FootnoteType értéket, mielőtt azt feltételezné, hogy egy Footnote csomópont lábjegyzet — ugyanis ugyanaz az osztály képviseli a lábjegyzeteket és a végjegyzeteket.
Használja a ActualReferenceMark elemet a ReferenceMark helyett, ha a jelölésre van szükség, ahogyan az ténylegesen megjelenik, mivel az automatikusan számozott jelölések eltérnek a beállított jel karaktertől.
Állítsa be a FootnoteOptions és EndnoteOptions értékeket a lábjegyzet/végjegyzet tartalom hozzáadása előtt, hogy a számozási szabályok egységesen alkalmazásra kerüljenek az első jegyzetnél.
A FootnoteSeparator tartalma ritkán kerül testreszabásra — a legtöbb dokumentum a Word alapértelmezett elválasztójára támaszkodik — de teljesen elérhető, ha egy dokumentumnak egyedi folytatási értesítést kell tartalmaznia.

Gyakori problémák

Probléma	Ok	Megoldás
Lábjegyzet és végjegyzet összekeverve a feldolgozási logikában	Mindkettő ugyanazt a `Footnote` osztályt használja	Elágazás `Footnote.FootnoteType` alapján
A hivatkozási jel szövege nem egyezik a renderelt kimenettel	A `ReferenceMark` lett használva a `ActualReferenceMark` helyett	Olvassa el a `ActualReferenceMark` a renderelt jelhez
A számozás váratlanul újraindul oldalanként/szakaszonként	A `RestartRule` beállítva `RestartPage` vagy `RestartSection` értékre	Állítsa a `RestartRule` értékét `Continuous`-re a dokumentum egészére kiterjedő számozáshoz
A lábjegyzet oszlopok figyelmen kívül maradnak az oldal alján	`FootnoteOptions.Columns` nincs beállítva	Állítsa be a(z)`Columns`értékét kifejezetten a(z)`FootnoteOptions`esetén.

FAQ

Hogyan különböztethetem meg a lábjegyzetet a végjegyzetektől a kódban?

Ellenőrizze a FootnoteType tulajdonságot a Footnote objektumon — ez FootnoteType.Footnote vagy FootnoteType.Endnote értéket ad vissza.

Lehetnek a lábjegyzetek és a végjegyzetek különböző számozási szabályok?

Igen — a FootnoteOptions és a EndnoteOptions függetlenül van konfigurálva, mindegyik a saját Position, NumberStyle, StartNumber és RestartRule értékével.

Mire használják a `FootnoteSeparator`?

Ez a Word által beillesztett tartalmat jelöli, amely vizuálisan elválasztja a fő dokumentumtörzset a lábjegyzetektől vagy végjegyzetektől, valamint a feljegyzést, amely akkor jelenik meg, ha egy lábjegyzet a következő oldalra folytatódik.

Támogatja a `Footnote` a táblázatokat a jegyzetben?

Igen — a Footnote egy Tables tulajdonságot tesz elérhetővé a Paragraphs mellett, mivel ez egy összetett story node, akárcsak a fő dokumentumtörzs.

API Reference Összefoglaló

Osztály / Metódus	Leírás
`Footnote`	Tároló csomópont egy lábjegyzet vagy végjegyzet tartalmához
`FootnoteType`	Enum: `Footnote`, `Endnote`
`FootnoteOptions`	Lábjegyzet számozási és pozícióbeállítások egy dokumentumhoz vagy szakaszhoz
`EndnoteOptions`	Végjegyzet számozási és pozícióbeállítások egy dokumentumhoz vagy szakaszhoz
`FootnotePosition` / `EndnotePosition`	Enumok a elhelyezéshez (`BottomOfPage`/`BeneathText`, `EndOfSection`/`EndOfDocument`)
`FootnoteNumberingRule`	Enum, amely szabályozza, mikor indul újra a számozás
`FootnoteSeparator`	Story node a lábjegyzet/végjegyzet elválasztó tartalmához
`FootnoteSeparatorCollection`	Típusos hozzáférés az összes `FootnoteSeparator` csomóponthoz
`FootnoteSeparatorType`	Enum, amely azonosítja, hogy a hat szeparátor szerep közül melyik szerepet képviseli egy csomópont.

Lásd még:

Aspose.Words for .NET — Enterprise Documentation

Lábjegyzetek és végjegyzetek