FieldAutoNum

FieldAutoNum class

ينفذ حقل AUTONUM.

لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.

public class FieldAutoNum : Field

المنشئون

اسموصف
FieldAutoNum()Default_Constructor

الخصائص

اسموصف
DisplayResult { get; }يحصل على النص الذي يمثل نتيجة الحقل المعروضة.
End { get; }يحصل على العقدة التي تمثل نهاية الحقل.
Format { get; }يحصل علىFieldFormatالكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل.
IsDirty { get; set; }يحصل على أو يحدد ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب التعديلات الأخرى التي تم إجراؤها على المستند.
IsLocked { get; set; }يحصل على أو يحدد ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب نتيجته).
LocaleId { get; set; }يحصل على أو يعين LCID للحقل.
Result { get; set; }يحصل على النص الموجود بين فاصل الحقل ونهاية الحقل أو يعينه.
Separator { get; }يحصل على العقدة التي تمثل فاصل الحقل. يمكن أن يكونباطل .
SeparatorCharacter { get; set; }يحصل على حرف الفاصل الذي سيتم استخدامه أو يعينه.
Start { get; }يحصل على العقدة التي تمثل بداية الحقل.
virtual Type { get; }يحصل على نوع حقل Microsoft Word.

طُرق

اسموصف
GetFieldCode()يعيد النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية.
GetFieldCode(bool)إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل).
Remove()يُزيل الحقل من المستند. يُرجع عقدة بعد الحقل مباشرةً. إذا كانت نهاية الحقل هي آخر عقدة فرعية للعقدة الأصلية، تُرجع فقرته الأصلية. إذا كان الحقل قد حُذف مُسبقًا، تُرجعباطل .
Unlink()يقوم بإلغاء ربط الحقل.
Update()يُجري تحديث الحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل.
Update(bool)يُجري تحديثًا للحقل. يُطرح هذا الخطأ إذا كان الحقل قيد التحديث بالفعل.

ملاحظات

يقوم بإدراج رقم تلقائي.

أمثلة

يوضح كيفية ترقيم الفقرات باستخدام حقول الترقيم التلقائي.

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

// يعرض كل حقل AUTONUM القيمة الحالية لعدد تشغيلي لحقول AUTONUM،
// مما يسمح لنا بترقيم العناصر تلقائيًا مثل القائمة المرقمة.
//سيعرض هذا الحقل الرقم "1".
FieldAutoNum field = (FieldAutoNum)builder.InsertField(FieldType.FieldAutoNum, true);
builder.Writeln("\tParagraph 1.");

Assert.AreEqual(" AUTONUM ", field.GetFieldCode());

field = (FieldAutoNum)builder.InsertField(FieldType.FieldAutoNum, true);
builder.Writeln("\tParagraph 2.");

// حرف الفاصل، الذي يظهر في نتيجة الحقل مباشرة بعد الرقم، هو نقطة افتراضيًا.
// إذا تركنا هذه الخاصية فارغة، فسوف يعرض حقل AUTONUM الثاني الرقم "2." في المستند.
Assert.IsNull(field.SeparatorCharacter);

// يمكننا تعيين هذه الخاصية لتطبيق الحرف الأول من السلسلة كحرف فاصل جديد.
// في هذه الحالة، سيعرض حقل AUTONUM الخاص بنا الآن "2:".
field.SeparatorCharacter = ":";

Assert.AreEqual(" AUTONUM  \\s :", field.GetFieldCode());

doc.Save(ArtifactsDir + "Field.AUTONUM.docx");

أنظر أيضا