SmartTag

SmartTag class

يحدد هذا العنصر وجود علامة ذكية حول بنية مضمنة واحدة أو أكثر (تشغيلات، صور، حقول، وما إلى ذلك) ضمن فقرة.

لمعرفة المزيد، قم بزيارةعلامات المستند المنظم أو التحكم في المحتوى مقالة توثيقية.

public class SmartTag : CompositeNode

المنشئون

اسم	وصف
SmartTag(DocumentBase)	يقوم بتهيئة مثيل جديد لـSmartTag الصف.

الخصائص

اسم	وصف
Count { get; }	يحصل على عدد الأبناء المباشرين لهذه العقدة.
CustomNodeId { get; set; }	يحدد معرف العقدة المخصص.
virtual Document { get; }	يحصل على المستند الذي تنتمي إليه هذه العقدة.
Element { get; set; }	يحدد اسم العلامة الذكية داخل المستند.
FirstChild { get; }	يحصل على أول طفل للعقدة.
HasChildNodes { get; }	إرجاعحقيقي إذا كانت هذه العقدة تحتوي على أي عقد فرعية.
override IsComposite { get; }	إرجاعحقيقي حيث يمكن لهذه العقدة أن تحتوي على عقد فرعية.
LastChild { get; }	يحصل على آخر طفل للعقدة.
NextSibling { get; }	يحصل على العقدة التي تلي هذه العقدة مباشرة.
override NodeType { get; }	إرجاعSmartTag .
ParentNode { get; }	يحصل على الوالد المباشر لهذه العقدة.
PreviousSibling { get; }	يحصل على العقدة التي تسبق هذه العقدة مباشرةً.
Properties { get; }	مجموعة من خصائص العلامة الذكية.
Range { get; }	يعيدRangeالكائن الذي يمثل الجزء من المستند الموجود في هذه العقدة.
Uri { get; set; }	يحدد اسم URI للعلامة الذكية.

طُرق

اسم	وصف
override Accept(DocumentVisitor)	يقبل زائرًا.
override AcceptEnd(DocumentVisitor)	يقبل الزائر لزيارة نهاية SmartTag.
override AcceptStart(DocumentVisitor)	يقبل زائرًا لزيارة بداية SmartTag.
AppendChild<T>(T)	يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة.
Clone(bool)	ينشئ نسخة مكررة من العقدة.
CreateNavigator()	ينشئ متصفحًا يمكن استخدامه للتنقل بين العقد وقراءتها.
GetAncestor(NodeType)	يحصل على السلف الأول للعنصر المحددNodeType .
GetAncestor(Type)	يحصل على السلف الأول لنوع الكائن المحدد.
GetChild(NodeType, int, bool)	يعيد عقدة فرعية رقم N تطابق النوع المحدد.
GetChildNodes(NodeType, bool)	يعيد مجموعة حية من العقد الفرعية التي تطابق النوع المحدد.
GetEnumerator()	يوفر الدعم لكل تكرار للأسلوب على العقد الفرعية لهذه العقدة.
override GetText()	يحصل على نص هذه العقدة وجميع أبنائها.
IndexOf(Node)	يعيد مؤشر العقدة الفرعية المحددة في مجموعة العقد الفرعية.
InsertAfter<T>(T, Node)	يقوم بإدراج العقدة المحددة فورًا بعد عقدة المرجع المحددة.
InsertBefore<T>(T, Node)	يقوم بإدراج العقدة المحددة مباشرة قبل عقدة المرجع المحددة.
NextPreOrder(Node)	يحصل على العقدة التالية وفقًا لخوارزمية عبور شجرة الترتيب المسبق.
PrependChild<T>(T)	يضيف العقدة المحددة إلى بداية قائمة العقد الفرعية لهذه العقدة.
PreviousPreOrder(Node)	يحصل على العقدة السابقة وفقًا لخوارزمية عبور شجرة الترتيب المسبق.
Remove()	يزيل نفسه من الأصل.
RemoveAllChildren()	يزيل جميع العقد الفرعية للعقدة الحالية.
RemoveChild<T>(T)	يزيل العقدة الفرعية المحددة.
RemoveSmartTags()	يزيل الكلSmartTag العقد المنحدرة من العقدة الحالية.
SelectNodes(string)	يحدد قائمة العقد المطابقة لتعبير XPath.
SelectSingleNode(string)	يحدد الأولNode الذي يتطابق مع تعبير XPath.
ToString(SaveFormat)	يصدر محتوى العقدة إلى سلسلة بالتنسيق المحدد.
ToString(SaveOptions)	يقوم بتصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة.

ملاحظات

العلامات الذكية هي نوع من ترميز XML مخصص. تتيح هذه العلامات تضمين دلالات مُحددة من قِبل العميل ضمن المستند، وذلك من خلال توفير مساحة اسم أساسية/name لتشغيل أو مجموعة تشغيلات ضمن المستند.

