Footnote

Footnote class

Représente un conteneur pour le texte d’une note de bas de page ou d’une note de fin.

Pour en savoir plus, visitez leTravailler avec les notes de bas de page et de fin article de documentation.

public class Footnote : InlineStory

Constructeurs

NomLa description
Footnote(DocumentBaseFootnoteType)Initialise une instance duFootnote classe.

Propriétés

NomLa description
ActualReferenceMark { get; }Obtient le texte réel de la marque de référence affichée dans le document pour cette note de bas de page.
Count { get; }Obtient le nombre d’enfants immédiats de ce nœud.
CustomNodeId { get; set; }Spécifie l’identifiant de nœud personnalisé.
virtual Document { get; }Obtient le document auquel appartient ce nœud.
FirstChild { get; }Obtient le premier enfant du nœud.
FirstParagraph { get; }Obtient le premier paragraphe de l’histoire.
Font { get; }Donne accès à la mise en forme de la police du caractère d’ancrage de cet objet.
FootnoteType { get; }Renvoie une valeur qui spécifie s’il s’agit d’une note de bas de page ou d’une note de fin.
HasChildNodes { get; }Retoursvrai si ce nœud a des nœuds enfants.
IsAuto { get; set; }Contient une valeur qui spécifie s’il s’agit d’une note de bas de page numérotée automatiquement ou d’une note de bas de page avec une marque de référence personnalisée définie par l’utilisateur.
override IsComposite { get; }Retoursvrai car ce nœud peut avoir des nœuds enfants.
IsDeleteRevision { get; }Renvoie vrai si cet objet a été supprimé dans Microsoft Word alors que le suivi des modifications était activé.
IsInsertRevision { get; }Renvoie vrai si cet objet a été inséré dans Microsoft Word alors que le suivi des modifications était activé.
IsMoveFromRevision { get; }Retoursvrai si cet objet a été déplacé (supprimé) dans Microsoft Word alors que le suivi des modifications était activé.
IsMoveToRevision { get; }Retoursvrai si cet objet a été déplacé (inséré) dans Microsoft Word alors que le suivi des modifications était activé.
LastChild { get; }Obtient le dernier enfant du nœud.
LastParagraph { get; }Obtient le dernier paragraphe de l’histoire.
NextSibling { get; }Obtient le nœud suivant immédiatement ce nœud.
override NodeType { get; }RetoursFootnote .
Paragraphs { get; }Obtient une collection de paragraphes qui sont les enfants immédiats de l’histoire.
ParentNode { get; }Obtient le parent immédiat de ce nœud.
ParentParagraph { get; }Récupère le parentParagraph de ce nœud.
PreviousSibling { get; }Obtient le nœud précédant immédiatement ce nœud.
Range { get; }Renvoie unRangeobjet qui représente la partie d’un document contenue dans ce nœud.
ReferenceMark { get; set; }Obtient/définit la marque de référence personnalisée à utiliser pour cette note de bas de page. La valeur par défaut estchaîne vide (Empty ), ce qui signifie que des notes de bas de page numérotées automatiquement sont utilisées.
override StoryType { get; }RetoursFootnotes ouEndnotes .
Tables { get; }Obtient une collection de tables qui sont les enfants immédiats de l’histoire.

Méthodes

