Section.DifferentFirstPage Property

Gets or sets whether the header and footer areas of the first page can be different from other pages in the section.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v18.2.Core.dll

Declaration

C#

bool DifferentFirstPage { get; set; }

VB.NET

Property DifferentFirstPage As Boolean

Property Value

Type	Description
Boolean	true to enable different settings for the first page; otherwise, false.

Remarks

Set the DifferentFirstPage property to true to display the header/footer of the HeaderFooterType.First type on the first page of the section. Otherwise, the first page will display the same header/footer as other pages, or the HeaderFooterType.Odd type header/footer if the Document.DifferentOddAndEvenPages property is true.

You can also use the ToggleDifferentFirstPageCommand command to enable/disable different first page.

Example

The following code snippet opens the first section’s header for editing. The header type is HeaderFooterType.First, so it is displayed for the first page only if the corresponding mode is enabled (use the Section.DifferentFirstPage property). Then, the text string and a PAGE field are inserted and the Section.EndUpdateHeader method is called to finalize the modification.

Note

A complete sample project is available at https://github.com/DevExpress-Examples/winforms-richedit-document-api-e5219

HeaderAndFooter.vb

document.AppendSection()
Dim firstSection As Section = document.Sections(0)
' Modify the header of the HeaderFooterType.First type.
Dim myHeader As SubDocument = firstSection.BeginUpdateHeader(HeaderFooterType.First)
Dim range As DocumentRange = myHeader.InsertText(myHeader.CreatePosition(0), " PAGE NUMBER ")
Dim fld As Field = myHeader.Fields.Create(range.End, "PAGE \* ARABICDASH")
myHeader.Fields.Update()
firstSection.EndUpdateHeader(myHeader)
' Display the header of the HeaderFooterType.First type on the first page.
firstSection.DifferentFirstPage = True

HeaderAndFooter.cs

document.AppendSection();
Section firstSection = document.Sections[0];
// Modify the header of the HeaderFooterType.First type.
SubDocument myHeader = firstSection.BeginUpdateHeader(HeaderFooterType.First);
DocumentRange range = myHeader.InsertText(myHeader.CreatePosition(0), " PAGE NUMBER ");
Field fld = myHeader.Fields.Create(range.End, "PAGE \\* ARABICDASH");
myHeader.Fields.Update();
firstSection.EndUpdateHeader(myHeader);
// Display the header of the HeaderFooterType.First type on the first page.
firstSection.DifferentFirstPage = true;

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the DifferentFirstPage property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

winforms-richedit-document-api-e5219/CS/RichEditAPISample/CodeExamples/HeaderAndFooter.cs#L43

// Display the header of the HeaderFooterType.First type on the first page.
firstSection.DifferentFirstPage = true;
#endregion #ModifyHeader

subdocument-essentials-simple-examples-e2265/CS/SubDocumentExample/Form1.cs#L44

richEditControl1.Document.Sections[0].EndUpdateHeader(doc);
richEditControl1.Document.Sections[0].DifferentFirstPage = true;
#endregion #EditHeader

wpf-richedit-document-api-t213968/CS/DXRichEditControlAPISample/CodeExamples/HeaderAndFooterActions.cs#L41

// Display the header of the HeaderFooterType.First type on the first page.
firstSection.DifferentFirstPage = true;
#endregion #ModifyHeader

word-document-api-examples/CS/CodeExamples/HeaderAndFooterActions.cs#L42

// Display the header of the HeaderFooterType.First type on the first page.
firstSection.DifferentFirstPage = true;
#endregion #ModifyHeader

VB.NET

winforms-richedit-document-api-e5219/VB/RichEditAPISample/CodeExamples/HeaderAndFooter.vb#L38

            ' Display the header of the HeaderFooterType.First type on the first page.
            firstSection.DifferentFirstPage = True
'            #End Region ' #ModifyHeader

subdocument-essentials-simple-examples-e2265/VB/SubDocumentExample/Form1.vb#L41

            richEditControl1.Document.Sections(0).EndUpdateHeader(doc)
            richEditControl1.Document.Sections(0).DifferentFirstPage = True
'            #End Region ' #EditHeader

wpf-richedit-document-api-t213968/VB/DXRichEditControlAPISample/CodeExamples/HeaderAndFooterActions.vb#L36

            ' Display the header of the HeaderFooterType.First type on the first page.
            firstSection.DifferentFirstPage = True
'            #End Region ' #ModifyHeader

word-document-api-examples/VB/CodeExamples/HeaderAndFooterActions.vb#L37

            ' Display the header of the HeaderFooterType.First type on the first page.
            firstSection.DifferentFirstPage = True
'            #End Region ' #ModifyHeader