Poznámky pod čarou a koncové poznámky
Poznámky pod čarou a koncové poznámky
Aspose.Words FOSS for .NET představuje poznámky pod čarou a koncové poznámky pomocí jediného uzlu třídy Footnote, odlišeného jeho vlastností FootnoteType, spolu se samostatnými možnostmi číslování a třídami oddělovačů v jmenném prostoru Aspose.Words.Notes.
Čtení obsahu poznámky pod čarou a koncové poznámky
Footnote je složený uzel příběhu — podobně jako Body nebo buňka tabulky, obsahuje Paragraphs a Tables — který obsahuje text jedné poznámky pod čarou nebo koncové poznámky. Jeho vlastnost FootnoteType (hodnota výčtu FootnoteType, Footnote nebo Endnote) rozlišuje, o jaký typ se jedná. ReferenceMark vrací nastavený znak referenční značky, ActualReferenceMark vrací značku, která je skutečně vykreslena (s ohledem na automatické číslování), a IsAuto uvádí, zda je značka automaticky číslována. ParentParagraph lokalizuje odstavec v hlavním těle dokumentu, kde se vyskytuje odkaz na poznámku pod čarou nebo koncovou poznámku. GetText() extrahuje čistý textový obsah poznámky pod čarou, což odpovídá metodě dostupné u ostatních uzlů na úrovni příběhu.
Nastavení číslování a umístění
Chování číslování a umístění je řízeno samostatně pro poznámky pod čarou a koncové poznámky prostřednictvím FootnoteOptions a EndnoteOptions, které oba implementují sdílené rozhraní IFootnoteOptions. FootnoteOptions.Position (hodnota FootnotePosition — BottomOfPage nebo BeneathText) a EndnoteOptions.Position (hodnota EndnotePosition — EndOfSection nebo EndOfDocument) určují, kde je každý typ umístěn. Oba zpřístupňují NumberStyle, StartNumber a RestartRule (hodnota FootnoteNumberingRule — Continuous, RestartSection, RestartPage nebo Default) pro kontrolu sekvence číslování. FootnoteOptions navíc zpřístupňuje Columns pro rozvržení poznámek pod čarou ve spodní části stránky ve více sloupcích.
Oddělovače poznámek pod čarou a koncových poznámek
FootnoteSeparator je uzel příběhu, který obsahuje obsah, který Word vkládá mezi hlavní tělo dokumentu a jeho poznámky pod čarou/koncové poznámky — ve výchozím nastavení krátká vodorovná čára, ale může obsahovat libovolný odstavec. Jeho SeparatorType vlastnost (hodnota FootnoteSeparatorType) rozlišuje šest rolí oddělovačů, které Word definuje: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice a ekvivalentní koncové poznámky. FootnoteSeparatorCollection poskytuje typovaný přístup ke všem uzlům oddělovačů v dokumentu přes GetByFootnoteSeparatorType(FootnoteSeparatorType).
Tipy a osvědčené postupy
- Zkontrolujte
Footnote.FootnoteType, než předpokládáte, že uzelFootnoteje poznámka pod čarou — stejná třída představuje jak poznámky pod čarou, tak koncové poznámky. - Použijte
ActualReferenceMarkmístoReferenceMark, pokud potřebujete značku tak, jak bude skutečně vykreslena, protože automaticky číslované značky se liší od nastaveného znaku značky. - Nastavte
FootnoteOptionsaEndnoteOptionspřed přidáním obsahu poznámky pod čarou/koncové poznámky, aby se pravidla číslování aplikovala konzistentně od první poznámky. - Obsah
FootnoteSeparatorse jen zřídka přizpůsobuje — většina dokumentů spoléhá na výchozí oddělovač Wordu — ale je plně přístupný, pokud dokument vyžaduje vlastní upozornění na pokračování.
Časté problémy
| Problém | Příčina | Oprava |
|---|---|---|
| Poznámka pod čarou a závěrečná poznámka jsou zaměněny v logice zpracování | Obě používají stejnou třídu Footnote | Rozvětvení na Footnote.FootnoteType |
| Text referenční značky neodpovídá vykreslenému výstupu | Použito ReferenceMark místo ActualReferenceMark | Přečtěte ActualReferenceMark pro značku jako vykreslenou |
| Číslování se neočekávaně restartuje na každé stránce/sekci | RestartRule nastaveno na RestartPage nebo RestartSection | Nastavte RestartRule na Continuous pro číslování v celém dokumentu |
| Sloupce poznámek pod čarou jsou ignorovány na konci stránky | FootnoteOptions.Columns není nastaveno | Nastavte Columns explicitně na FootnoteOptions |
FAQ
Jak v kódu odliším poznámku pod čarou od koncové poznámky?
Zkontrolujte vlastnost FootnoteType na objektu Footnote — vrací FootnoteType.Footnote nebo FootnoteType.Endnote.
Mohou mít poznámky pod čarou a koncové poznámky různá pravidla číslování?
Ano — FootnoteOptions a EndnoteOptions jsou nastaveny nezávisle, každá má své vlastní Position, NumberStyle, StartNumber a RestartRule.
Na co se FootnoteSeparator používá?
Představuje obsah, který Word vloží k vizuálnímu oddělení hlavního těla dokumentu od jeho poznámek pod čarou nebo koncových poznámek, a upozornění zobrazené, když poznámka pod čarou pokračuje na další stránku.
Podporuje Footnote tabulky uvnitř poznámky?
Ano — Footnote vystavuje vlastnost Tables vedle Paragraphs, protože je to složený uzel příběhu jako hlavní tělo dokumentu.
API Reference Shrnutí
| Třída / Metoda | Popis: |
|---|---|
Footnote | Kontejnerový uzel pro obsah jedné poznámky pod čarou nebo koncové poznámky |
FootnoteType | Enum: Footnote, Endnote |
FootnoteOptions | Nastavení číslování a pozice poznámek pod čarou pro dokument/sekci |
EndnoteOptions | Nastavení číslování a pozice koncových poznámek pro dokument/sekci |
FootnotePosition / EndnotePosition | Enums pro umístění (BottomOfPage/BeneathText, EndOfSection/EndOfDocument) |
FootnoteNumberingRule | Enum řídící, kdy se číslování restartuje |
FootnoteSeparator | Uzel příběhu pro obsah oddělovače poznámky pod čarou/koncové poznámky |
FootnoteSeparatorCollection | Typizovaný přístup ke všem uzlům FootnoteSeparator |
FootnoteSeparatorType | Enum identifikující, kterou z šesti rolí oddělovače uzel představuje |