NomLa description
override Accept(DocumentVisitor)Accepte un visiteur.
override AcceptEnd(DocumentVisitor)Accepte un visiteur pour visiter la fin de la note de bas de page.
override AcceptStart(DocumentVisitor)Accepte un visiteur pour visiter le début de la note de bas de page.
AppendChild<T>(T)Ajoute le nœud spécifié à la fin de la liste des nœuds enfants pour ce nœud.
Clone(bool)Crée un doublon du nœud.
CreateNavigator()Crée un navigateur qui peut être utilisé pour parcourir et lire les nœuds.
EnsureMinimum()Si le dernier enfant n’est pas un paragraphe, crée et ajoute un paragraphe vide.
GetAncestor(NodeType)Obtient le premier ancêtre du spécifiéNodeType .
GetAncestor(Type)Obtient le premier ancêtre du type d’objet spécifié.
GetChild(NodeType, int, bool)Renvoie un Nième nœud enfant qui correspond au type spécifié.
GetChildNodes(NodeType, bool)Renvoie une collection active de nœuds enfants qui correspondent au type spécifié.
GetEnumerator()Fournit un support pour chaque itération de style sur les nœuds enfants de ce nœud.
override GetText()Obtient le texte de ce nœud et de tous ses enfants.
IndexOf(Node)Renvoie l’index du nœud enfant spécifié dans le tableau de nœuds enfants.
InsertAfter<T>(T, Node)Insère le nœud spécifié immédiatement après le nœud de référence spécifié.
InsertBefore<T>(T, Node)Insère le nœud spécifié immédiatement avant le nœud de référence spécifié.
NextPreOrder(Node)Obtient le nœud suivant selon l’algorithme de parcours de l’arbre de pré-ordre.
PrependChild<T>(T)Ajoute le nœud spécifié au début de la liste des nœuds enfants pour ce nœud.
PreviousPreOrder(Node)Obtient le nœud précédent selon l’algorithme de parcours de l’arbre de pré-ordre.
Remove()Se supprime du parent.
RemoveAllChildren()Supprime tous les nœuds enfants du nœud actuel.
RemoveChild<T>(T)Supprime le nœud enfant spécifié.
RemoveSmartTags()Supprime toutSmartTag nœuds descendants du nœud actuel.
SelectNodes(string)Sélectionne une liste de nœuds correspondant à l’expression XPath.
SelectSingleNode(string)Sélectionne le premierNode qui correspond à l’expression XPath.
ToString(SaveFormat)Exporte le contenu du nœud dans une chaîne au format spécifié.
ToString(SaveOptions)Exporte le contenu du nœud dans une chaîne en utilisant les options de sauvegarde spécifiées.

Remarques

LeFootnote La classe est utilisée pour représenter à la fois les notes de bas de page et les notes de fin dans un document Word.

Footnote est un nœud de niveau en ligne et ne peut être qu’un enfant deParagraph.

Footnote peut contenirParagraph etTable nœuds enfants.

Exemples

Montre comment insérer et personnaliser des notes de bas de page.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// Ajoutez du texte et référencez-le par une note de bas de page. Cette note placera une petite référence en exposant.
// marquez après le texte auquel il fait référence et créez une entrée sous le texte principal au bas de la page.
// Cette entrée contiendra la marque de référence de la note de bas de page et le texte de référence,
// que nous transmettrons à la méthode « InsertFootnote » du générateur de documents.
builder.Write("Main body text.");
Footnote footnote = builder.InsertFootnote(FootnoteType.Footnote, "Footnote text.");

// Si cette propriété est définie sur « true », alors la marque de référence de notre note de bas de page
// sera son index parmi toutes les notes de bas de page de la section.
// Ceci est la première note de bas de page, donc la marque de référence sera « 1 ».
Assert.True(footnote.IsAuto);

 // Nous pouvons déplacer le générateur de documents à l'intérieur de la note de bas de page pour modifier son texte de référence.
builder.MoveTo(footnote.FirstParagraph);
builder.Write(" More text added by a DocumentBuilder.");
builder.MoveToDocumentEnd();

Assert.AreEqual("\u0002 Footnote text. More text added by a DocumentBuilder.", footnote.GetText().Trim());

builder.Write(" More main body text.");
footnote = builder.InsertFootnote(FootnoteType.Footnote, "Footnote text.");

// Nous pouvons définir une marque de référence personnalisée que la note de bas de page utilisera à la place de son numéro d'index.
footnote.ReferenceMark = "RefMark";

Assert.False(footnote.IsAuto);

// Un signet avec l'indicateur « IsAuto » défini sur vrai affichera toujours son index réel
// même si les signets précédents affichent des marques de référence personnalisées, la marque de référence de ce signet sera un « 3 ».
builder.Write(" More main body text.");
footnote = builder.InsertFootnote(FootnoteType.Footnote, "Footnote text.");

Assert.True(footnote.IsAuto);

doc.Save(ArtifactsDir + "InlineStory.AddFootnote.docx");

Voir également