Fußnoten und Endnoten

Fußnoten und Endnoten

Aspose.Words FOSS für .NET stellt Fußnoten und Endnoten mit einer einzigen Footnote Knotenklasse dar, die durch ihre FootnoteType Eigenschaft unterschieden wird, zusammen mit separaten Nummerierungsoptionen und Trennklassen im Aspose.Words.Notes Namensraum.

Lesen des Inhalts von Fußnoten und Endnoten

Footnote ist ein zusammengesetzter Story-Knoten — ähnlich Body oder einer Tabellenzelle, er enthält Paragraphs und Tables — der den Text einer Fußnote oder Endnote enthält. Seine FootnoteType Eigenschaft (ein FootnoteType Enum-Wert, Footnote oder Endnote) unterscheidet, um welche Art es sich handelt. ReferenceMark gibt das konfigurierte Referenzzeichen-Symbol zurück, ActualReferenceMark gibt das tatsächlich gerenderte Zeichen zurück (unter Berücksichtigung automatischer Nummerierung), und IsAuto meldet, ob das Zeichen automatisch nummeriert ist. ParentParagraph findet den Absatz im Hauptdokumentskörper, in dem die Fußnoten- oder Endnoten-Referenz vorkommt. GetText() extrahiert den Nur-Text-Inhalt der Fußnote und spiegelt die Methode wider, die bei anderen Story-Ebene-Knoten verfügbar ist.

Konfiguration von Nummerierung und Position

Nummerierungs- und Platzierungsverhalten werden für Fußnoten und Endnoten getrennt über FootnoteOptions und EndnoteOptions gesteuert, die beide das gemeinsame IFootnoteOptions Interface implementieren. FootnoteOptions.Position (ein FootnotePosition Wert — BottomOfPage oder BeneathText) und EndnoteOptions.Position (ein EndnotePosition Wert — EndOfSection oder EndOfDocument) bestimmen, wo jeder Typ platziert wird. Beide stellen NumberStyle, StartNumber und RestartRule (ein FootnoteNumberingRule Wert — Continuous, RestartSection, RestartPage oder Default) zur Kontrolle der Nummerierungssequenz bereit. FootnoteOptions stellt zusätzlich Columns bereit, um Fußnoten am Seitenende in mehreren Spalten anzuordnen.

Fußnoten- und Endnoten-Trennzeichen

FootnoteSeparator ist ein Story-Knoten, der den Inhalt hält, den Word zwischen dem Hauptdokumentkörper und seinen Fuß- bzw. Endnoten einfügt – standardmäßig die kurze horizontale Linie, aber er kann beliebigen Absatzinhalt enthalten. Seine SeparatorType-Eigenschaft (ein FootnoteSeparatorType-Wert) unterscheidet die sechs Trennzeichen-Rollen, die Word definiert: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice und die Endnoten-Entsprechungen. FootnoteSeparatorCollection stellt typisierten Zugriff auf alle Trennzeichen-Knoten in einem Dokument über GetByFootnoteSeparatorType(FootnoteSeparatorType) bereit.

Tipps und bewährte Vorgehensweisen

• Prüfen Sie Footnote.FootnoteType, bevor Sie annehmen, dass ein Footnote-Knoten eine Fußnote ist — dieselbe Klasse repräsentiert sowohl Fußnoten als auch Endnoten.
• Verwenden Sie ActualReferenceMark anstelle von ReferenceMark, wenn Sie das Zeichen benötigen, wie es tatsächlich gerendert wird, da automatisch nummerierte Zeichen vom konfigurierten Markierungszeichen abweichen.
• Konfigurieren Sie FootnoteOptions und EndnoteOptions, bevor Sie Fußnoten-/Endnoten-Inhalte hinzufügen, damit die Nummerierungsregeln ab der ersten Anmerkung konsistent angewendet werden.
• Der Inhalt von FootnoteSeparator wird selten angepasst — die meisten Dokumente verwenden den Standard-Trennzeichen von Word — aber er ist vollständig zugänglich, falls ein Dokument einen benutzerdefinierten Fortsetzungshinweis benötigt.

Häufige Probleme

FAQ

Wie erkenne ich in Code eine Fußnote von einer Endnote?

Überprüfen Sie die FootnoteType-Eigenschaft des Footnote-Objekts — sie gibt FootnoteType.Footnote oder FootnoteType.Endnote zurück.

Können Fußnoten und Endnoten unterschiedliche Nummerierungsregeln haben?

Ja — FootnoteOptions und EndnoteOptions werden unabhängig konfiguriert, jeweils mit eigenen Position, NumberStyle, StartNumber und RestartRule.

Wofür wird FootnoteSeparator verwendet?

Es stellt den Inhalt dar, den Word einfügt, um den Hauptdokumentkörper visuell von seinen Fußnoten oder Endnoten zu trennen, sowie den Hinweis, der angezeigt wird, wenn eine Fußnote auf die nächste Seite fortgesetzt wird.

Unterstützt Footnote Tabellen innerhalb der Notiz?

Ja — Footnote stellt eine Tables-Eigenschaft zusammen mit Paragraphs bereit, da es ein zusammengesetzter Story-Knoten wie der Hauptdokumentkörper ist.

API Reference Zusammenfassung

Siehe auch

• Aspose.Words for .NET — Enterprise Documentation