Class 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;
}

أنظر أيضا