Class CheckboxField

CheckboxField class

فئة تمثل حقل checkbox

public class CheckboxField : Field

Constructors

NameDescription
CheckboxField(Document)مُنشئ للاستخدام مع Generator.
CheckboxField(Document, Rectangle)مُنشئ لفئة CheckboxField.
CheckboxField(Page, Rectangle)مُنشئ لفئة CheckboxField.

Properties

NameDescription
Actions { get; }يحصل على إجراءات التعليق. (2 خصائص)
override ActiveState { get; set; }يحصل أو يحدد حالة مظهر التعليق الحالي.
AllowedStates { get; }يُرجع قائمة بالحالات المسموح بها.
AlternateName { get; set; }يحصل أو يحدد الاسم البديل للحقل (اسم حقل بديل يجب استخدامه بدلاً من الاسم الفعلي للحقل حيثما يتم التعرف على الحقل في واجهة المستخدم). يُستخدم الاسم البديل كأداة تلميح للحقل في Adobe Acrobat.
AnnotationIndex { get; set; }يحصل أو يحدد فهرس هذا التعليق على الصفحة.
override AnnotationType { get; }يحصل على نوع التعليق.
Appearance { get; }يحصل على قاموس مظهر التعليق.
Border { get; set; }يحصل أو يحدد خصائص حدود التعليق. Border
Characteristics { get; }يحصل على خصائص التعليق.
Checked { get; set; }يحصل أو يحدد حالة مربع الاختيار.
Color { get; set; }يحصل أو يحدد لون التعليق.
Contents { get; set; }يحصل أو يحدد نص التعليق.
Count { get; }يحصل على عدد الحقول الفرعية في هذا الحقل. (على سبيل المثال عدد العناصر في حقل زر الاختيار).
DefaultAppearance { get; set; }يحصل أو يحدد المظهر الافتراضي للحقل.
Exportable { get; set; }يحصل أو يحدد علامة تصدير الحقل.
ExportValue { get; set; }يحصل أو يحدد قيمة تصدير حقل CheckBox.
Flags { get; set; }علامات التعليق.
FullName { get; }يحصل على الاسم المؤهل بالكامل للتعليق.
virtual Height { get; set; }يحصل أو يحدد ارتفاع التعليق.
Highlighting { get; set; }وضع تمييز التعليق.
virtual Hyperlink { get; set; }يحصل أو يحدد رابط الجزء (لإنشاء PDF).
IsFirstParagraphInColumn { get; set; }يحصل أو يحدد قيمة بوليانية تشير إلى ما إذا كانت هذه الفقرة ستكون في العمود التالي. القيمة الافتراضية هي false. (لإنشاء PDF)
IsGroup { get; }يحصل أو يحدد قيمة بوليانية تشير إلى ما إذا كان هذا الحقل حقل غير نهائي أي مجموعة من الحقول.
IsInLineParagraph { get; set; }يحصل أو يحدد ما إذا كانت الفقرة في السطر. القيمة الافتراضية هي false. (لإنشاء PDF)
IsInNewPage { get; set; }يحصل أو يحدد قيمة بوليانية تجبر هذه الفقرة على التوليد في صفحة جديدة. القيمة الافتراضية هي false. (لإنشاء PDF)
IsKeptWithNext { get; set; }يحصل أو يحدد قيمة بوليانية تشير إلى ما إذا كانت الفقرة الحالية تبقى في نفس الصفحة مع الفقرة التالية. القيمة الافتراضية هي false. (لإنشاء PDF)
IsSharedField { get; set; }خاصية لدعم Generator. تُستخدم عند إضافة الحقل إلى الرأس أو التذييل. إذا كانت القيمة true، سيتم إنشاء هذا الحقل مرة واحدة وسيكون مظهره مرئيًا في جميع صفحات المستند. إذا كانت القيمة false، سيتم إنشاء حقل منفصل لكل صفحة من صفحات المستند.
IsSynchronized { get; }يُرجع true إذا كان القاموس متزامنًا.
Item { get; }يحصل على الحقل الفرعي المحتوى في هذا الحقل حسب اسم الحقل الفرعي. (2 فهرس)
MappingName { get; set; }يحصل أو يحدد اسم التعيين للحقل الذي يجب استخدامه عند تصدير بيانات حقل النموذج التفاعلي من المستند.
Margin { get; set; }يحصل أو يحدد هامش خارجي للفقرة (لإنشاء PDF)
Modified { get; set; }يحصل أو يحدد التاريخ والوقت عندما تم تعديل التعليق مؤخرًا.
Name { get; set; }يحصل أو يحدد اسم التعليق على الصفحة.
OnActivated { get; set; }إجراء يجب تنفيذه عند تنشيط التعليق.
override PageIndex { get; }يحصل على فهرس الصفحة التي تحتوي على هذا الحقل.
Parent { get; }يحصل على والد التعليق.
PartialName { get; set; }يحصل أو يحدد الاسم الجزئي للحقل.
ReadOnly { get; set; }يحصل أو يحدد حالة القراءة فقط للحقل.
override Rect { get; set; }يحصل أو يحدد مستطيل الحقل.
Required { get; set; }يحصل أو يحدد حالة المتطلبات للحقل.
States { get; }يحصل على قاموس مظهر التعليق.
Style { get; set; }يحصل أو يحدد نمط مربع الاختيار.
SyncRoot { get; }كائن التزامن.
TabOrder { get; set; }يحصل أو يحدد ترتيب التبويب للحقل.
TextHorizontalAlignment { get; set; }يحصل أو يحدد محاذاة النص للتعليق.
override Value { get; set; }يحصل أو يحدد قيمة حقل مربع الاختيار.
virtual VerticalAlignment { get; set; }يحصل أو يحدد محاذاة عمودية للفقرة
virtual Width { get; set; }يحصل أو يحدد عرض التعليق.
ZIndex { get; set; }يحصل أو يحدد قيمة int تشير إلى ترتيب Z للرسم. سيتم وضع رسم ذو ZIndex أكبر فوق الرسم ذو ZIndex أصغر. يمكن أن يكون ZIndex سالبًا. سيتم وضع الرسم ذو ZIndex سالب خلف النص في الصفحة.

