GlossaryDocument

GlossaryDocument class

يمثل العنصر الجذر لمستند المصطلحات داخل مستند Word. مستند المصطلحات هو مخزن للنص التلقائي وإدخالات التصحيح التلقائي وكتل البناء.

لمعرفة المزيد، قم بزيارةنموذج كائن المستند (DOM) في Aspose.Words مقالة توثيقية.

public class GlossaryDocument : DocumentBase

المنشئون

اسم	وصف
GlossaryDocument()	Default_Constructor

الخصائص

اسم	وصف
BackgroundShape { get; set; }	يحصل على شكل خلفية المستند أو يضبطه. يمكن استخدامه`باطل` .
BuildingBlocks { get; }	يعيد مجموعة مكتوبة تمثل جميع كتل البناء في مستند المصطلحات.
Count { get; }	يحصل على عدد الأبناء المباشرين لهذه العقدة.
CustomNodeId { get; set; }	يحدد معرف العقدة المخصص.
override Document { get; }	يحصل على هذه المثيل.
FirstBuildingBlock { get; }	يحصل على كتلة البناء الأولى في مستند المصطلحات.
FirstChild { get; }	يحصل على أول طفل للعقدة.
FontInfos { get; }	يوفر الوصول إلى خصائص الخطوط المستخدمة في هذه الوثيقة.
FootnoteSeparators { get; }	يوفر الوصول إلى فواصل الحواشي السفلية/النهائية المحددة في المستند.
HasChildNodes { get; }	إرجاع`حقيقي` إذا كانت هذه العقدة تحتوي على أي عقد فرعية.
override IsComposite { get; }	إرجاع`حقيقي` حيث يمكن لهذه العقدة أن تحتوي على عقد فرعية.
LastBuildingBlock { get; }	يحصل على آخر كتلة بناء في مستند المصطلحات.
LastChild { get; }	يحصل على آخر طفل للعقدة.
Lists { get; }	يوفر الوصول إلى تنسيق القائمة المستخدم في المستند.
NextSibling { get; }	يحصل على العقدة التي تلي هذه العقدة مباشرة.
NodeChangingCallback { get; set; }	يتم استدعاؤها عند إدراج عقدة أو إزالتها في المستند.
override NodeType { get; }	يعيدGlossaryDocument القيمة.
PageColor { get; set; }	يُحدِّد لون صفحة المستند أو يُحدِّده. هذه الخاصية هي نسخة أبسط من`BackgroundShape` .
ParentNode { get; }	يحصل على الوالد المباشر لهذه العقدة.
PreviousSibling { get; }	يحصل على العقدة التي تسبق هذه العقدة مباشرةً.
Range { get; }	يعيد`Range`الكائن الذي يمثل الجزء من المستند الموجود في هذه العقدة.
ResourceLoadingCallback { get; set; }	يسمح بالتحكم في كيفية تحميل الموارد الخارجية.
Styles { get; }	يعيد مجموعة من الأنماط المحددة في المستند.
WarningCallback { get; set; }	يتم استدعاؤها أثناء إجراءات معالجة المستندات المختلفة عند اكتشاف مشكلة قد تؤدي إلى فقدان دقة البيانات أو التنسيق.

طُرق

اسم	وصف
override Accept(DocumentVisitor)	يقبل زائرًا.
override AcceptEnd(DocumentVisitor)	يقبل الزائر لزيارة نهاية مستند المصطلحات.
override AcceptStart(DocumentVisitor)	يقبل الزائر لزيارة بداية مستند المصطلحات.
AppendChild<T>(T)	يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة.
Clone(bool)	ينشئ نسخة مكررة من العقدة.
CreateNavigator()	ينشئ متصفحًا يمكن استخدامه للتنقل بين العقد وقراءتها.
GetAncestor(NodeType)	يحصل على السلف الأول للعنصر المحدد`NodeType` .
GetAncestor(Type)	يحصل على السلف الأول لنوع الكائن المحدد.
GetBuildingBlock(BuildingBlockGallery, string, string)	يبحث عن كتلة بناء باستخدام المعرض والفئة والاسم المحددين.
GetChild(NodeType, int, bool)	يعيد عقدة فرعية رقم N تطابق النوع المحدد.
GetChildNodes(NodeType, bool)	يعيد مجموعة حية من العقد الفرعية التي تطابق النوع المحدد.
GetEnumerator()	يوفر الدعم لكل تكرار للأسلوب على العقد الفرعية لهذه العقدة.
override GetText()	يحصل على نص هذه العقدة وجميع أبنائها.
ImportNode(Node, bool)	استيراد عقدة من مستند آخر إلى المستند الحالي.
ImportNode(Node, bool, ImportFormatMode)	استيراد عقدة من مستند آخر إلى المستند الحالي مع خيار التحكم في التنسيق.
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)	يقوم بتصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة.

ملاحظات

يمكن أن تحتوي بعض المستندات، عادةً القوالب، على نص تلقائي وإدخالات التصحيح التلقائي و/أو كتل البناء (المعروفة أيضًا باسممدخلات وثيقة المصطلحات ،أجزاء الوثيقة أوكتل البناء).

للوصول إلى كتل البناء، تحتاج إلى تحميل مستند فيDocument كائن . ستكون كتل البناء متاحة عبرGlossaryDocument ملكية.

