StructuredDocumentTag

StructuredDocumentTag class

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

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

public class StructuredDocumentTag : CompositeNode, IStructuredDocumentTag

المنشئون

اسموصف
StructuredDocumentTag(DocumentBase, SdtType, MarkupLevel)تهيئة مثيل جديد لـعلامة الوثيقة المنظمة فئة.

الخصائص

اسموصف
Appearance { get; set; }الحصول على/تعيين مظهر علامة المستند المنظمة.
BuildingBlockCategory { get; set; }يحدد فئة الكتلة البرمجية الإنشائية لهذا الغرضالمعاملة الخاصة والتفضيلية العقدة. لا يمكن أن يكونباطل .
BuildingBlockGallery { get; set; }يحدد نوع الكتلة البرمجية الإنشائية لهذا الغرضالمعاملة الخاصة والتفضيلية . لا يمكن أن يكونباطل .
CalendarType { get; set; }يحدد نوع التقويم لذلكالمعاملة الخاصة والتفضيلية . الافتراضي هوDefault
Checked { get; set; }الحصول على/تعيين الحالة الحالية لمربع الاختيارالمعاملة الخاصة والتفضيلية . القيمة الافتراضية لهذه الخاصية هيخطأ شنيع .
Color { get; set; }الحصول على أو تعيين لون علامة المستند المنظمة.
ContentsFont { get; }تنسيق الخط الذي سيتم تطبيقه على النص الذي تم إدخالهالمعاملة الخاصة والتفضيلية .
Count { get; }يحصل على عدد الأطفال المباشرين لهذه العقدة.
CustomNodeId { get; set; }يحدد معرف العقدة المخصصة.
DateDisplayFormat { get; set; }سلسلة تمثل التنسيق الذي يتم عرض التواريخ به. لا يمكن أن يكونباطل . التواريخ للغة الإنجليزية (الولايات المتحدة) هي “mm/dd/yyyy”
DateDisplayLocale { get; set; }يسمح بتعيين/الحصول على تنسيق اللغة للتاريخ المعروض في هذاالمعاملة الخاصة والتفضيلية .
DateStorageFormat { get; set; }تنسيق Get/sets الذي يتم فيه تخزين تاريخ SDT عندماالمعاملة الخاصة والتفضيليةيرتبط بعقدة XML في مخزن بيانات المستند. القيمة الافتراضية هيDateTime
virtual Document { get; }الحصول على المستند الذي تنتمي إليه هذه العقدة.
EndCharacterFont { get; }تنسيق الخط الذي سيتم تطبيقه على الحرف الأخير من النص الذي تم إدخالهالمعاملة الخاصة والتفضيلية .
FirstChild { get; }يحصل على الطفل الأول للعقدة.
FullDate { get; set; }يحدد التاريخ والوقت الكاملين لآخر إدخال في هذاالمعاملة الخاصة والتفضيلية .
HasChildNodes { get; }إرجاعحقيقي إذا كانت هذه العقدة تحتوي على أي عقد فرعية.
Id { get; }يحدد معرفًا رقميًا ثابتًا فريدًا للقراءة فقط لهذا الغرضالمعاملة الخاصة والتفضيلية.
override IsComposite { get; }إرجاعحقيقي لأن هذه العقدة يمكن أن تحتوي على عقد فرعية.
IsShowingPlaceholderText { get; set; }يحدد ما إذا كان محتوى هذاالمعاملة الخاصة والتفضيليةيجب تفسيره على أنه يحتوي على العنصر النائب text (على عكس محتويات النص العادي ضمن المعاملة الخاصة والتفضيلية).
IsTemporary { get; set; }يحدد ما إذا كان هذاالمعاملة الخاصة والتفضيلية ستتم إزالته من مستند WordProcessingML عند تعديل محتوياته .
LastChild { get; }يحصل على الطفل الأخير للعقدة.
Level { get; }يحصل على المستوى الذي عندهالمعاملة الخاصة والتفضيلية يحدث في شجرة المستندات.
ListItems { get; }يحصلSdtListItemCollection المرتبطة بهذاالمعاملة الخاصة والتفضيلية .
LockContentControl { get; set; }عند الضبط علىحقيقي ، ستمنع هذه الخاصية المستخدم من حذف هذاالمعاملة الخاصة والتفضيلية .
LockContents { get; set; }عند الضبط علىحقيقي ، ستمنع هذه الخاصية المستخدم من تحرير محتويات هذاالمعاملة الخاصة والتفضيلية .
Multiline { get; set; }يحدد ما إذا كان هذاالمعاملة الخاصة والتفضيلية يسمح بعدة أسطر من النص.
NextSibling { get; }يحصل على العقدة التي تلي هذه العقدة مباشرة.
override NodeType { get; }إرجاعStructuredDocumentTag .
ParentNode { get; }يحصل على الأصل المباشر لهذه العقدة.
Placeholder { get; }يحصل علىBuildingBlockيحتوي على نص عنصر نائب يجب عرضه عندما تكون محتويات تشغيل SDT فارغة، عنصر XML المعين المرتبط فارغ كما هو محدد عبرXmlMapping element أوIsShowingPlaceholderText العنصر هوحقيقي .
PlaceholderName { get; set; }الحصول على أو تعيين اسمBuildingBlock تحتوي على نص نائب.
PreviousSibling { get; }يحصل على العقدة التي تسبق هذه العقدة مباشرة.
Range { get; }إرجاع أRange الكائن الذي يمثل جزء المستند الموجود في هذه العقدة.
SdtType { get; }يحصل على نوع من هذاعلامة الوثيقة المنظمة .
Style { get; set; }الحصول على نمط علامة المستند المنظمة أو تعيينه.
StyleName { get; set; }الحصول على أو تعيين اسم النمط المطبق على علامة المستند المنظمة.
Tag { get; set; }يحدد علامة مرتبطة بعقدة SDT الحالية. لا يمكن أن يكونباطل .
Title { get; set; }يحدد الاسم المألوف المرتبط بهذاالمعاملة الخاصة والتفضيلية . لا يمكن أن يكونباطل .
WordOpenXML { get; }يحصل على سلسلة تمثل XML الموجود داخل العقدة في ملفFlatOpc التنسيق.
WordOpenXMLMinimal { get; }يحصل على سلسلة تمثل XML الموجود داخل العقدة في ملفFlatOpc تنسيق. خلافا لWordOpenXMLالخاصية، تقوم هذه الطريقة بإنشاء مستند مبسط يستبعد أي أجزاء غير متعلقة بالمحتوى.
XmlMapping { get; }الحصول على كائن يمثل تعيين علامة المستند المنظمة هذه إلى بيانات XML في جزء XML مخصص من المستند الحالي.

