Accept
Contenu
[
Cacher
]Document.Accept method
Accepte un visiteur.
public override bool Accept(DocumentVisitor visitor)
Paramètre | Taper | La description |
---|---|---|
visitor | DocumentVisitor | Le visiteur qui visitera les nœuds. |
Return_Value
Vrai si tous les nœuds ont été visités ; faux siDocumentVisitor
arrêté l’opération avant de visiter tous les nœuds.
Remarques
Énumère ce nœud et tous ses enfants. Chaque nœud appelle une méthode correspondante surDocumentVisitor
.
Pour plus d’informations, consultez le modèle de conception Visiteur.
AppelsVisitDocumentStart
, puis appelleAccept
pour tous les nœuds enfants du document et des appelsVisitDocumentEnd
à la fin.
Exemples
Montre comment utiliser un visiteur de document pour imprimer la structure des nœuds d’un document.
public void DocStructureToText()
{
Document doc = new Document(MyDir + "DocumentVisitor-compatible features.docx");
DocStructurePrinter visitor = new DocStructurePrinter();
// Lorsque nous obtenons qu'un nœud composite accepte un visiteur de document, le visiteur visite le nœud accepteur,
// puis parcourt tous les enfants du nœud en profondeur.
// Le visiteur peut lire et modifier chaque nœud visité.
doc.Accept(visitor);
Console.WriteLine(visitor.GetText());
}
/// <summary>
/// Parcourt l'arborescence des nœuds enfants d'un nœud.
/// Crée une carte de cet arbre sous la forme d'une chaîne.
/// </summary>
public class DocStructurePrinter : DocumentVisitor
{
public DocStructurePrinter()
{
mAcceptingNodeChildTree = new StringBuilder();
}
public string GetText()
{
return mAcceptingNodeChildTree.ToString();
}
/// <summary>
/// Appelé lorsqu'un nœud Document est rencontré.
/// </summary>
public override VisitorAction VisitDocumentStart(Document doc)
{
int childNodeCount = doc.GetChildNodes(NodeType.Any, true).Count;
IndentAndAppendLine("[Document start] Child nodes: " + childNodeCount);
mDocTraversalDepth++;
// Autorise le visiteur à continuer à visiter d'autres nœuds.
return VisitorAction.Continue;
}
/// <summary>
/// Appelé après que tous les nœuds enfants d'un nœud Document ont été visités.
/// </summary>
public override VisitorAction VisitDocumentEnd(Document doc)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Document end]");
return VisitorAction.Continue;
}
/// <summary>
/// Appelé lorsqu'un nœud Section est rencontré dans le document.
/// </summary>
public override VisitorAction VisitSectionStart(Section section)
{
// Récupère l'index de notre section dans le document.
NodeCollection docSections = section.Document.GetChildNodes(NodeType.Section, false);
int sectionIndex = docSections.IndexOf(section);
IndentAndAppendLine("[Section start] Section index: " + sectionIndex);
mDocTraversalDepth++;
return VisitorAction.Continue;
}
/// <summary>
/// Appelé après que tous les nœuds enfants d'un nœud Section ont été visités.
/// </summary>
public override VisitorAction VisitSectionEnd(Section section)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Section end]");
return VisitorAction.Continue;
}
/// <summary>
/// Appelé lorsqu'un nœud Body est rencontré dans le document.
/// </summary>
public override VisitorAction VisitBodyStart(Body body)
{
int paragraphCount = body.Paragraphs.Count;
IndentAndAppendLine("[Body start] Paragraphs: " + paragraphCount);
mDocTraversalDepth++;
return VisitorAction.Continue;
}
/// <summary>
/// Appelé après que tous les nœuds enfants d'un nœud Body ont été visités.
/// </summary>
public override VisitorAction VisitBodyEnd(Body body)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Body end]");
return VisitorAction.Continue;
}
/// <summary>
/// Appelé lorsqu'un nœud Paragraphe est rencontré dans le document.
/// </summary>
public override VisitorAction VisitParagraphStart(Paragraph paragraph)
{
IndentAndAppendLine("[Paragraph start]");
mDocTraversalDepth++;
return VisitorAction.Continue;
}
/// <summary>
/// Appelé après que tous les nœuds enfants d'un nœud Paragraph ont été visités.
/// </summary>
public override VisitorAction VisitParagraphEnd(Paragraph paragraph)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Paragraph end]");
return VisitorAction.Continue;
}
/// <summary>
/// Appelé lorsqu'un nœud Run est rencontré dans le document.
/// </summary>
public override VisitorAction VisitRun(Run run)
{
IndentAndAppendLine("[Run] \"" + run.GetText() + "\"");
return VisitorAction.Continue;
}
/// <summary>
/// Appelé lorsqu'un nœud SubDocument est rencontré dans le document.
/// </summary>
public override VisitorAction VisitSubDocument(SubDocument subDocument)
{
IndentAndAppendLine("[SubDocument]");
return VisitorAction.Continue;
}
/// <summary>
/// Ajoutez une ligne au StringBuilder et indentez-la en fonction de la profondeur du visiteur dans l'arborescence du document.
/// </summary>
/// <param name="text"></param>
private void IndentAndAppendLine(string text)
{
for (int i = 0; i < mDocTraversalDepth; i++) mAcceptingNodeChildTree.Append("| ");
mAcceptingNodeChildTree.AppendLine(text);
}
private int mDocTraversalDepth;
private readonly StringBuilder mAcceptingNodeChildTree;
}
Voir également
- class DocumentVisitor
- class Document
- espace de noms Aspose.Words
- Assemblée Aspose.Words