StructuredDocumentTag

StructuredDocumentTag class

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

public class StructuredDocumentTag : CompositeNode, IStructuredDocumentTag

المنشئون

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

الخصائص

اسم وصف
Appearance { get; set; } يحصل / يحدد مظهر علامة مستند منظم.
BuildingBlockCategory { get; set; } تحديد فئة الكتلة البرمجية الإنشائية لهذا الغرض المعاملة الخاصة والتفضيلية node. لا يمكن أن تكون فارغة .
BuildingBlockGallery { get; set; } تحديد نوع الكتلة البرمجية الإنشائية لهذا الغرض المعاملة الخاصة والتفضيلية . لا يمكن أن يكون فارغًا .
CalendarType { get; set; } تحديد نوع التقويم لهذا المعاملة الخاصة والتفضيلية . الافتراضي هوDefault
Checked { get; set; } يحصل / يحدد الحالة الحالية لمربع الاختيار المعاملة الخاصة والتفضيلية . القيمة الافتراضية لهذه الخاصية خاطئة.
ChildNodes { get; } يحصل على جميع العقد الفرعية الفورية لهذه العقدة.
Color { get; set; } الحصول على أو تحديد لون علامة المستند المهيكلة.
ContentsFont { get; } تنسيق الخط الذي سيتم تطبيقه على النص الذي تم إدخاله فيه المعاملة الخاصة والتفضيلية .
Count { get; } الحصول على عدد الأطفال المباشرين لهذه العقدة.
CustomNodeId { get; set; } يحدد معرف العقدة المخصص .
DateDisplayFormat { get; set; } السلسلة التي تمثل التنسيق الذي يتم عرض التواريخ به . لا يمكن أن تكون خالية . تواريخ اللغة الإنجليزية (الولايات المتحدة) هي “mm / dd / yyyy”
DateDisplayLocale { get; set; } يسمح بتعيين / الحصول على تنسيق اللغة للتاريخ المعروض في هذا المعاملة الخاصة والتفضيلية .
DateStorageFormat { get; set; } الحصول على / مجموعات التنسيق الذي يتم فيه تخزين تاريخ تاريخ SDT عندما يكون ملف المعاملة الخاصة والتفضيلية مرتبط بعقدة XML في مخزن بيانات المستند. القيمة الافتراضية هيDateTime
virtual Document { get; } الحصول على المستند الذي تنتمي إليه هذه العقدة .
EndCharacterFont { get; } تنسيق الخط الذي سيتم تطبيقه على الحرف الأخير من النص الذي تم إدخاله فيه المعاملة الخاصة والتفضيلية .
FirstChild { get; } الحصول على الطفل الأول للعقدة .
FullDate { get; set; } يحدد التاريخ الكامل والوقت الذي تم إدخاله مؤخرًا في هذا المعاملة الخاصة والتفضيلية .
HasChildNodes { get; } إرجاع صحيح إذا كانت هذه العقدة بها أي عقد فرعية.
Id { get; } يحدد معرّفًا رقميًا فريدًا ومستمرًا للقراءة فقط لهذا الغرض المعاملة الخاصة والتفضيلية.
override IsComposite { get; } إرجاع صحيح لأن هذه العقدة يمكن أن تحتوي على عقد فرعية.
IsShowingPlaceholderText { get; set; } يحدد ما إذا كان محتوى هذا المعاملة الخاصة والتفضيلية يجب أن يتم تفسيره على أنه يحتوي على عنصر نائب text (على عكس محتويات النص العادي داخل SDT).
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; } عوائد NodeType.StructuredDocumentTag .
ParentNode { get; } الحصول على الأصل المباشر لهذه العقدة.
Placeholder { get; } يحصل على ملفBuildingBlock يحتوي على نص عنصر نائب يجب عرضه عندما تكون محتويات تشغيل SDT فارغة ، يكون عنصر XML المعين المرتبط فارغًا كما هو محدد عبرXmlMapping element أو ملفIsShowingPlaceholderText العنصر صحيح.
PlaceholderName { get; set; } يحصل أو يحدد اسمBuildingBlock تحتوي على نص عنصر نائب.
PreviousSibling { get; } يحصل على العقدة التي تسبق هذه العقدة مباشرة.
Range { get; } إرجاع أ نطاق الكائن الذي يمثل جزء المستند الموجود في هذه العقدة.
SdtType { get; } يحصل على نوع من هذا علامة وثيقة منظم .
Style { get; set; } الحصول على أو تحديد نمط علامة المستند المهيكلة.
StyleName { get; set; } الحصول على أو تحديد اسم النمط المطبق على علامة المستند المهيكلة.
Tag { get; set; } يحدد علامة مرتبطة بعقدة SDT الحالية. لا يمكن أن يكون فارغًا .
Title { get; set; } تحديد الاسم المألوف المرتبط بهذا المعاملة الخاصة والتفضيلية . لا يمكن أن يكون فارغًا .
WordOpenXML { get; } يحصل على سلسلة تمثل XML الموجود داخل العقدة في ملفFlatOpc التنسيق .
XmlMapping { get; } الحصول على كائن يمثل تعيين علامة المستند المهيكلة هذه إلى بيانات XML في جزء XML مخصص من المستند الحالي.

طُرق

اسم وصف
override Accept(DocumentVisitor) يقبل الزائر .
AppendChild(Node) يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة .
Clear() يمسح محتويات علامة المستند المهيكلة هذه ويعرض عنصرًا نائبًا إذا تم تحديده.
Clone(bool) لإنشاء نسخة مكررة من العقدة .
CreateNavigator() محجوز لاستخدام النظام. IXPathNavigable.
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) تحديد العقدة الأولى التي تطابق تعبير XPath.
SetCheckedSymbol(int, string) يعين الرمز المستخدم لتمثيل الحالة المحددة لعنصر تحكم محتوى خانة الاختيار.
SetUncheckedSymbol(int, string) يعين الرمز المستخدم لتمثيل الحالة غير المحددة لعنصر تحكم محتوى خانة الاختيار.
ToString(SaveFormat) يصدر محتوى العقدة إلى سلسلة بالتنسيق المحدد.
ToString(SaveOptions) يصدر محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة.

ملاحظات

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

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

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

  • مستوى الكتلة - بين الفقرات والجداول ، كطفل من أBody وHeaderFooter ، Comment وFootnote أو أShape العقدة.
  • على مستوى الصفوف - بين الصفوف في الجدول ، كطفل لـTable العقدة.
  • على مستوى الخلية - بين الخلايا في صف الجدول ، كطفل في ملفRow العقدة.
  • المستوى المضمن - من بين المحتوى المضمّن بالداخل ، بصفتك طفلًا في ملف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;

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

أنظر أيضا