StructuredDocumentTag

نظرة عامة

StructuredDocumentTag هي فئة في Aspose.Words FOSS لـ .NET. ترث من: CompositeNode, IMarkupNode, ITrackableNode، و2 أخرى.

يمثل علامة مستند منظم (SDT أو تحكم محتوى) في المستند.

توفر هذه الفئة 31 طريقة للعمل مع كائنات StructuredDocumentTag في برامج .NET. تشمل الطرق المتاحة: Accept, AcceptEnd, AcceptStart, AppendChild, Clear, Clone, CreateNavigator, GetAncestor, GetAncestorOf, GetChild, GetChildNodes, GetEnumerator، و19 طريقة إضافية. جميع الأعضاء العامة متاحة لأي تطبيق .NET بعد تثبيت حزمة Aspose.Words FOSS لـ .NET. الخصائص: Appearance, BuildingBlockCategory, BuildingBlockGallery, CalendarType, Checked, Color، و38 أخرى.

خصائص

اسم	النوع	الوصول	وصف
`NodeType`	`NodeType`	قراءة	يرجع StructuredDocumentTag.
`Placeholder`	`BuildingBlock`	قراءة	يحصل على BuildingBlock الذي يحتوي على نص العنصر النائب والذي يجب عرضه عندما تكون محتويات تشغيل SDT هذه فارغة، أو يكون عنصر XML المرتبط بالمقابل فارغًا كما هو محدد عبر عنصر XmlMapping أو يكون عنصر IsShowingPlaceholderText صحيحًا.
`PlaceholderName`	`string`	قراءة/كتابة	يحصل أو يعيّن اسم الـ BuildingBlock الذي يحتوي على نص العنصر النائب.
`Level`	`MarkupLevel`	قراءة	يحصل على المستوى الذي يحدث فيه هذا الـ SDT في شجرة المستند.
`SdtType`	`SdtType`	قراءة	يحصل على نوع Structured document tag هذا.
`Id`	`int`	قراءة	يحدد معرفًا رقميًا فريدًا للقراءة فقط ومستمر لهذا الـ SDT.
`LockContentControl`	`bool`	قراءة/كتابة	عند تعيينه إلى true، سيمنع هذه الخاصية المستخدم من حذف هذا الـ SDT.
`LockContents`	`bool`	قراءة/كتابة	عند تعيينه إلى true، سيمنع هذا الخاصية المستخدم من تعديل محتويات هذا SDT.
`IsShowingPlaceholderText`	`bool`	قراءة/كتابة	يحدد ما إذا كان يجب تفسير محتوى هذا SDT على أنه يحتوي على نص نائبي (على عكس محتويات النص العادية داخل الـ SDT).
`Tag`	`string`	قراءة/كتابة	يحدد علامة مرتبطة بعقدة SDT الحالية.
`ContentsFont`	`Font`	قراءة	تنسيق الخط الذي سيُطبق على النص المُدخل في SDT.
`EndCharacterFont`	`Font`	قراءة	تنسيق الخط الذي سيُطبق على الحرف الأخير من النص المُدخل في SDT.
`IsTemporary`	`bool`	قراءة/كتابة	يحدد ما إذا كان يجب إزالة هذا الـ SDT من مستند WordProcessingML عندما يتم تعديل محتوياته.
`Title`	`string`	قراءة/كتابة	يحدد الاسم الودي المرتبط بهذا الـ SDT.
`ListItems`	`SdtListItemCollection`	قراءة	يحصل على SdtListItemCollection المرتبط بهذا الـ SDT.
`Checked`	`bool`	قراءة/كتابة	يحصل/يضبط الحالة الحالية لـ Checkbox SDT.
`Appearance`	`SdtAppearance`	قراءة/كتابة	يحصل/يضبط مظهر الـ structured document tag.
`DateDisplayLocale`	`int`	قراءة/كتابة	يسمح بتعيين/استرجاع تنسيق اللغة للتاريخ المعروض في هذا الـ SDT.
`DateDisplayFormat`	`string`	قراءة/كتابة	سلسلة تمثل التنسيق الذي تُعرض به التواريخ.
`FullDate`	`DateTime`	قراءة/كتابة	يحدد التاريخ والوقت الكاملين اللذين تم إدخالهما آخر مرة في هذا الـ SDT.
`DateStorageFormat`	`SdtDateStorageFormat`	قراءة/كتابة	يحصل/يضبط التنسيق الذي تُخزن به التاريخ لتاريخ SDT عندما يكون الـ SDT مرتبطًا بعقدة XML في مخزن بيانات المستند.
`CalendarType`	`SdtCalendarType`	قراءة/كتابة	يحدد نوع التقويم لهذا الـ SDT.
`BuildingBlockGallery`	`string`	قراءة/كتابة	يحدد نوع وحدة البناء لهذا الـ SDT.
`BuildingBlockCategory`	`string`	قراءة/كتابة	يحدد فئة كتلة البناء لهذه العقدة SDT.
`Multiline`	`bool`	قراءة/كتابة	يحدد ما إذا كانت هذه الـSDT تسمح بعدة أسطر من النص.
`Color`	`System.Drawing.Color`	قراءة/كتابة	يسترجع أو يعيّن لون الـStructuredDocumentTag.
`Style`	`Style`	قراءة/كتابة	يحصل أو يعيّن النمط لعلامة المستند المهيكلة.
`StyleName`	`string`	قراءة/كتابة	يحصل أو يعيّن اسم النمط المطبق على وسم المستند المهيكل.
`XmlMapping`	`XmlMapping`	قراءة	يحصل على كائن يمثل تعيين علامة المستند المهيكلة هذه إلى بيانات XML في جزء XML مخصص من المستند الحالي.
`WordOpenXML`	`string`	قراءة	يحصل على سلسلة تمثل XML الموجودة داخل العقدة بتنسيق FlatOpc.
`WordOpenXMLMinimal`	`string`	قراءة	يحصل على سلسلة تمثل XML الموجودة داخل العقدة بتنسيق FlatOpc.
`IsComposite`	`bool`	قراءة	يرجع true لأن هذه العقدة يمكن أن تحتوي على عقد فرعية.
`HasChildNodes`	`bool`	قراءة	يرجع true إذا كانت هذه العقدة تحتوي على أي عقد فرعية.
`FirstChild`	`Node`	قراءة	يحصل على الطفل الأول للعقدة.
`LastChild`	`Node`	قراءة	يحصل على الطفل الأخير للعقدة.
`Count`	`int`	قراءة	يحصل على عدد الأطفال المباشرين لهذه العقدة.
`ParentNode`	`CompositeNode`	قراءة	يحصل على الوالد الفوري لهذه العقدة.
`Document`	`DocumentBase`	قراءة	يحصل على المستند الذي تنتمي إليه هذه العقدة.
`PreviousSibling`	`Node`	قراءة	يُرجع العقدة التي تسبق هذه العقدة مباشرةً.
`NextSibling`	`Node`	قراءة	يحصل على العقدة التي تلي هذه العقدة مباشرةً.
`Range`	`Range`	قراءة	يرجع كائن Range يمثل الجزء من المستند الموجود داخل هذه العقدة.
`CustomNodeId`	`int`	قراءة/كتابة	يحدد معرف العقدة المخصص.
`IsMultiSection`	`bool`	قراءة	يعيد true إذا كان هذا الكائن علامة مستند هيكلية ذات نطاق (متعدد الأقسام).
`Node`	`Node`	قراءة	يعيد كائن Node الذي يطبق هذه الواجهة.

