VisitSectionStart
محتويات
[
يخفي
]DocumentVisitor.VisitSectionStart method
يتم استدعاؤه عند بدء تعداد القسم.
public virtual VisitorAction VisitSectionStart(Section section)
معامل | يكتب | وصف |
---|---|---|
section | Section | الكائن الذي تتم زيارته. |
قيمة الإرجاع
أVisitorAction
القيمة التي تحدد كيفية متابعة التعداد.
أمثلة
يوضح كيفية استخدام زائر المستند لطباعة بنية عقدة المستند.
public void DocStructureToText()
{
Document doc = new Document(MyDir + "DocumentVisitor-compatible features.docx");
DocStructurePrinter visitor = new DocStructurePrinter();
// عندما نحصل على عقدة مركبة لقبول زائر المستند، يقوم الزائر بزيارة العقدة المقبولة،
// ثم يجتاز جميع أبناء العقدة بطريقة العمق الأول.
// يمكن للزائر قراءة وتعديل كل عقدة تمت زيارتها.
doc.Accept(visitor);
Console.WriteLine(visitor.GetText());
}
/// <summary>
/// يجتاز شجرة العقدة من العقد الفرعية.
/// ينشئ خريطة لهذه الشجرة على شكل سلسلة.
/// </summary>
public class DocStructurePrinter : DocumentVisitor
{
public DocStructurePrinter()
{
mAcceptingNodeChildTree = new StringBuilder();
}
public string GetText()
{
return mAcceptingNodeChildTree.ToString();
}
/// <summary>
/// يتم الاتصال به عند مواجهة عقدة مستند.
/// </summary>
public override VisitorAction VisitDocumentStart(Document doc)
{
int childNodeCount = doc.GetChildNodes(NodeType.Any, true).Count;
IndentAndAppendLine("[Document start] Child nodes: " + childNodeCount);
mDocTraversalDepth++;
// السماح للزائر بمواصلة زيارة العقد الأخرى.
return VisitorAction.Continue;
}
/// <summary>
/// يتم الاتصال به بعد زيارة جميع العقد التابعة لعقدة المستند.
/// </summary>
public override VisitorAction VisitDocumentEnd(Document doc)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Document end]");
return VisitorAction.Continue;
}
/// <summary>
/// يتم الاتصال به عند مواجهة عقدة القسم في المستند.
/// </summary>
public override VisitorAction VisitSectionStart(Section section)
{
// احصل على فهرس قسمنا داخل المستند.
NodeCollection docSections = section.Document.GetChildNodes(NodeType.Section, false);
int sectionIndex = docSections.IndexOf(section);
IndentAndAppendLine("[Section start] Section index: " + sectionIndex);
mDocTraversalDepth++;
return VisitorAction.Continue;
}
/// <summary>
/// يتم الاتصال به بعد زيارة جميع العقد التابعة لعقدة القسم.
/// </summary>
public override VisitorAction VisitSectionEnd(Section section)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Section end]");
return VisitorAction.Continue;
}
/// <summary>
/// يتم الاتصال به عند مواجهة عقدة النص في المستند.
/// </summary>
public override VisitorAction VisitBodyStart(Body body)
{
int paragraphCount = body.Paragraphs.Count;
IndentAndAppendLine("[Body start] Paragraphs: " + paragraphCount);
mDocTraversalDepth++;
return VisitorAction.Continue;
}
/// <summary>
/// يتم الاتصال به بعد زيارة جميع العقد التابعة للعقدة الأساسية.
/// </summary>
public override VisitorAction VisitBodyEnd(Body body)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Body end]");
return VisitorAction.Continue;
}
/// <summary>
/// يتم استدعاؤه عند مواجهة عقدة فقرة في المستند.
/// </summary>
public override VisitorAction VisitParagraphStart(Paragraph paragraph)
{
IndentAndAppendLine("[Paragraph start]");
mDocTraversalDepth++;
return VisitorAction.Continue;
}
/// <summary>
/// يتم الاتصال به بعد زيارة جميع العقد التابعة لعقدة الفقرة.
/// </summary>
public override VisitorAction VisitParagraphEnd(Paragraph paragraph)
{
mDocTraversalDepth--;
IndentAndAppendLine("[Paragraph end]");
return VisitorAction.Continue;
}
/// <summary>
/// يتم الاتصال به عند مواجهة عقدة التشغيل في المستند.
/// </summary>
public override VisitorAction VisitRun(Run run)
{
IndentAndAppendLine("[Run] \"" + run.GetText() + "\"");
return VisitorAction.Continue;
}
/// <summary>
/// يتم الاتصال به عند مواجهة عقدة مستند فرعي في المستند.
/// </summary>
public override VisitorAction VisitSubDocument(SubDocument subDocument)
{
IndentAndAppendLine("[SubDocument]");
return VisitorAction.Continue;
}
/// <summary>
/// ألحق سطرًا بـ StringBuilder وقم بوضع مسافة بادئة له اعتمادًا على مدى عمق الزائر في شجرة المستندات.
/// </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;
}
أنظر أيضا
- enum VisitorAction
- class Section
- class DocumentVisitor
- مساحة الاسم Aspose.Words
- المجسم Aspose.Words