DocumentVisitor

DocumentVisitor class

فئة مجردة للتكرار خلال الشجرة الفرعية مع الجذر في العقدة المحددة.

public abstract class DocumentVisitor

طُرق

اسم وصف
virtual VisitAttachedFileEnd(AttachedFile) نهاية لزيارةAttachedFile العقدة .
virtual VisitAttachedFileStart(AttachedFile) ابدأ بزيارة موقعAttachedFile العقدة .
virtual VisitDocumentEnd(Document) نهاية لزيارةDocument العقدة .
virtual VisitDocumentStart(Document) ابدأ بزيارة موقعDocument العقدة .
virtual VisitImageEnd(Image) نهاية لزيارةImage العقدة .
virtual VisitImageStart(Image) ابدأ بزيارة موقعImage العقدة .
virtual VisitOutlineElementEnd(OutlineElement) نهاية لزيارةOutlineElement العقدة .
virtual VisitOutlineElementStart(OutlineElement) ابدأ بزيارة موقعOutlineElement العقدة .
virtual VisitOutlineEnd(Outline) نهاية لزيارةOutline العقدة .
virtual VisitOutlineGroupEnd(OutlineGroup) نهاية لزيارةOutlineGroup العقدة .
virtual VisitOutlineGroupStart(OutlineGroup) ابدأ بزيارة موقعOutlineGroup العقدة .
virtual VisitOutlineStart(Outline) ابدأ بزيارة موقعOutline العقدة .
virtual VisitPageEnd(Page) نهاية لزيارةPage العقدة .
virtual VisitPageStart(Page) ابدأ بزيارة موقعPage العقدة .
virtual VisitRichTextEnd(RichText) نهاية لزيارةRichText العقدة .
virtual VisitRichTextStart(RichText) ابدأ بزيارة موقعRichText العقدة .
virtual VisitTableCellEnd(TableCell) نهاية لزيارةTableCell العقدة .
virtual VisitTableCellStart(TableCell) ابدأ بزيارة موقعTableCell العقدة .
virtual VisitTableEnd(Table) نهاية لزيارةTable العقدة .
virtual VisitTableRowEnd(TableRow) نهاية لزيارةTableRow العقدة .
virtual VisitTableRowStart(TableRow) ابدأ بزيارة موقعTableRow العقدة .
virtual VisitTableStart(Table) ابدأ بزيارة موقعTable العقدة .
virtual VisitTitleEnd(Title) نهاية لزيارةTitle العقدة .
virtual VisitTitleStart(Title) ابدأ بزيارة موقعTitle العقدة .

أمثلة

يوضح كيفية الوصول إلى محتوى مستند باستخدام الزائر.

public static void Run()
{
    // المسار إلى دليل المستندات.
    string dataDir = RunExamples.GetDataDir_LoadingAndSaving();

    // افتح المستند الذي نريد تحويله.
    Document doc = new Document(dataDir + "Aspose.one");

    // إنشاء كائن يرث من فئة DocumentVisitor.
    MyOneNoteToTxtWriter myConverter = new MyOneNoteToTxtWriter();

    // هذا هو نمط الزائر المعروف. احصل على النموذج لقبول زائر.
    // سيقوم النموذج بالتكرار من خلال نفسه عن طريق استدعاء الطرق المقابلة
    // على كائن الزائر (وهذا ما يسمى بالزيارة).
    //
    // لاحظ أن كل عقدة في نموذج الكائن لها طريقة Accept لذا فإن زيارة
    يمكن تنفيذ // ليس فقط للمستند بأكمله ، ولكن لأي عقدة في المستند.
    doc.Accept(myConverter);

    // بمجرد اكتمال الزيارة ، يمكننا استرداد نتيجة العملية ،
    // التي في هذا المثال تراكمت في الزائر.
    Console.WriteLine(myConverter.GetText());
    Console.WriteLine(myConverter.NodeCount);            
}

/// <summary>
/// تنفيذ بسيط لحفظ مستند بتنسيق النص العادي. تم تنفيذه كزائر.
/// </summary>
public class MyOneNoteToTxtWriter : DocumentVisitor
{
    public MyOneNoteToTxtWriter()
    {
        nodecount = 0;
        mIsSkipText = false;
        mBuilder = new StringBuilder();
    }

    /// <summary>
    /// يحصل على النص العادي للمستند الذي قام الزائر بتجميعه.
    /// </summary>
    public string GetText()
    {
        return mBuilder.ToString();
    }

    /// <summary>
    /// يضيف نصًا إلى الإخراج الحالي. يكرم علامة الإخراج الممكنة / المعطلة.
    /// </summary>
    private void AppendText(string text)
    {
        if (!mIsSkipText)
        {
            mBuilder.AppendLine(text);
        }
    }

    /// <summary>
    /// يتم الاستدعاء عند مواجهة عقدة RichText في المستند.
    /// </summary>
    public override void VisitRichTextStart(RichText run)
    {
        ++nodecount;
        AppendText(run.Text);
    }

    /// <summary>
    /// يتم الاستدعاء عند مواجهة عقدة المستند في المستند.
    /// </summary>
    public override void VisitDocumentStart(Document document)
    {
        ++nodecount;
    }

    /// <summary>
    /// يتم الاستدعاء عند مواجهة عقدة الصفحة في المستند.
    /// </summary>
    public override void VisitPageStart(Page page)
    {
        ++nodecount;
        this.AppendText($"*** Page '{page.Title?.TitleText?.Text ?? "(no title)"}' ***");
    }

    /// <summary>
    /// يتم الاستدعاء عند انتهاء معالجة عقدة الصفحة.
    /// </summary>
    public override void VisitPageEnd(Page page)
    {
        this.AppendText(string.Empty);
    }

    /// <summary>
    /// يتم استدعاؤها عند مواجهة عقدة العنوان في المستند.
    /// </summary>
    public override void VisitTitleStart(Title title)
    {
        ++nodecount;
    }

    /// <summary>
    /// يتم استدعاؤها عند مواجهة عقدة صورة في المستند.
    /// </summary>
    public override void VisitImageStart(Image image)
    {
        ++nodecount;
    }

    /// <summary>
    /// يتم الاستدعاء عند مواجهة عقدة OutlineGroup في المستند.
    /// </summary>
    public override void VisitOutlineGroupStart(OutlineGroup outlineGroup)
    {
        ++nodecount;
    }

    /// <summary>
    /// يتم الاستدعاء عند مواجهة عقدة مخطط تفصيلي في المستند.
    /// </summary>
    public override void VisitOutlineStart(Outline outline)
    {
        ++nodecount;
    }

    /// <summary>
    /// يتم استدعاؤه عند مواجهة عقدة OutlineElement في المستند.
    /// </summary>
    public override void VisitOutlineElementStart(OutlineElement outlineElement)
    {
        ++nodecount;
    }

    /// <summary>
    /// الحصول على العدد الإجمالي للعقد بواسطة الزائر
    /// </summary>
    public Int32 NodeCount
    {
        get { return this.nodecount; }
    }

    private readonly StringBuilder mBuilder;
    private bool mIsSkipText;
    private Int32 nodecount;
}

أنظر أيضا