Note a piè di pagina e note finali

Note a piè di pagina e note finali

Aspose.Words FOSS per .NET rappresenta note a piè di pagina e note finali con una singola classe nodo Footnote distinta dalla sua proprietà FootnoteType, insieme a classi separate di opzioni di numerazione e separatori nel namespace Aspose.Words.Notes.

Lettura del contenuto di note a piè di pagina e note finali

Footnote è un nodo composito della storia — come Body o una cella di tabella, contiene Paragraphs e Tables — che contiene il testo di una nota a piè di pagina o di una nota finale. La sua proprietà FootnoteType (un valore enum FootnoteType, Footnote o Endnote) distingue di che tipo si tratta. ReferenceMark restituisce il carattere di riferimento configurato, ActualReferenceMark restituisce il segno effettivamente renderizzato (tenendo conto della numerazione automatica), e IsAuto indica se il segno è numerato automaticamente. ParentParagraph individua il paragrafo nel corpo principale del documento dove compare il riferimento alla nota a piè di pagina o alla nota finale. GetText() estrae il contenuto in testo semplice della nota a piè di pagina, rispecchiando il metodo disponibile sugli altri nodi a livello di storia.

Configurazione della numerazione e della posizione

La numerazione e il comportamento di posizionamento sono controllati separatamente per note a piè di pagina e note finali tramite FootnoteOptions e EndnoteOptions, entrambi che implementano l’interfaccia condivisa IFootnoteOptions. FootnoteOptions.Position (un valore FootnotePosition — BottomOfPage o BeneathText) e EndnoteOptions.Position (un valore EndnotePosition — EndOfSection o EndOfDocument) controllano dove viene posizionato ciascun tipo. Entrambi espongono NumberStyle, StartNumber e RestartRule (un valore FootnoteNumberingRule — Continuous, RestartSection, RestartPage o Default) per gestire la sequenza di numerazione. FootnoteOptions espone inoltre Columns, per disporre le note a piè di pagina nella parte inferiore della pagina in più colonne.

Separatori di note a piè di pagina e note finali

FootnoteSeparator è un nodo della storia che contiene il contenuto che Word inserisce tra il corpo principale del documento e le sue note a piè di pagina/fine documento — la linea orizzontale corta per impostazione predefinita, ma può contenere qualsiasi contenuto di paragrafo. La sua proprietà SeparatorType (un valore FootnoteSeparatorType) distingue i sei ruoli di separatore che Word definisce: FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice, e le equivalenti per le note di fine documento. FootnoteSeparatorCollection fornisce un accesso tipizzato a tutti i nodi separatore in un documento tramite GetByFootnoteSeparatorType(FootnoteSeparatorType).

Suggerimenti e best practice

• Controlla Footnote.FootnoteType prima di presumere che un nodo Footnote sia una nota a piè di pagina — la stessa classe rappresenta sia le note a piè di pagina sia le note di fine documento.
• Usa ActualReferenceMark invece di ReferenceMark quando hai bisogno del segno così come verrà effettivamente visualizzato, poiché i segni autogenerati differiscono dal carattere di segno configurato.
• Configura FootnoteOptions e EndnoteOptions prima di aggiungere contenuto alle note a piè di pagina/fine documento in modo che le regole di numerazione si applichino in modo coerente fin dalla prima nota.
• Il contenuto di FootnoteSeparator è raramente personalizzato — la maggior parte dei documenti fa affidamento sul separatore predefinito di Word — ma è completamente accessibile se un documento richiede un avviso di continuazione personalizzato.

Problemi comuni

FAQ

Come distinguere una nota a piè di pagina da una nota finale nel codice?

Controlla la proprietà FootnoteType sull’oggetto Footnote — restituisce FootnoteType.Footnote o FootnoteType.Endnote.

Le note a piè di pagina e le note finali possono avere regole di numerazione diverse?

Sì — FootnoteOptions e EndnoteOptions sono configurati in modo indipendente, ciascuno con il proprio Position, NumberStyle, StartNumber e RestartRule.

A cosa serve FootnoteSeparator?

Rappresenta il contenuto che Word inserisce per separare visivamente il corpo principale del documento dalle sue note a piè di pagina o note finali, e l’avviso mostrato quando una nota a piè di pagina continua nella pagina successiva.

Il Footnote supporta tabelle all’interno della nota?

Sì — Footnote espone una proprietà Tables accanto a Paragraphs, poiché è un nodo di storia composito come il corpo principale del documento.

API Reference Riepilogo

Vedi anche

• Aspose.Words for .NET — Enterprise Documentation