GlossaryDocument يمكن أن تحتوي على أي عدد منBuildingBlockالكائنات. لكلBuildingBlock يمثل جزء واحد من الوثيقة.

يتوافق معمسرد المصطلحات وأجزاء المستنداتالعناصر في OOXML.

أمثلة

يوضح طرق الوصول إلى كتل البناء في مستند المصطلحات.

public void GlossaryDocument()
{
    Document doc = new Document();
    GlossaryDocument glossaryDoc = new GlossaryDocument();

    BuildingBlock child1 = new BuildingBlock(glossaryDoc) { Name = "Block 1" };
    glossaryDoc.AppendChild(child1);
    BuildingBlock child2 = new BuildingBlock(glossaryDoc) { Name = "Block 2" };
    glossaryDoc.AppendChild(child2);
    BuildingBlock child3 = new BuildingBlock(glossaryDoc) { Name = "Block 3" };
    glossaryDoc.AppendChild(child3);
    BuildingBlock child4 = new BuildingBlock(glossaryDoc) { Name = "Block 4" };
    glossaryDoc.AppendChild(child4);
    BuildingBlock child5 = new BuildingBlock(glossaryDoc) { Name = "Block 5" };
    glossaryDoc.AppendChild(child5);

    Assert.AreEqual(5, glossaryDoc.BuildingBlocks.Count);

    doc.GlossaryDocument = glossaryDoc;

    // هناك طرق مختلفة للوصول إلى كتل البناء.
    // 1 - احصل على أول/آخر كتلة بناء في المجموعة:
    Assert.AreEqual("Block 1", glossaryDoc.FirstBuildingBlock.Name);
    Assert.AreEqual("Block 5", glossaryDoc.LastBuildingBlock.Name);

    // 2 - الحصول على كتلة بناء حسب الفهرس:
    Assert.AreEqual("Block 2", glossaryDoc.BuildingBlocks[1].Name);
    Assert.AreEqual("Block 3", glossaryDoc.BuildingBlocks.ToArray()[2].Name);

    // 3 - احصل على أول كتلة بناء تتطابق مع المعرض والاسم والفئة:
    Assert.AreEqual("Block 4", 
        glossaryDoc.GetBuildingBlock(BuildingBlockGallery.All, "(Empty Category)", "Block 4").Name);

    // سوف نفعل ذلك باستخدام زائر مخصص،
    // مما سيعطي لكل BuildingBlock في GlossaryDocument معرف GUID فريدًا
    GlossaryDocVisitor visitor = new GlossaryDocVisitor();
    // قم بزيارة بداية/نهاية مستند المصطلحات.
    glossaryDoc.Accept(visitor);
    // قم بزيارة بداية مستند المصطلحات فقط.
    glossaryDoc.AcceptStart(visitor);
    // قم بزيارة نهاية مستند المصطلحات فقط.
    glossaryDoc.AcceptEnd(visitor);
    Console.WriteLine(visitor.GetText());

    // في Microsoft Word، يمكننا الوصول إلى كتل البناء عبر "إدراج" -> "الأجزاء السريعة" -> "منظم كتل البناء".
    doc.Save(ArtifactsDir + "BuildingBlocks.GlossaryDocument.dotx"); 
}

/// <summary>
/// يمنح كل كتلة بناء في مستند المصطلحات الذي تمت زيارتها معرف GUID فريدًا.
/// يخزن أزواج كتلة بناء GUID في القاموس.
/// </summary>
public class GlossaryDocVisitor : DocumentVisitor
{
    public GlossaryDocVisitor()
    {
        mBlocksByGuid = new Dictionary<Guid, BuildingBlock>();
        mBuilder = new StringBuilder();
    }

    public string GetText()
    {
        return mBuilder.ToString();
    }

    public Dictionary<Guid, BuildingBlock> GetDictionary()
    {
        return mBlocksByGuid;
    }

    public override VisitorAction VisitGlossaryDocumentStart(GlossaryDocument glossary)
    {
        mBuilder.AppendLine("Glossary document found!");
        return VisitorAction.Continue;
    }

    public override VisitorAction VisitGlossaryDocumentEnd(GlossaryDocument glossary)
    {
        mBuilder.AppendLine("Reached end of glossary!");
        mBuilder.AppendLine("BuildingBlocks found: " + mBlocksByGuid.Count);
        return VisitorAction.Continue;
    }

    public override VisitorAction VisitBuildingBlockStart(BuildingBlock block)
    {
        block.Guid = Guid.NewGuid();
        mBlocksByGuid.Add(block.Guid, block);
        return VisitorAction.Continue;
    }

    public override VisitorAction VisitBuildingBlockEnd(BuildingBlock block)
    {
        mBuilder.AppendLine("\tVisited block \"" + block.Name + "\"");
        mBuilder.AppendLine("\t Type: " + block.Type);
        mBuilder.AppendLine("\t Gallery: " + block.Gallery);
        mBuilder.AppendLine("\t Behavior: " + block.Behavior);
        mBuilder.AppendLine("\t Description: " + block.Description);

        return VisitorAction.Continue;
    }

    private readonly Dictionary<Guid, BuildingBlock> mBlocksByGuid;
    private readonly StringBuilder mBuilder;
}

أنظر أيضا

class DocumentBase
مساحة الاسم Aspose.Words.BuildingBlocks
المجسم Aspose.Words

BuildingBlockType Enum