InsertTextInput

DocumentBuilder.InsertTextInput method

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

public FormField InsertTextInput(string name, TextFormFieldType type, string format, 
    string fieldValue, int maxLength)
معامليكتبوصف
nameStringاسم حقل النموذج. يمكن أن تكون سلسلة فارغة.
typeTextFormFieldTypeيحدد نوع حقل النموذج النصي.
formatStringسلسلة التنسيق المستخدمة لتنسيق قيمة حقل النموذج.
fieldValueStringالنص الذي سيتم عرضه في هذا المجال.
maxLengthInt32الحد الأقصى للطول الذي يمكن للمستخدم إدخاله في حقل النموذج. اضبط على الصفر لمدة غير محدودة.

قيمة الإرجاع

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

ملاحظات

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

أمثلة

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

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

// أدخل نموذجًا يطالب المستخدم بإدخال النص.
builder.InsertTextInput("TextInput", TextFormFieldType.Regular, "", "Enter your text here", 0);

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

يوضح كيفية إدراج حقل نموذج إدخال النص.

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

builder.Write("Please enter text here: ");

// أدخل حقل إدخال النص، والذي سيسمح للمستخدم بالنقر فوقه وإدخال النص.
// قم بتعيين بعض نص العنصر النائب الذي يمكن للمستخدم الكتابة فوقه وتمريره
// الحد الأقصى لطول النص هو 0 لتطبيق أي حد على محتويات حقل النموذج.
builder.InsertTextInput("TextInput1", TextFormFieldType.Regular, "", "Placeholder text", 0);

// سيظهر حقل النموذج على شكل علامة html "إدخال"، بنوع "نص".
doc.Save(ArtifactsDir + "FormFields.TextInput.html");

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

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");

أنظر أيضا