الطرق

التوقيع	وصف
`StructuredDocumentTag(doc: DocumentBase, type: SdtType, level: MarkupLevel)`	ينشئ مثيلًا جديدًا من فئة Structured document tag.
`SetCheckedSymbol(characterCode: int, fontName: string)`	يضبط الرمز المستخدم لتمثيل الحالة المحددة لعنصر تحكم محتوى صندوق الاختيار.
`SetUncheckedSymbol(characterCode: int, fontName: string)`	يضبط الرمز المستخدم لتمثيل الحالة غير المحددة لعنصر تحكم محتوى صندوق الاختيار.
`RemoveSelfOnly()`	يزيل عقدة SDT هذه نفسها فقط، لكنه يبقي محتواها داخل شجرة المستند.
`Accept(visitor: DocumentVisitor)`	ينادي VisitStructuredDocumentTagStart، ثم ينادي Accept لجميع العقد الفرعية للعلامة الذكية ويستدعي VisitStructuredDocumentTagEnd في النهاية.
`Clear()`	يمسح محتويات هذه العلامة المهيكلة في المستند ويعرض عنصرًا نائبًا إذا تم تعريفه.
`AcceptStart(visitor: DocumentVisitor)`	يقبل زائرًا لزيارة بداية StructuredDocumentTag.
`AcceptEnd(visitor: DocumentVisitor)`	يقبل زائرًا لزيارة نهاية الـ StructuredDocumentTag.
`GetText()`	يسترجع النص لهذا العقد وجميع أبنائه.
`GetChildNodes(nodeType: NodeType, isDeep: bool)`	يعيد مجموعة من العقد الفرعية التي تطابق النوع المحدد.
`GetChild(nodeType: NodeType, index: int, isDeep: bool)`	يعيد عقدة فرعية رقم N تتطابق مع النوع المحدد.
`SelectNodes(xpath: string)`	يختار قائمة من العقد التي تتطابق مع تعبير XPath.
`SelectSingleNode(xpath: string)`	يختار أول عقدة تتطابق مع تعبير XPath.
`GetEnumerator()`	يوفر دعمًا للتكرار بنمط for each على العقد الفرعية لهذه العقدة.
`AppendChild(newChild: T)`	يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذا العقد.
`PrependChild(newChild: T)`	يضيف العقدة المحددة إلى بداية قائمة العقد الفرعية لهذا العقد.
`InsertAfter(newChild: T, refChild: Node)`	يدرج العقدة المحددة مباشرةً بعد العقدة المرجعية المحددة.
`InsertBefore(newChild: T, refChild: Node)`	يدرج العقدة المحددة مباشرةً قبل العقدة المرجعية المحددة.
`RemoveChild(oldChild: T)`	يزيل العقدة الفرعية المحددة.
`RemoveAllChildren()`	يزيل جميع العقد الفرعية للعقدة الحالية.
`RemoveSmartTags()`	يزيل جميع العقد التابعة لـ SmartTag للعنصر الحالي.
`IndexOf(child: Node)`	يعيد فهرس العقدة الفرعية المحددة في مصفوفة العقد الفرعية.
`CreateNavigator()`	ينشئ متصفحًا يمكن استخدامه لتصفح وقراءة العقد.
`Clone(isCloneChildren: bool)`	يجب عليك استخدام التحميل الزائد Clone(bool, INodeCloningListener) عندما يكون استنساخ العقد جزءًا من عملية استنساخ عقد أخرى (عادةً ما تكون مركبة).
`GetAncestor(ancestorType: Type)`	يحصل على السلف الأول لنوع الكائن المحدد.
`GetAncestorOf()`	يستدعي GetAncestorOf على هذا الكائن من StructuredDocumentTag.
`Remove()`	يزيل نفسه من العنصر الأب.
`NextPreOrder(rootNode: Node)`	يحصل على العقدة التالية وفقًا لخوارزمية التجوال المسبق للشجرة.
`PreviousPreOrder(rootNode: Node)`	يحصل على العقدة السابقة وفقًا لخوارزمية عبور الشجرة بترتيب ما قبل الترتيب.
`ToString(saveFormat: SaveFormat)`	يصدر محتوى العقدة إلى سلسلة نصية بالتنسيق المحدد.
`NodeTypeToString(nodeType: NodeType)`	طريقة مساعدة تقوم بتحويل قيمة تعداد نوع العقدة إلى سلسلة صديقة للمستخدم.

انظر أيضاً

Aspose.Words for .NET — Enterprise API Reference