FieldSectionPages
محتويات
[
يخفي
]FieldSectionPages class
ينفذ حقل SECTIONPAGES.
لمعرفة المزيد، قم بزيارةالعمل مع الحقول مقالة توثيقية.
public class FieldSectionPages : Field
المنشئون
| اسم | وصف |
|---|---|
| FieldSectionPages() | Default_Constructor |
الخصائص
| اسم | وصف |
|---|---|
| DisplayResult { get; } | الحصول على النص الذي يمثل نتيجة الحقل المعروض. |
| End { get; } | يحصل على العقدة التي تمثل نهاية الحقل. |
| Format { get; } | يحصل علىFieldFormat الكائن الذي يوفر الوصول المكتوب إلى تنسيق الحقل. |
| IsDirty { get; set; } | الحصول على أو تعيين ما إذا كانت النتيجة الحالية للحقل لم تعد صحيحة (قديمة) بسبب تعديلات أخرى تم إجراؤها على المستند. |
| IsLocked { get; set; } | الحصول على أو تعيين ما إذا كان الحقل مقفلاً (لا ينبغي إعادة حساب النتيجة). |
| LocaleId { get; set; } | الحصول على أو تعيين LCID الخاص بالحقل. |
| Result { get; set; } | الحصول على أو تعيين النص الموجود بين فاصل الحقل ونهاية الحقل. |
| Separator { get; } | يحصل على العقدة التي تمثل فاصل الحقول. يمكن ان يكونباطل . |
| Start { get; } | يحصل على العقدة التي تمثل بداية الحقل. |
| virtual Type { get; } | الحصول على نوع حقل Microsoft Word. |
طُرق
| اسم | وصف |
|---|---|
| GetFieldCode() | إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). يتم تضمين كل من رمز الحقل ونتيجة الحقل للحقول الفرعية. |
| GetFieldCode(bool) | إرجاع النص بين بداية الحقل وفاصل الحقل (أو نهاية الحقل إذا لم يكن هناك فاصل). |
| Remove() | إزالة الحقل من المستند. إرجاع عقدة مباشرة بعد الحقل. إذا كانت نهاية الحقل هي الطفل الأخير للعقدة الأصلية، فسيتم إرجاع الفقرة الأصلية الخاصة به. إذا تمت إزالة الحقل بالفعل، فسيتم إرجاعهباطل . |
| Unlink() | يقوم بإلغاء ربط الحقل. |
| Update() | يقوم بإجراء التحديث الميداني. يتم الرمي إذا تم تحديث الحقل بالفعل. |
| Update(bool) | إجراء تحديث ميداني. يتم الرمي إذا تم تحديث الحقل بالفعل. |
ملاحظات
استرجاع رقم الصفحة الحالية ضمن القسم الحالي.
أمثلة
يوضح كيفية استخدام حقلي SECTION وSECTIONPAGES لترقيم الصفحات حسب الأقسام.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.MoveToHeaderFooter(HeaderFooterType.HeaderPrimary);
builder.ParagraphFormat.Alignment = ParagraphAlignment.Right;
// يعرض حقل القسم رقم القسم الموجود فيه.
builder.Write("Section ");
FieldSection fieldSection = (FieldSection)builder.InsertField(FieldType.FieldSection, true);
Assert.AreEqual(" SECTION ", fieldSection.GetFieldCode());
// يعرض حقل الصفحة رقم الصفحة الموجودة فيه.
builder.Write("\nPage ");
FieldPage fieldPage = (FieldPage)builder.InsertField(FieldType.FieldPage, true);
Assert.AreEqual(" PAGE ", fieldPage.GetFieldCode());
// يعرض حقل SECTIONPAGES عدد الصفحات التي يمتد عبرها القسم.
builder.Write(" of ");
FieldSectionPages fieldSectionPages = (FieldSectionPages)builder.InsertField(FieldType.FieldSectionPages, true);
Assert.AreEqual(" SECTIONPAGES ", fieldSectionPages.GetFieldCode());
// انقل الرأس مرة أخرى إلى المستند الرئيسي وأدخل صفحتين.
// كل هذه الصفحات ستكون في القسم الأول. حقولنا، التي تظهر مرة واحدة في كل رأس،
// سيتم ترقيم الصفحات الحالية/الإجمالية لهذا القسم.
builder.MoveToDocumentEnd();
builder.InsertBreak(BreakType.PageBreak);
builder.InsertBreak(BreakType.PageBreak);
// يمكننا إدراج قسم جديد في أداة إنشاء المستندات بهذا الشكل.
// سيؤثر هذا على القيم المعروضة في حقلي القسم وصفحات الأقسام في جميع الرؤوس القادمة.
builder.InsertBreak(BreakType.SectionBreakNewPage);
// سيستمر حقل PAGE في حساب الصفحات عبر المستند بأكمله.
// يمكننا إعادة تعيين عددها يدويًا في كل قسم لتتبع الصفحات قسمًا تلو الآخر.
builder.CurrentSection.PageSetup.RestartPageNumbering = true;
builder.InsertBreak(BreakType.PageBreak);
doc.UpdateFields();
doc.Save(ArtifactsDir + "Field.SECTION.SECTIONPAGES.docx");
أنظر أيضا
- class Field
- مساحة الاسم Aspose.Words.Fields
- المجسم Aspose.Words