Methods

NameDescription
override Accept(AnnotationSelector)يقبل الزائر.
AddOption(string)يضيف مربع اختيار جديد إلى مجموعة مربعات الاختيار، حيث يمكن أن يكون واحد فقط من مربعات الاختيار محددًا في أي وقت. يتم إضافة مربع الاختيار الجديد إلى أسفل المجموعة.
AddOption(string, Rectangle)يضيف مربع اختيار جديد إلى مجموعة مربعات الاختيار، حيث يمكن أن يكون واحد فقط من مربعات الاختيار محددًا في أي وقت.
AddOption(string, int, Rectangle)يضيف مربع اختيار جديد إلى مجموعة مربعات الاختيار، حيث يمكن أن يكون واحد فقط من مربعات الاختيار محددًا في أي وقت.
virtual ChangeAfterResize(Matrix)تحديث المعلمات والمظهر، وفقًا لتحويل المصفوفة.
override Clone()استنساخ مربع الاختيار.
CopyTo(WidgetAnnotation[], int)ينسخ الحقول الفرعية لهذا الحقل إلى مصفوفة بدءًا من الفهرس المحدد.
ExecuteFieldJavaScript(JavascriptAction)ينفذ إجراء JavaScript المحدد للحقل.
ExportToJson(Stream, ExportFieldsToJsonOptions)يصدر حقل النموذج PDF المحدد إلى تنسيق JSON ويكتب النتيجة إلى التدفق المقدم.
ExportToJson(string, ExportFieldsToJsonOptions)يصدر حقل النموذج PDF المحدد إلى تنسيق JSON ويكتب النتيجة إلى الملف المحدد.
ExportValueToJson(Stream, bool)يصدر محتوى الحقل المحدد إلى تدفق JSON. لا يتم تصدير قيمة حقل الزر.
override Flatten()يزيل هذا الحقل ويضع قيمته مباشرة على الصفحة.
GetCheckedStateName()يُرجع اسم حالة “محدد” وفقًا لأسماء الحالات الموجودة.
GetEnumerator()يُرجع عداد الحقول المحتواة.
GetRectangle(bool)يُرجع مستطيل التعليق مع الأخذ في الاعتبار دوران الصفحة.
ImportValueFromJson(Stream)يستورد البيانات إلى الحقول المحددة من تدفق JSON، بناءً على تطابق دقيق لأسماء الحقول الكاملة.
ImportValueFromJson(Stream, string)يستورد البيانات إلى الحقل المحدد من تدفق JSON، باستخدام الاسم الكامل المحدد في متغير ‘fieldFullNameInJSON’ للمطابقة.
Recalculate()يعيد حساب جميع الحقول المحسوبة على النموذج.
virtual SetPosition(Point)تعيين موضع الحقل.

Examples

المثال يوضح كيفية إنشاء حقل مربع اختيار متعدد القيم.

using (var document = new Document())
{
var page = document.Pages.Add();

var checkbox = new CheckboxField(page, new Rectangle(50, 50, 70, 70));

// Set the first checkbox group option value
checkbox.ExportValue = "option 1";

// Add new option right under existing ones
checkbox.AddOption("option 2");

// Add new option at the given rectangle
checkbox.AddOption("option 3", new Rectangle(100, 100, 120, 120));

document.Form.Add(checkbox);

// Select the added checkbox
checkbox.Value = "option 2";
document.Save("checkbox_group.pdf");
}

See Also