InsertCheckBox

InsertCheckBox(string, bool, int)

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

public FormField InsertCheckBox(string name, bool checkedValue, int size)
معامليكتبوصف
nameStringاسم حقل النموذج. يمكن أن يكون نصًا فارغًا. سيتم حذف أي قيمة أطول من ٢٠ حرفًا.
checkedValueBooleanتم التحقق من حالة حقل نموذج مربع الاختيار.
sizeInt32يُحدِّد حجم مربع الاختيار بالنقاط. حدّد القيمة 0 لـ MS Word لحساب حجم مربع الاختيار تلقائيًا.

قيمة الإرجاع

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

ملاحظات

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

أمثلة

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

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

// إدراج مربعات الاختيار ذات الأحجام المختلفة والحالات المحددة الافتراضية.
builder.Write("Unchecked check box of a default size: ");
builder.InsertCheckBox(string.Empty, false, false, 0);
builder.InsertParagraph();

builder.Write("Large checked check box: ");
builder.InsertCheckBox("CheckBox_Default", true, true, 50);
builder.InsertParagraph();

// تحتوي حقول النموذج على حد أقصى لطول الاسم يبلغ 20 حرفًا.
builder.Write("Very large checked check box: ");
builder.InsertCheckBox("CheckBox_OnlyCheckedValue", true, 100);

Assert.AreEqual("CheckBox_OnlyChecked", doc.Range.FormFields[2].Name);

// يمكننا التفاعل مع مربعات الاختيار هذه في Microsoft Word عن طريق النقر المزدوج عليها.
doc.Save(ArtifactsDir + "DocumentBuilder.InsertCheckBox.docx");

أنظر أيضا


InsertCheckBox(string, bool, bool, int)

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

public FormField InsertCheckBox(string name, bool defaultValue, bool checkedValue, int size)
معامليكتبوصف
nameStringاسم حقل النموذج. يمكن أن يكون نصًا فارغًا. سيتم حذف أي قيمة أطول من ٢٠ حرفًا.
defaultValueBooleanالقيمة الافتراضية لحقل نموذج مربع الاختيار.
checkedValueBooleanالحالة الحالية لفحص حقل نموذج مربع الاختيار.
sizeInt32يُحدِّد حجم مربع الاختيار بالنقاط. حدّد القيمة 0 لـ MS Word لحساب حجم مربع الاختيار تلقائيًا.

قيمة الإرجاع

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

ملاحظات

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

أمثلة

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

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

// إدراج مربعات الاختيار ذات الأحجام المختلفة والحالات المحددة الافتراضية.
builder.Write("Unchecked check box of a default size: ");
builder.InsertCheckBox(string.Empty, false, false, 0);
builder.InsertParagraph();

builder.Write("Large checked check box: ");
builder.InsertCheckBox("CheckBox_Default", true, true, 50);
builder.InsertParagraph();

// تحتوي حقول النموذج على حد أقصى لطول الاسم يبلغ 20 حرفًا.
builder.Write("Very large checked check box: ");
builder.InsertCheckBox("CheckBox_OnlyCheckedValue", true, 100);

Assert.AreEqual("CheckBox_OnlyChecked", doc.Range.FormFields[2].Name);

// يمكننا التفاعل مع مربعات الاختيار هذه في Microsoft Word عن طريق النقر المزدوج عليها.
doc.Save(ArtifactsDir + "DocumentBuilder.InsertCheckBox.docx");

أنظر أيضا