HeaderFooterCollection

HeaderFooterCollection class

يوفر الوصول المكتوب إلىHeaderFooter عقدة منSection .

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

public class HeaderFooterCollection : NodeCollection

الخصائص

اسموصف
Count { get; }يحصل على عدد العقد في المجموعة.
Item { get; }يسترجعHeaderFooter عند الفهرس المعطى. (3 indexers)

طُرق

اسموصف
Add(Node)يضيف عقدة إلى نهاية المجموعة.
Clear()يزيل جميع العقد من هذه المجموعة ومن المستند.
Contains(Node)يحدد ما إذا كانت العقدة موجودة في المجموعة.
GetEnumerator()يوفر تكرارًا بسيطًا بأسلوب “foreach” عبر مجموعة العقد.
IndexOf(Node)يعيد الفهرس المبني على الصفر للعقدة المحددة.
Insert(int, Node)يقوم بإدراج عقدة في المجموعة عند الفهرس المحدد.
LinkToPrevious(bool)يربط أو يلغي ربط جميع الرؤوس والتذييلات بالرؤوس والتذييلات المقابلة لها في القسم السابق.
LinkToPrevious(HeaderFooterType, bool)يربط أو يلغي ربط الرأس أو التذييل المحدد بالرأس أو التذييل المقابل في القسم السابق.
Remove(Node)يزيل العقدة من المجموعة ومن المستند.
RemoveAt(int)يزيل العقدة الموجودة في الفهرس المحدد من المجموعة ومن المستند.
ToArray()نسخ الكلرأس وتذييل من المجموعة إلى مجموعة جديدة منرأس وتذييل س. (2 methods)

ملاحظات

يمكن أن يكون هناك حد أقصى واحدHeaderFooter

من كل واحدHeaderFooterType لكل x000d_Section .

HeaderFooter يمكن أن تظهر الكائنات بأي ترتيب في المجموعة.

أمثلة

يوضح كيفية حذف كافة التذييلات من المستند.

Document doc = new Document(MyDir + "Header and footer types.docx");

// قم بالتكرار خلال كل قسم وإزالة التذييلات من كل نوع.
foreach (Section section in doc.OfType<Section>())
{
    // هناك ثلاثة أنواع من أنواع التذييل والرأس.
    // 1 - "الرأس/التذييل الأول"، والذي يظهر فقط في الصفحة الأولى من القسم.
    HeaderFooter footer = section.HeadersFooters[HeaderFooterType.FooterFirst];
    footer?.Remove();

    // 2 - الرأس/التذييل "الأساسي"، والذي يظهر في الصفحات الفردية.
    footer = section.HeadersFooters[HeaderFooterType.FooterPrimary];
    footer?.Remove();

     // 3 - رأس/تذييل "الزوجي"، والذي يظهر في الصفحات الزوجية.
    footer = section.HeadersFooters[HeaderFooterType.FooterEven];
    footer?.Remove();

    Assert.AreEqual(0, section.HeadersFooters.Count(hf => !((HeaderFooter)hf).IsHeader));
}

doc.Save(ArtifactsDir + "HeaderFooter.RemoveFooters.docx");

يوضح كيفية إنشاء رأس وتذييل.

Document doc = new Document();

// أنشئ رأسًا وأضف إليه فقرة. النص في تلك الفقرة
// سوف تظهر في أعلى كل صفحة من هذا القسم، فوق النص الرئيسي.
HeaderFooter header = new HeaderFooter(doc, HeaderFooterType.HeaderPrimary);
doc.FirstSection.HeadersFooters.Add(header);

Paragraph para = header.AppendParagraph("My header.");

Assert.True(header.IsHeader);
Assert.True(para.IsEndOfHeaderFooter);

// أنشئ تذييلًا وأضف إليه فقرة. النص في تلك الفقرة
// سوف تظهر في أسفل كل صفحة من هذا القسم، أسفل النص الرئيسي.
HeaderFooter footer = new HeaderFooter(doc, HeaderFooterType.FooterPrimary);
doc.FirstSection.HeadersFooters.Add(footer);

para = footer.AppendParagraph("My footer.");

Assert.False(footer.IsHeader);
Assert.True(para.IsEndOfHeaderFooter);

Assert.AreEqual(footer, para.ParentStory);
Assert.AreEqual(footer.ParentSection, para.ParentSection);
Assert.AreEqual(footer.ParentSection, header.ParentSection);

doc.Save(ArtifactsDir + "HeaderFooter.Create.docx");

أنظر أيضا

HeaderFooter Class HeaderFooterType Enum