Przypisy i przypisy końcowe

Aspose.Words FOSS dla .NET reprezentuje przypisy i przypisy końcowe przy użyciu jednej klasy węzła Footnote, wyróżnionej przez jej właściwość FootnoteType, obok oddzielnych klas opcji numeracji i separatorów w przestrzeni nazw Aspose.Words.Notes.

Odczytywanie treści przypisu i przypisu końcowego

Footnote jest złożonym węzłem historii — podobnie jak Body lub komórka tabeli, zawiera Paragraphs i Tables — który przechowuje tekst jednego przypisu lub przypisu końcowego. Jego właściwość FootnoteType (wartość wyliczeniowa FootnoteType, Footnote lub Endnote) określa, jakiego rodzaju jest to element. ReferenceMark zwraca skonfigurowany znak znacznika odwołania, ActualReferenceMark zwraca znak faktycznie renderowany (uwzględniając automatyczną numerację), a IsAuto informuje, czy znacznik jest automatycznie numerowany. ParentParagraph lokalizuje akapit w głównym korpusie dokumentu, w którym występuje odwołanie do przypisu lub przypisu końcowego. GetText() wyodrębnia treść przypisu w postaci zwykłego tekstu, odzwierciedlając metodę dostępną dla innych węzłów poziomu historii.

Konfigurowanie numeracji i położenia

Zachowanie numeracji i rozmieszczenia jest kontrolowane osobno dla przypisów i przypisów końcowych za pomocą FootnoteOptions i EndnoteOptions, które obu implementują wspólny interfejs IFootnoteOptions. FootnoteOptions.Position (wartość FootnotePosition — BottomOfPage lub BeneathText) oraz EndnoteOptions.Position (wartość EndnotePosition — EndOfSection lub EndOfDocument) określają, gdzie każdy typ jest umieszczany. Oba udostępniają NumberStyle, StartNumber i RestartRule (wartość FootnoteNumberingRule — Continuous, RestartSection, RestartPage lub Default) w celu sterowania sekwencją numeracji. FootnoteOptions dodatkowo udostępnia Columns, służące do układania przypisów na dole strony w kilku kolumnach.

Separatory przypisów i przypisów końcowych

FootnoteSeparator jest węzłem historii przechowującym treść, którą Word wstawia pomiędzy główną treść dokumentu a jego przypisy/stopki — domyślnie krótka pozioma linia, ale może zawierać dowolną treść akapitu. Jego SeparatorType właściwość (wartość FootnoteSeparatorType) rozróżnia sześć ról separatorów definiowanych przez Word: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice oraz ich odpowiedniki w stopkach. FootnoteSeparatorCollection zapewnia typowany dostęp do wszystkich węzłów separatorów w dokumencie za pomocą GetByFootnoteSeparatorType(FootnoteSeparatorType).

Wskazówki i najlepsze praktyki

Sprawdź Footnote.FootnoteType przed założeniem, że węzeł Footnote jest przypisem — ta sama klasa reprezentuje zarówno przypisy, jak i stopki.
Użyj ActualReferenceMark zamiast ReferenceMark, gdy potrzebujesz znak, który zostanie rzeczywiście wyrenderowany, ponieważ automatycznie numerowane znaki różnią się od skonfigurowanego znaku.
Skonfiguruj FootnoteOptions i EndnoteOptions przed dodaniem treści przypisu/stopki, aby zasady numeracji były stosowane konsekwentnie od pierwszej notatki.
Treść FootnoteSeparator jest rzadko dostosowywana — większość dokumentów korzysta z domyślnego separatora Worda — ale jest w pełni dostępna, jeśli dokument wymaga niestandardowego komunikatu kontynuacji.

Typowe problemy

Problem	Przyczyna	Naprawa
Przypis i przypis końcowy pomieszane w logice przetwarzania	Oba używają tej samej klasy `Footnote`	Rozgałęź się na `Footnote.FootnoteType`
Tekst znacznika odniesienia nie pasuje do wyświetlanego wyniku	Użyto `ReferenceMark` zamiast `ActualReferenceMark`	Przeczytaj `ActualReferenceMark` w celu uzyskania znacznika po renderowaniu
Numeracja nieoczekiwanie zaczyna się od nowa na każdej stronie/sekcji	Ustawiono `RestartRule` na `RestartPage` lub `RestartSection`	Ustaw `RestartRule` na `Continuous` dla numeracji obejmującej cały dokument
Kolumny przypisów są ignorowane na dole strony	`FootnoteOptions.Columns` nie ustawiono	Ustaw `Columns` jawnie na `FootnoteOptions`

FAQ

Jak odróżnić przypis od przypisu końcowego w kodzie?

Sprawdź własność FootnoteType w obiekcie Footnote — zwraca FootnoteType.Footnote lub FootnoteType.Endnote.

Czy przypisy i przypisy końcowe mogą mieć różne zasady numeracji?

Tak — FootnoteOptions i EndnoteOptions są konfigurowane niezależnie, każdy ma własne Position, NumberStyle, StartNumber oraz RestartRule.

Do czego służy `FootnoteSeparator`?

Reprezentuje treść, którą Word wstawia, aby wizualnie oddzielić główną część dokumentu od jego przypisów lub przypisów końcowych, oraz komunikat wyświetlany, gdy przypis kontynuuje się na następnej stronie.

Czy `Footnote` obsługuje tabele wewnątrz notatki?

Tak — Footnote udostępnia własność Tables obok Paragraphs, ponieważ jest złożonym węzłem historii podobnym do głównej części dokumentu.

API Reference Podsumowanie

Klasa / Metoda	Opis
`Footnote`	Węzeł kontenera dla treści jednego przypisu dolnego lub końcowego
`FootnoteType`	Wyliczenie: `Footnote`, `Endnote`
`FootnoteOptions`	Ustawienia numeracji i położenia przypisów dolnych dla dokumentu/sekcji
`EndnoteOptions`	Ustawienia numeracji i położenia przypisów końcowych dla dokumentu/sekcji
`FootnotePosition` / `EndnotePosition`	Wyliczenia dla rozmieszczenia (`BottomOfPage`/`BeneathText`, `EndOfSection`/`EndOfDocument`)
`FootnoteNumberingRule`	Enum kontrolujący, kiedy numeracja jest restartowana
`FootnoteSeparator`	Węzeł historii dla treści separatora przypisu/stopki
`FootnoteSeparatorCollection`	Typowany dostęp do wszystkich węzłów `FootnoteSeparator`
`FootnoteSeparatorType`	Enum określający, którą z sześciu ról separatora reprezentuje węzeł

Zobacz także

Aspose.Words for .NET — Enterprise Documentation

Przypisy i przypisy końcowe