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