Id

StructuredDocumentTag.Id property

يحدد معرفًا رقميًا ثابتًا فريدًا للقراءة فقط لهذا الغرضالمعاملة الخاصة والتفضيلية.

public int Id { get; }

ملاحظات

يجب أن تتبع سمة المعرف هذه القواعد:

  • يجب أن يحتفظ المستند بمعرفات SDT فقط في حالة استنساخ المستند بأكملهClone.
  • خلالImportNode يجب الاحتفاظ بالمعرف إذا لم يتسبب الاستيراد في حدوث تعارضات مع معرفات SDT الأخرى في المستند الهدف.
  • إذا حددت عدة عقد SDT نفس قيمة الرقم العشري لسمة المعرف، ، فيجب أن تحتفظ المعاملة SDT الأولى في المستند بهذا المعرف الأصلي، ويجب أن يكون لجميع عقد SDT اللاحقة معرفات جديدة مخصصة لها عند تحميل المستند.
  • خلال المعاملة الخاصة والتفضيلية المستقلةINodeCloningListener) سيتم إنشاء معرف فريد جديد لعقدة SDT المستنسخة.
  • إذا لم يتم تحديد المعرف في المستند المصدر، فيجب أن يكون لعقدة SDT معرف فريد جديد يتم تعيينه لها عند تحميل المستند.

أمثلة

يوضح كيفية إنشاء علامة مستند منظمة في مربع نص عادي وتعديل مظهرها.

Document doc = new Document();

// قم بإنشاء علامة مستند منظمة تحتوي على نص عادي.
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Inline);

// قم بتعيين عنوان ولون الإطار الذي يظهر عند تمرير الماوس فوق علامة المستند المنظم في Microsoft Word.
tag.Title = "My plain text";
tag.Color = Color.Magenta;

// قم بتعيين علامة لعلامة المستند المنظمة هذه، والتي يمكن الحصول عليها
// كعنصر XML يُسمى "tag"، مع السلسلة الموجودة أدناه في السمة "@val" الخاصة به.
tag.Tag = "MyPlainTextSDT";

// كل علامة مستند منظمة لها معرف فريد عشوائي.
Assert.That(tag.Id, Is.Positive);

// قم بتعيين الخط للنص داخل علامة المستند المنظم.
tag.ContentsFont.Name = "Arial";

// قم بتعيين الخط للنص الموجود في نهاية علامة المستند المنظمة.
// أي نص نكتبه في نص المستند بعد الخروج من العلامة باستخدام مفاتيح الأسهم سيستخدم هذا الخط.
tag.EndCharacterFont.Name = "Arial Black";

// بشكل افتراضي، هذا خطأ والضغط على زر الإدخال أثناء وجودك داخل علامة مستند منظمة لا يؤدي إلى أي شيء.
// عند التعيين على "صحيح"، يمكن أن تحتوي علامة المستند المنظمة لدينا على عدة أسطر.

// اضبط الخاصية "متعدد الأسطر" على "خطأ" للسماح بالمحتويات فقط
// من علامة المستند المنظمة هذه لتمتد على سطر واحد.
// اضبط الخاصية "متعدد الأسطر" على "صحيح" للسماح للعلامة باحتواء أسطر متعددة من المحتوى.
tag.Multiline = true;

// قم بتعيين خاصية "المظهر" على "SdtAppearance.Tags" لإظهار العلامات حول المحتوى.
 // افتراضيًا، تظهر علامة المستند المنظمة كـ BoundingBox.
tag.Appearance = SdtAppearance.Tags;

DocumentBuilder builder = new DocumentBuilder(doc);
builder.InsertNode(tag);

// أدخل نسخة من علامة المستند المنظمة في فقرة جديدة.
StructuredDocumentTag tagClone = (StructuredDocumentTag)tag.Clone(true);
builder.InsertParagraph();
builder.InsertNode(tagClone);

// استخدم طريقة "RemoveSelfOnly" لإزالة علامة مستند منظم، مع الاحتفاظ بمحتوياتها في المستند.
tagClone.RemoveSelfOnly();

doc.Save(ArtifactsDir + "StructuredDocumentTag.PlainText.docx");

أنظر أيضا

StructuredDocumentTag.FullDate StructuredDocumentTag.IsShowingPlaceholderText