SdtListItem

SdtListItem class

يحدد هذا العنصر عنصر قائمة واحدًا داخل العنصر الرئيسيComboBox أوDropDownList علامة وثيقة منظم.

public class SdtListItem

المنشئون

اسم وصف
SdtListItem(string) تهيئة مثيل جديد لهذه الفئة.
SdtListItem(string, string) تهيئة مثيل جديد لهذه الفئة.

الخصائص

اسم وصف
DisplayText { get; } الحصول على النص الذي سيتم عرضه في محتوى التشغيل بدلاً من ملفValue محتويات السمة لعنصر القائمة هذا.
Value { get; } الحصول على قيمة عنصر القائمة هذا.

أمثلة

يوضح كيفية العمل مع علامات المستندات المهيكلة للقائمة المنسدلة.

Document doc = new Document();
StructuredDocumentTag tag = new StructuredDocumentTag(doc, SdtType.DropDownList, MarkupLevel.Block);
doc.FirstSection.Body.AppendChild(tag);

// علامة المستند المهيكلة القائمة المنسدلة هي نموذج يسمح للمستخدم
// حدد خيارًا من قائمة بالنقر بزر الماوس الأيسر وفتح النموذج في Microsoft Word.
// تحتوي الخاصية "ListItems" على كافة عناصر القائمة ، ويكون كل عنصر قائمة "SdtListItem".
SdtListItemCollection listItems = tag.ListItems;
listItems.Add(new SdtListItem("Value 1"));

Assert.AreEqual(listItems[0].DisplayText, listItems[0].Value);

// أضف 3 عناصر قائمة أخرى. قم بتهيئة هذه العناصر باستخدام مُنشئ مختلف للعنصر الأول
// لعرض سلاسل مختلفة عن قيمها.
listItems.Add(new SdtListItem("Item 2", "Value 2"));
listItems.Add(new SdtListItem("Item 3", "Value 3"));
listItems.Add(new SdtListItem("Item 4", "Value 4"));

Assert.AreEqual(4, listItems.Count);

// تعرض القائمة المنسدلة العنصر الأول. قم بتعيين عنصر قائمة مختلف إلى "SelectedValue" لعرضه.
listItems.SelectedValue = listItems[3];

Assert.AreEqual("Value 4", listItems.SelectedValue.Value);

// تعداد المجموعة وطباعة كل عنصر.
using (IEnumerator<SdtListItem> enumerator = listItems.GetEnumerator())
{
    while (enumerator.MoveNext())
        if (enumerator.Current != null)
            Console.WriteLine($"List item: {enumerator.Current.DisplayText}, value: {enumerator.Current.Value}");
}

 // إزالة عنصر القائمة الأخير.
listItems.RemoveAt(3);

Assert.AreEqual(3, listItems.Count);

// نظرًا لأن عنصر التحكم في القائمة المنسدلة مضبوط على عرض العنصر الذي تمت إزالته افتراضيًا ، فامنحه عنصرًا للعرض موجودًا.
listItems.SelectedValue = listItems[1];

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

// استخدم طريقة "المسح" لتفريغ مجموعة العناصر المنسدلة بالكامل مرة واحدة.
listItems.Clear();

Assert.AreEqual(0, listItems.Count);

أنظر أيضا