ClassSection
Container for block-level content with page layout settings including size, orientation, margins, headers, and footers, defining how content flows across pages.
Definition
Namespace:Telerik.Windows.Documents.Flow.Model
Assembly:Telerik.Windows.Documents.Flow.dll
Syntax:
public sealed class Section : BlockContainerBase, IElementWithPropertiesInheritance: objectDocumentElementBaseBlockContainerBaseSection
Implements:
Inherited Members
Constructors
Section(RadFlowDocument)
Initializes a new Section with default page layout settings and empty block, header, and footer collections in the specified document.
Declaration
public Section(RadFlowDocument document)Parameters
document
The document in which the element will be added.
Fields
ChapterHeadingStyleIndexPropertyDefinition
Style property definition for the heading level (1-9) used to extract chapter numbers for page numbering.
Declaration
public static readonly StylePropertyDefinition<int?> ChapterHeadingStyleIndexPropertyDefinitionField Value
ChapterSeparatorCharacterPropertyDefinition
Style property definition for the character separating chapter numbers from page numbers in page numbering fields.
Declaration
public static readonly StylePropertyDefinition<ChapterSeparatorType?> ChapterSeparatorCharacterPropertyDefinitionField Value
FooterBottomMarginPropertyDefinition
Style property definition for the distance from the bottom page edge to the start of footer content in device independent pixels (1/96 inch).
Declaration
public static readonly StylePropertyDefinition<double?> FooterBottomMarginPropertyDefinitionField Value
HasDifferentFirstPageHeaderFooterPropertyDefinition
Style property definition for controlling whether the first page displays different headers and footers from subsequent pages.
Declaration
public static readonly StylePropertyDefinition<bool?> HasDifferentFirstPageHeaderFooterPropertyDefinitionField Value
HeaderTopMarginPropertyDefinition
Style property definition for the distance from the top page edge to the start of header content in device independent pixels (1/96 inch).
Declaration
public static readonly StylePropertyDefinition<double?> HeaderTopMarginPropertyDefinitionField Value
PageMarginsPropertyDefinition
Style property definition for page margins, defining the distance between page edges and the content area.
Declaration
public static readonly StylePropertyDefinition<Padding> PageMarginsPropertyDefinitionField Value
PageNumberFormatPropertyDefinition
Style property definition for the numbering format applied to page numbers (decimal, Roman numerals, letters, etc.).
Declaration
public static readonly StylePropertyDefinition<NumberingStyle?> PageNumberFormatPropertyDefinitionField Value
PageOrientationPropertyDefinition
Style property definition for page orientation, controlling portrait or landscape layout.
Declaration
public static readonly StylePropertyDefinition<PageOrientation?> PageOrientationPropertyDefinitionField Value
PageSizePropertyDefinition
Style property definition for physical page dimensions in device independent pixels (1/96 inch).
Declaration
public static readonly StylePropertyDefinition<Size?> PageSizePropertyDefinitionField Value
SectionTypePropertyDefinition
Style property definition for section break type, controlling how the section begins relative to the previous section.
Declaration
public static readonly StylePropertyDefinition<SectionType?> SectionTypePropertyDefinitionField Value
StartingPageNumberPropertyDefinition
Style property definition for the initial page number assigned to the first page of this section.
Declaration
public static readonly StylePropertyDefinition<int?> StartingPageNumberPropertyDefinitionField Value
VerticalAlignmentPropertyDefinition
Style property definition for vertical alignment of content within the page height.
Declaration
public static readonly StylePropertyDefinition<VerticalAlignment> VerticalAlignmentPropertyDefinitionField Value
Properties
FooterBottomMargin
Distance from the bottom edge of the page to the start of footer content in device independent pixels (1/96 inch).
Declaration
public double FooterBottomMargin { get; set; }Property Value
The footer bottom margin.
Footers
Footer instances for this section, providing default, first-page, and even-page footers that appear at the bottom of pages.
HasDifferentFirstPageHeaderFooter
Controls whether the first page of this section displays a different header and footer from subsequent pages.
Declaration
public bool HasDifferentFirstPageHeaderFooter { get; set; }Property Value
The default value is false.
HeaderTopMargin
Distance from the top edge of the page to the start of header content in device independent pixels (1/96 inch).
Declaration
public double HeaderTopMargin { get; set; }Property Value
The header top margin.
Headers
Header instances for this section, providing default, first-page, and even-page headers that appear at the top of pages.
PageMargins
Margins defining the distance between page edges and the content area, specified in device independent pixels (1/96 inch).
Declaration
public Padding PageMargins { get; set; }Property Value
The page margins.
PageNumberingSettings
Page numbering configuration for this section, controlling the starting number, format, and chapter heading association.
Declaration
public PageNumberingSettings PageNumberingSettings { get; }Property Value
The page numbering settings.
PageOrientation
Page orientation for this section, controlling whether pages are portrait or landscape; use Rotate() to change orientation with automatic margin adjustment.
Declaration
public PageOrientation PageOrientation { get; set; }Property Value
The page orientation.
PageSize
Physical page dimensions in device independent pixels (1/96 inch); use ToSize(PaperTypes) for standard paper sizes like A4 or Letter.
Declaration
public Size PageSize { get; set; }Property Value
The size of the page.
Remarks
For setting common page sizes ToSize(PaperTypes) method can be used.
Properties
Page layout and section properties, providing access to page size, orientation, margins, headers/footers margins, and section type settings.
Declaration
public SectionProperties Properties { get; }Property Value
The properties.
SectionType
Section break type controlling how this section begins relative to the previous section (continuous, new page, even page, or odd page).
Declaration
public SectionType SectionType { get; set; }Property Value
The type of the section.
VerticalAlignment
Vertical alignment of content within the page, controlling whether content is aligned to the top, center, bottom, or justified across the page height.
Declaration
public VerticalAlignment VerticalAlignment { get; set; }Property Value
The vertical alignment.
Methods
Clone()
Creates a deep copy of this section including all blocks, headers, footers, and layout properties, associated to the same document.
Clone(RadFlowDocument)
Creates a deep copy of this section including all blocks, headers, footers, and layout properties, associated to the specified document for cross-document copying.
Declaration
public Section Clone(RadFlowDocument document)Parameters
document
The document to which the cloned element should be associated.
Returns
The cloned element.
Rotate(PageOrientation)
Changes the page orientation to the specified value and automatically adjusts page size and margins to maintain consistent layout.
Declaration
public void Rotate(PageOrientation orientation)Parameters
orientation
The page orientation.