StructuredDocumentTag

StructuredDocumentTag class

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

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

public class StructuredDocumentTag : CompositeNode, IStructuredDocumentTag

المنشئون

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

الخصائص

اسموصف
Appearance { get; set; }يحصل على/يحدد مظهر علامة المستند المنظمة.
BuildingBlockCategory { get; set; }يحدد فئة كتلة البناء لهذاSDT node. لا يمكنباطل .
BuildingBlockGallery { get; set; }يحدد نوع كتلة البناء لهذاSDT . لا يمكنباطل .
CalendarType { get; set; }يحدد نوع التقويم لهذاSDT . الافتراضي هوDefault
Checked { get; set; }يحصل على/يحدد الحالة الحالية لمربع الاختيارSDT . القيمة الافتراضية لهذه الخاصية هيخطأ شنيع .
Color { get; set; }يحصل على لون علامة المستند المنظم أو يعينه.
ContentsFont { get; }تنسيق الخط الذي سيتم تطبيقه على النص المدخل فيSDT .
Count { get; }يحصل على عدد الأبناء المباشرين لهذه العقدة.
CustomNodeId { get; set; }يحدد معرف العقدة المخصص.
DateDisplayFormat { get; set; }سلسلة تمثل التنسيق الذي يتم به عرض التواريخ.
DateDisplayLocale { get; set; }يسمح بتعيين/الحصول على تنسيق اللغة للتاريخ المعروض في هذاSDT .
DateStorageFormat { get; set; }يحصل/يحدد التنسيق الذي يتم به تخزين التاريخ لتاريخ SDT عندماSDT مرتبط بعقدة XML في مخزن بيانات المستند. القيمة الافتراضية هيDateTime
virtual Document { get; }يحصل على المستند الذي تنتمي إليه هذه العقدة.
EndCharacterFont { get; }تنسيق الخط الذي سيتم تطبيقه على آخر حرف من النص المدخلSDT .
FirstChild { get; }يحصل على أول طفل للعقدة.
FullDate { get; set; }يحدد التاريخ الكامل والوقت الذي تم إدخاله آخر مرة في هذاSDT .
HasChildNodes { get; }إرجاعحقيقي إذا كانت هذه العقدة تحتوي على أي عقد فرعية.
Id { get; }يحدد معرفًا رقميًا فريدًا للقراءة فقط لهذاSDT.
override IsComposite { get; }إرجاعحقيقي حيث يمكن لهذه العقدة أن تحتوي على عقد فرعية.
IsShowingPlaceholderText { get; set; }يحدد ما إذا كان محتوى هذاSDT يجب تفسيره بحيث يحتوي على نص نائب (على عكس محتويات النص العادي داخل SDT).
IsTemporary { get; set; }يحدد ما إذا كان هذاSDT يجب إزالته من مستند WordProcessingML عند تعديل محتوياته .
LastChild { get; }يحصل على آخر طفل للعقدة.
Level { get; }يحصل على المستوى الذي يتم فيه هذاSDT يحدث في شجرة المستندات.
ListItems { get; }يحصلSdtListItemCollection مرتبط بهذاSDT .
LockContentControl { get; set; }عند ضبطه علىحقيقي ، هذه الخاصية سوف تمنع المستخدم من حذف هذاSDT .
LockContents { get; set; }عند ضبطه علىحقيقي ، هذه الخاصية سوف تمنع المستخدم من تحرير محتويات هذهSDT .
Multiline { get; set; }يحدد ما إذا كان هذاSDT يسمح بخطوط متعددة من النص.
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; }يحدد الاسم الودي المرتبط بهذاSDT . لا يمكنباطل .
WordOpenXML { get; }يحصل على سلسلة تمثل XML الموجود داخل العقدة فيFlatOpc تنسيق.
WordOpenXMLMinimal { get; }يحصل على سلسلة تمثل XML الموجود داخل العقدة فيFlatOpc format. على عكسWordOpenXML الخاصية، هذه الطريقة تولد مستندًا مبسطًا يستبعد أي أجزاء غير مرتبطة بالمحتوى.
XmlMapping { get; }يحصل على كائن يمثل تعيين علامة المستند المنظم هذه إلى XML data في جزء XML مخصص من المستند الحالي.

طُرق

اسموصف
override Accept(DocumentVisitor)يقبل زائرًا.
override AcceptEnd(DocumentVisitor)يقبل زائرًا لزيارة نهاية StructuredDocumentTag.
override AcceptStart(DocumentVisitor)يقبل زائرًا لزيارة بداية StructuredDocumentTag.
AppendChild<T>(T)يضيف العقدة المحددة إلى نهاية قائمة العقد الفرعية لهذه العقدة.
Clear()يمسح محتويات علامة المستند المنظمة هذه ويعرض عنصرًا نائبًا إذا تم تعريفه.
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)يزيل العقدة الفرعية المحددة.
RemoveSelfOnly()يزيل عقدة SDT هذه فقط، لكنه يحتفظ بمحتوياتها داخل شجرة المستندات.
RemoveSmartTags()يزيل الكلSmartTag العقد المنحدرة من العقدة الحالية.
SelectNodes(string)يحدد قائمة العقد المطابقة لتعبير XPath.
SelectSingleNode(string)يحدد الأولNode الذي يتطابق مع تعبير XPath.
SetCheckedSymbol(int, string)يحدد الرمز المستخدم لتمثيل حالة تحديد عنصر التحكم في محتوى مربع الاختيار.
SetUncheckedSymbol(int, string)يحدد الرمز المستخدم لتمثيل حالة عدم تحديد عنصر التحكم في محتوى مربع الاختيار.
ToString(SaveFormat)يصدر محتوى العقدة إلى سلسلة بالتنسيق المحدد.
ToString(SaveOptions)يقوم بتصدير محتوى العقدة إلى سلسلة باستخدام خيارات الحفظ المحددة.

ملاحظات

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

في هذا الإصدار، يوفر 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;

    Console.WriteLine(sdt.WordOpenXMLMinimal);

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

أنظر أيضا

SmartTag Class StructuredDocumentTagCollection Class