Placeholder

StructuredDocumentTag.Placeholder property

يحصل علىBuildingBlock يحتوي على نص نائب يجب عرضه عندما تكون محتويات تشغيل SDT هذه فارغة، يكون عنصر XML المرتبط فارغًا كما هو محدد عبرXmlMapping element أوIsShowingPlaceholderText العنصر هوحقيقي .

public BuildingBlock Placeholder { get; }

ملاحظات

يمكن أن يكونباطل، مما يعني أن العنصر النائب غير قابل للتطبيق على هذا Sdt.

أمثلة

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

Document doc = new Document();

// قم بإدراج علامة مستند منظمة نصية عادية من نوع "PlainText"، والتي ستعمل كمربع نص.
// المحتوى الذي سيتم عرضه بشكل افتراضي هو عبارة عن مطالبة "انقر هنا لإدخال النص".
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Inline);

// يمكننا جعل العلامة تعرض محتويات كتلة البناء بدلاً من النص الافتراضي.
// أولاً، أضف كتلة بناء تحتوي على محتويات إلى مستند المصطلحات.
GlossaryDocument glossaryDoc = doc.GlossaryDocument;

BuildingBlock substituteBlock = new BuildingBlock(glossaryDoc);
substituteBlock.Name = "Custom Placeholder";
substituteBlock.AppendChild(new Section(glossaryDoc));
substituteBlock.FirstSection.AppendChild(new Body(glossaryDoc));
substituteBlock.FirstSection.Body.AppendParagraph("Custom placeholder text.");

glossaryDoc.AppendChild(substituteBlock);

// ثم استخدم خاصية "PlaceholderName" الموجودة في علامة المستند المنظم للإشارة إلى كتلة البناء هذه بالاسم.
tag.PlaceholderName = "Custom Placeholder";

// إذا كان "PlaceholderName" يشير إلى كتلة موجودة في مستند المصطلحات الخاص بالمستند الرئيسي،
// سوف نكون قادرين على التحقق من كتلة البناء من خلال خاصية "Placeholder".
Assert.AreEqual(substituteBlock, tag.Placeholder);

// اضبط خاصية "IsShowingPlaceholderText" على "true" لمعالجة
// المحتويات الحالية لعلامة المستند المنظم كنص بديل.
// وهذا يعني أن النقر فوق مربع النص في Microsoft Word سيؤدي على الفور إلى تسليط الضوء على كافة محتويات العلامة.
// اضبط خاصية "IsShowingPlaceholderText" على "false" للحصول على
// علامة مستند منظمة لمعاملة محتوياتها كنص أدخله المستخدم بالفعل.
// النقر فوق هذا النص في Microsoft Word سيضع المؤشر الوامض في الموقع الذي تم النقر فوقه.
tag.IsShowingPlaceholderText = isShowingPlaceholderText;

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

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

أنظر أيضا

StructuredDocumentTag.NodeType StructuredDocumentTag.PlaceholderName