SmartTag يمكن أن يكون طفلاParagraph أو آخرSmartTag العقدة.

تتكون القائمة الكاملة للعقد الفرعية التي يمكن أن تظهر داخل علامة ذكية من BookmarkStart ،BookmarkEnd ، FieldStart ،FieldSeparator ،FieldEnd ،FormField ، Comment ،Footnote ، Run ،SpecialChar ، Shape ،GroupShape ، CommentRangeStart ، CommentRangeEnd ، SmartTag.

أمثلة

يوضح كيفية إنشاء العلامات الذكية.

public void Create()
{
    Document doc = new Document();

    // تظهر علامة ذكية في مستند باستخدام Microsoft Word تتعرف على جزء من نصه كنوع من البيانات،
    // مثل الاسم أو التاريخ أو العنوان، وتحويله إلى ارتباط تشعبي يعرض خطًا منقطًا باللون الأرجواني.
    SmartTag smartTag = new SmartTag(doc);

    // العلامات الذكية عبارة عن عقد مركبة تحتوي على النص المعترف به بالكامل.
    //أضف المحتويات إلى هذه العلامة الذكية يدويًا.
    smartTag.AppendChild(new Run(doc, "May 29, 2019"));

    // قد يتعرف Microsoft Word على المحتوى المذكور أعلاه باعتباره تاريخًا.
    // تستخدم العلامات الذكية خاصية "Element" لتعكس نوع البيانات التي تحتوي عليها.
    smartTag.Element = "date";

    // تقوم بعض أنواع العلامات الذكية بمعالجة محتوياتها بشكل أكبر في خصائص XML المخصصة.
    smartTag.Properties.Add(new CustomXmlProperty("Day", string.Empty, "29"));
    smartTag.Properties.Add(new CustomXmlProperty("Month", string.Empty, "5"));
    smartTag.Properties.Add(new CustomXmlProperty("Year", string.Empty, "2019"));

    // تعيين عنوان URI للعلامة الذكية إلى القيمة الافتراضية.
    smartTag.Uri = "urn:schemas-microsoft-com:office:smarttags";

    doc.FirstSection.Body.FirstParagraph.AppendChild(smartTag);
    doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, " is a date. "));

    // إنشاء علامة ذكية أخرى لمؤشر الأسهم.
    smartTag = new SmartTag(doc);
    smartTag.Element = "stockticker";
    smartTag.Uri = "urn:schemas-microsoft-com:office:smarttags";

    smartTag.AppendChild(new Run(doc, "MSFT"));

    doc.FirstSection.Body.FirstParagraph.AppendChild(smartTag);
    doc.FirstSection.Body.FirstParagraph.AppendChild(new Run(doc, " is a stock ticker."));

    // اطبع جميع العلامات الذكية في مستندنا باستخدام زائر المستند.
    doc.Accept(new SmartTagPrinter());

    // تدعم الإصدارات الأقدم من Microsoft Word العلامات الذكية.
    doc.Save(ArtifactsDir + "SmartTag.Create.doc");

    //استخدم طريقة "RemoveSmartTags" لإزالة كافة العلامات الذكية من المستند.
    Assert.AreEqual(2, doc.GetChildNodes(NodeType.SmartTag, true).Count);

    doc.RemoveSmartTags();

    Assert.AreEqual(0, doc.GetChildNodes(NodeType.SmartTag, true).Count);
}

/// <summary>
/// طباعة العلامات الذكية التي تمت زيارتها ومحتوياتها.
/// </summary>
private class SmartTagPrinter : DocumentVisitor
{
    /// <summary>
    /// يتم استدعاؤها عند مواجهة عقدة SmartTag في المستند.
    /// </summary>
    public override VisitorAction VisitSmartTagStart(SmartTag smartTag)
    {
        Console.WriteLine($"Smart tag type: {smartTag.Element}");
        return VisitorAction.Continue;
    }

    /// <summary>
    /// يتم استدعاؤها عند انتهاء زيارة عقدة SmartTag.
    /// </summary>
    public override VisitorAction VisitSmartTagEnd(SmartTag smartTag)
    {
        Console.WriteLine($"\tContents: \"{smartTag.ToString(SaveFormat.Text)}\"");

        if (smartTag.Properties.Count == 0)
        {
            Console.WriteLine("\tContains no properties");
        }
        else
        {
            Console.Write("\tProperties: ");
            string[] properties = new string[smartTag.Properties.Count];
            int index = 0;

            foreach (CustomXmlProperty cxp in smartTag.Properties)
                properties[index++] = $"\"{cxp.Name}\" = \"{cxp.Value}\"";

            Console.WriteLine(string.Join(", ", properties));
        }

        return VisitorAction.Continue;
    }
}

أنظر أيضا

• class CompositeNode
• مساحة الاسم Aspose.Words.Markup
• المجسم Aspose.Words