Notes de bas de page et notes de fin

Notes de bas de page et notes de fin

Aspose.Words FOSS pour .NET représente les notes de bas de page et les notes de fin avec une classe de nœud Footnote unique distinguée par sa propriété FootnoteType, ainsi que des classes séparées d’options de numérotation et de séparateur dans l’espace de noms Aspose.Words.Notes.

Lecture du contenu des notes de bas de page et des notes de fin

Footnote est un nœud d’histoire composite — comme Body ou une cellule de tableau, il contient Paragraphs et Tables — qui contient le texte d’une note de bas de page ou d’une note de fin. Sa propriété FootnoteType (une valeur d’énumération FootnoteType, Footnote ou Endnote) indique de quel type il s’agit. ReferenceMark renvoie le caractère de marque de référence configuré, ActualReferenceMark renvoie la marque réellement rendue (en tenant compte de la numérotation automatique), et IsAuto indique si la marque est auto-numérotée. ParentParagraph localise le paragraphe dans le corps principal du document où la référence de note de bas de page ou de note de fin apparaît. GetText() extrait le contenu en texte brut de la note, reflétant la méthode disponible sur les autres nœuds de niveau histoire.

Configuration de la numérotation et de la position

La numérotation et le comportement de placement sont contrôlés séparément pour les notes de bas de page et les notes de fin via FootnoteOptions et EndnoteOptions, tous deux implémentant l’interface partagée IFootnoteOptions. FootnoteOptions.Position (une valeur FootnotePosition — BottomOfPage ou BeneathText) et EndnoteOptions.Position (une valeur EndnotePosition — EndOfSection ou EndOfDocument) déterminent où chaque type est placé. Les deux exposent NumberStyle, StartNumber et RestartRule (une valeur FootnoteNumberingRule — Continuous, RestartSection, RestartPage ou Default) pour contrôler la séquence de numérotation. FootnoteOptions expose en outre Columns, pour disposer les notes de bas de page au bas de la page en plusieurs colonnes.

Séparateurs de notes de bas de page et de notes de fin

FootnoteSeparator est un nœud d’histoire contenant le contenu que Word insère entre le corps principal du document et ses notes de bas de page/notes de fin — la petite ligne horizontale par défaut, mais il peut contenir n’importe quel contenu de paragraphe. Sa propriété SeparatorType (une valeur FootnoteSeparatorType) distingue les six rôles de séparateur que Word définit : FootnoteSeparator, FootnoteContinuationSeparator, FootnoteContinuationNotice, et les équivalents de notes de fin. FootnoteSeparatorCollection fournit un accès typé à tous les nœuds de séparateur dans un document via GetByFootnoteSeparatorType(FootnoteSeparatorType).

Conseils et bonnes pratiques

• Vérifiez Footnote.FootnoteType avant de supposer qu’un nœud Footnote est une note de bas de page — la même classe représente à la fois les notes de bas de page et les notes de fin.
• Utilisez ActualReferenceMark plutôt que ReferenceMark lorsque vous avez besoin du signe tel qu’il sera réellement rendu, car les marques auto-numérotées diffèrent du caractère de marque configuré.
• Configurez FootnoteOptions et EndnoteOptions avant d’ajouter du contenu de note de bas de page/ note de fin afin que les règles de numérotation s’appliquent de manière cohérente dès la première note.
• Le contenu de FootnoteSeparator est rarement personnalisé — la plupart des documents utilisent le séparateur par défaut de Word — mais il est entièrement accessible si un document nécessite un avis de continuation personnalisé.

Problèmes courants

FAQ

Comment distinguer une note de bas de page d’une note de fin dans le code?

Vérifiez la propriété FootnoteType sur l’objet Footnote — elle renvoie FootnoteType.Footnote ou FootnoteType.Endnote.

Les notes de bas de page et les notes de fin peuvent-elles avoir des règles de numérotation différentes?

Oui — FootnoteOptions et EndnoteOptions sont configurés indépendamment, chacun avec ses propres Position, NumberStyle, StartNumber et RestartRule.

À quoi sert FootnoteSeparator?

Il représente le contenu que Word insère pour séparer visuellement le corps principal du document de ses notes de bas de page ou notes de fin, ainsi que l’avertissement affiché lorsqu’une note de bas de page se poursuit sur la page suivante.

Est-ce que Footnote prend en charge les tableaux à l’intérieur de la note?

Oui — Footnote expose une propriété Tables en plus de Paragraphs, puisqu’il s’agit d’un nœud d’histoire composite comme le corps principal du document.

API Reference Résumé

Voir aussi

• Aspose.Words for .NET — Enterprise Documentation