طُرق

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

ملاحظات

تسمح علامات المستندات المنظمة (SDTs) بتضمين دلالات محددة من قبل العميل بالإضافة إلى سلوكها ومظهرها في المستند.

في هذا الإصدار، يوفر Aspose.Words عددًا من الأساليب والخصائص العامة للتعامل مع سلوك ومحتوىStructuredDocumentTag . يمكن إجراء تعيين عقد SDT لحزم XML المخصصة داخل المستند باستخدام XmlMapping ملكية.

StructuredDocumentTag يمكن أن يحدث في مستند في الأماكن التالية:

  • مستوى الكتلة - بين الفقرات والجداول، كطفل لـ aBody ,HeaderFooterComment ,Footnote أو أShape العقدة.
  • مستوى الصف - بين الصفوف في الجدول، كطفل لـ aTable العقدة.
  • مستوى الخلية - بين الخلايا الموجودة في صف الجدول، كفرع لـ aRow العقدة.
  • المستوى المضمن - من بين المحتوى المضمن بالداخل، كطفل لـParagraph.
  • متداخلة داخل آخرStructuredDocumentTag.

أمثلة

يوضح كيفية العمل مع أنماط عناصر التحكم في المحتوى.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// فيما يلي طريقتان لتطبيق نمط من المستند على علامة مستند منظمة.
// 1 - تطبيق كائن نمط من مجموعة أنماط المستند:
Style quoteStyle = doc.Styles[StyleIdentifier.Quote];
StructuredDocumentTag sdtPlainText =
    new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Inline) { Style = quoteStyle };

// 2 - قم بالإشارة إلى النمط الموجود في المستند بالاسم:
StructuredDocumentTag sdtRichText =
    new StructuredDocumentTag(doc, SdtType.RichText, MarkupLevel.Inline) { StyleName = "Quote" };

builder.InsertNode(sdtPlainText);
builder.InsertNode(sdtRichText);

Assert.AreEqual(NodeType.StructuredDocumentTag, sdtPlainText.NodeType);

NodeCollection tags = doc.GetChildNodes(NodeType.StructuredDocumentTag, true);

foreach (Node node in tags)
{
    StructuredDocumentTag sdt = (StructuredDocumentTag)node;

    Console.WriteLine(sdt.WordOpenXMLMinimal);

    Assert.AreEqual(StyleIdentifier.Quote, sdt.Style.StyleIdentifier);
    Assert.AreEqual("Quote", sdt.StyleName);
}

أنظر أيضا

SmartTag Class StructuredDocumentTagCollection Class