InsertComboBox

DocumentBuilder.InsertComboBox method

إدراج حقل نموذج combobox في الموضع الحالي.

public FormField InsertComboBox(string name, string[] items, int selectedIndex)
معامليكتبوصف
nameStringاسم حقل النموذج. يمكن أن تكون سلسلة فارغة. سيتم اقتطاع القيمة الأطول من 20 حرفًا.
itemsString[]عناصر ComboBox. الحد الأقصى هو 25 مادة.
selectedIndexInt32فهرس العنصر المحدد في ComboBox.

قيمة الإرجاع

عقدة حقل النموذج التي تم إدراجها للتو.

ملاحظات

إذا قمت بتحديد اسم لحقل النموذج، فسيتم إنشاء إشارة مرجعية تلقائيًا بنفس الاسم.

أمثلة

يوضح كيفية إدراج حقل نموذج مربع التحرير والسرد في المستند.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// أدخل نموذجًا يطالب المستخدم باختيار أحد العناصر من القائمة.
builder.Write("Pick a fruit: ");
string[] items = { "Apple", "Banana", "Cherry" };
builder.InsertComboBox("DropDown", items, 0);

doc.Save(ArtifactsDir + "DocumentBuilder.InsertComboBox.docx");

يوضح كيفية إنشاء حقول النموذج.

DocumentBuilder builder = new DocumentBuilder();

// حقول النموذج هي كائنات في المستند يمكن للمستخدم التفاعل معها من خلال مطالبته بإدخال القيم.
// يمكننا إنشاؤها باستخدام أداة إنشاء المستندات، وفيما يلي طريقتان للقيام بذلك.
// 1 - إدخال النص الأساسي:
builder.InsertTextInput("My text input", TextFormFieldType.Regular, 
    "", "Enter your name here", 30);

// 2 - مربع تحرير وسرد يحتوي على نص موجه ونطاق من القيم المحتملة:
string[] items =
{
    "-- Select your favorite footwear --", "Sneakers", "Oxfords", "Flip-flops", "Other"
};

builder.InsertParagraph();
builder.InsertComboBox("My combo box", items, 0);

builder.Document.Save(ArtifactsDir + "DocumentBuilder.CreateForm.docx");

أنظر أيضا