Fotnoter och slutnoter

Fotnoter och slutnoter

Aspose.Words FOSS för .NET representerar fotnoter och slutnoter med en enda Footnote nodklass som särskiljs av dess FootnoteType egenskap, tillsammans med separata nummereringsalternativ och separator-klasser i Aspose.Words.Notes-namnutrymmet.

Läsa fotnot- och slutnotinnehåll

Footnote är en sammansatt berättelsenod — som Body eller en tabellcell, den innehåller Paragraphs och Tables — som håller texten för en fotnot eller slutnot. Dess FootnoteType egenskap (ett FootnoteType enum-värde, Footnote eller Endnote) skiljer vilken typ det är. ReferenceMark returnerar det konfigurerade referensmarkeringstecknet, ActualReferenceMark returnerar den faktiskt renderade markeringen (med hänsyn till automatisk numrering), och IsAuto rapporterar om markeringen är autonummererad. ParentParagraph hittar stycket i huvuddokumentets kropp där fotnot- eller slutnotreferensen förekommer. GetText() extraherar fotnotens rena textinnehåll, vilket speglar metoden som finns på andra berättelsenivå-noder.

Konfigurering av numrering och position

Numrerings- och placeringsbeteende styrs separat för fotnoter och slutnoter via FootnoteOptions och EndnoteOptions, som båda implementerar det delade IFootnoteOptions-gränssnittet. FootnoteOptions.Position (ett FootnotePosition-värde — BottomOfPage eller BeneathText) och EndnoteOptions.Position (ett EndnotePosition-värde — EndOfSection eller EndOfDocument) styr var varje typ placeras. Båda exponerar NumberStyle, StartNumber och RestartRule (ett FootnoteNumberingRule-värde — Continuous, RestartSection, RestartPage eller Default) för att kontrollera nummereringssekvensen. FootnoteOptions exponerar dessutom Columns, för att layouta fotnoter längst ner på sidan i flera kolumner.

Fotnot- och slutnotseparatörer

FootnoteSeparator är en story-nod som innehåller det innehåll som Word placerar mellan huvuddokumentkroppen och dess fotnoter/slutnoter — den korta horisontella linjen som standard, men den kan innehålla vilket styckeinnehåll som helst. Dess SeparatorType-egenskap (ett FootnoteSeparatorType-värde) särskiljer de sex separatorroller som Word definierar: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice och motsvarande slutnoter. FootnoteSeparatorCollection ger typad åtkomst till alla separator-noder i ett dokument via GetByFootnoteSeparatorType(FootnoteSeparatorType).

Tips och bästa praxis

• Kontrollera Footnote.FootnoteType innan du antar att en Footnote-nod är en fotnot — samma klass representerar både fotnoter och slutnoter.
• Använd ActualReferenceMark istället för ReferenceMark när du behöver markeringen som den faktiskt renderas, eftersom automatiskt numrerade markeringar skiljer sig från det konfigurerade markeringstecknet.
• Konfigurera FootnoteOptions och EndnoteOptions innan du lägger till fot- eller slutnotinnehåll så att numreringsreglerna tillämpas konsekvent från den första noten.
• FootnoteSeparator-innehåll anpassas sällan — de flesta dokument förlitar sig på Words standardseparator — men det är fullt tillgängligt om ett dokument kräver ett anpassat fortsättningsmeddelande.

Vanliga problem

FAQ

Hur skiljer jag på en fotnot från en slutnot i kod?

Kontrollera FootnoteType-egenskapen på Footnote-objektet — den returnerar FootnoteType.Footnote eller FootnoteType.Endnote.

Kan fotnoter och slutnoter ha olika numreringsregler?

Ja — FootnoteOptions och EndnoteOptions konfigureras oberoende, var och en med sin egen Position, NumberStyle, StartNumber och RestartRule.

Vad används FootnoteSeparator till?

Den representerar det innehåll som Word infogar för att visuellt separera huvuddokumentets brödtext från dess fotnoter eller slutnoter, samt meddelandet som visas när en fotnot fortsätter på nästa sida.

Stöder Footnote tabeller i noten?

Ja — Footnote exponerar en Tables-egenskap tillsammans med Paragraphs, eftersom det är en sammansatt berättelsenod som huvuddokumentets brödtext.

API Reference Sammanfattning

Se även

• Aspose.Words for .NET — Enterprise Documentation