skip navigation
  • Product Bundles

    DevCraft

    All Telerik .NET tools and Kendo UI JavaScript components in one package. Now enhanced with:

    • NEW: Design Kits for Figma
    • Online Training
    • Document Processing Library
    • Embedded Reporting for web and desktop
    Web
    Kendo UI UI for jQuery UI for Angular UI for React UI for Vue UI for ASP.NET AJAX UI for ASP.NET MVC UI for ASP.NET Core UI for Blazor UI for Silverlight UI for PHP UI for JSP
    Mobile
    UI for .NET MAUI UI for Xamarin
    Document Management
    Telerik Document Processing
    Desktop
    UI for .NET MAUI UI for WinUI UI for WinForms UI for WPF UI for UWP
    Reporting & Mocking
    Telerik Reporting Telerik Report Server Telerik JustMock
    Automated Testing
    Test Studio Test Studio Dev Edition
    CMS
    Sitefinity
    UI/UX Tools
    ThemeBuilder
    Debugging
    Fiddler Fiddler Everywhere Fiddler Classic Fiddler Jam FiddlerCap FiddlerCore
    Extended Reality
    UI for Unity XR
    Free Tools
    JustAssembly JustDecompile VB.NET to C# Converter Testing Framework
    View all products
  • Overview
  • Demos
    • What's New
    • Release History
  • Docs & Support
  • Pricing
  • Search
  • Shopping cart
    • Account Overview
    • Your Licenses
    • Support Center
    • Forum Profile
    • Payment Methods
    • Edit Profile
    • Log out
  • Login
  • Contact Us
  • Try now

Class Section

A block-level flow content element used for grouping other Block elements.

Inheritance
System.Object
DocumentElement
Block
BlockContainerBase
Section
Inherited Members
BlockContainerBase.Blocks
DocumentElement.GetStyleProperty(IStylePropertyDefinition)
DocumentElement.GetStyleProperty(String)
DocumentElement.EnumerateChildrenOfType<T>()
DocumentElement.GetParentOfType<T>()
DocumentElement.CreateLayoutBox()
DocumentElement.CopyPropertiesFrom(DocumentElement)
DocumentElement.CopyPropertiesFromStyle(StyleDefinition)
DocumentElement.ExtractStyleFromProperties()
DocumentElement.ExtractStyleFromLocalProperties()
DocumentElement.InvalidateAssociatedBoxesArrange()
DocumentElement.InvalidateAssociatedBoxesMeasure()
DocumentElement.InvalidateAssociatedBoxesLayout()
DocumentElement.GetAssociatedLayoutBoxes()
DocumentElement.GetRootDocument()
DocumentElement.CreateDeepCopy()
DocumentElement.CreateShallowCopy()
DocumentElement.GetPropertyValueSource(IStylePropertyDefinition)
DocumentElement.ClearValue(IStylePropertyDefinition)
DocumentElement.OnRemoved()
DocumentElement.OnStyleChanging()
DocumentElement.OnStyleChanged()
DocumentElement.add_StylePropertyChanged(StylePropertyChangeEventHandler)
DocumentElement.remove_StylePropertyChanged(StylePropertyChangeEventHandler)
DocumentElement.OnStylePropertyChanged(StylePropertyChangeEventArgs)
DocumentElement.OnParentChanging()
DocumentElement.add_PropertyValueChanged(StylePropertyChangeEventHandler)
DocumentElement.remove_PropertyValueChanged(StylePropertyChangeEventHandler)
DocumentElement.ChildIndex
DocumentElement.HasStyle
DocumentElement.Style
DocumentElement.StyleName
DocumentElement.Tag
DocumentElement.DefaultStyleSettings
DocumentElement.FirstLayoutBox
DocumentElement.LastLayoutBox
DocumentElement.IsFirstLayoutBoxInitialized
DocumentElement.DocumentElements
DocumentElement.Parent
DocumentElement.Children
DocumentElement.PreviousSibling
DocumentElement.NextSibling
DocumentElement.Cursor
DocumentElement.OriginalProperties
DocumentElement.RevisionInfo
DocumentElement.StyleChanging
DocumentElement.StyleChanged
DocumentElement.StylePropertyChanged
DocumentElement.ParentChanging
DocumentElement.ParentChanged
DocumentElement.PropertyValueChanged
Namespace: Telerik.Windows.Documents.Model
Assembly: Telerik.Windows.Documents.dll

Syntax

public class Section : BlockContainerBase, IBlockContainer, IContainChildDocument

Constructors

Section()

Initializes a new instance of the Section class.

Declaration
public Section()

Section(Section)

Initializes a new instance of the Section class by copying the properties from another instance.

Declaration
public Section(Section originalSection)
Parameters
Section originalSection

The original section.

Fields

ColumnsProperty

Declaration
public static readonly StylePropertyDefinition<SectionColumnCollection, SectionProperties> ColumnsProperty
Field Value
StylePropertyDefinition<SectionColumnCollection, SectionProperties>

EndnotesFirstNumberProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<int>, SectionProperties> EndnotesFirstNumberProperty
Field Value
StylePropertyDefinition<System.Nullable<System.Int32>, SectionProperties>

EndnotesNumberingFormatProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<ListNumberingFormat>, SectionProperties> EndnotesNumberingFormatProperty
Field Value
StylePropertyDefinition<System.Nullable<ListNumberingFormat>, SectionProperties>

EndnotesNumberingRestartTypeProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<NumberingRestartType>, SectionProperties> EndnotesNumberingRestartTypeProperty
Field Value
StylePropertyDefinition<System.Nullable<NumberingRestartType>, SectionProperties>

FooterBottomMarginProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<int>, SectionProperties> FooterBottomMarginProperty
Field Value
StylePropertyDefinition<System.Nullable<System.Int32>, SectionProperties>

FootnotesFirstNumberProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<int>, SectionProperties> FootnotesFirstNumberProperty
Field Value
StylePropertyDefinition<System.Nullable<System.Int32>, SectionProperties>

FootnotesNumberingFormatProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<ListNumberingFormat>, SectionProperties> FootnotesNumberingFormatProperty
Field Value
StylePropertyDefinition<System.Nullable<ListNumberingFormat>, SectionProperties>

FootnotesNumberingRestartTypeProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<NumberingRestartType>, SectionProperties> FootnotesNumberingRestartTypeProperty
Field Value
StylePropertyDefinition<System.Nullable<NumberingRestartType>, SectionProperties>

HasDifferentFirstPageHeaderFooterProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<bool>, SectionProperties> HasDifferentFirstPageHeaderFooterProperty
Field Value
StylePropertyDefinition<System.Nullable<System.Boolean>, SectionProperties>

HeaderTopMarginProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<int>, SectionProperties> HeaderTopMarginProperty
Field Value
StylePropertyDefinition<System.Nullable<System.Int32>, SectionProperties>

PageMarginProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<Padding>, SectionProperties> PageMarginProperty
Field Value
StylePropertyDefinition<System.Nullable<Padding>, SectionProperties>

PageOrientationProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<PageOrientation>, SectionProperties> PageOrientationProperty
Field Value
StylePropertyDefinition<System.Nullable<Telerik.Windows.Documents.Model.PageOrientation>, SectionProperties>

PageSizeProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<Size>, SectionProperties> PageSizeProperty
Field Value
StylePropertyDefinition<System.Nullable<System.Windows.Size>, SectionProperties>

PreviousSectionBreakTypeProperty

Declaration
public static readonly StylePropertyDefinition<Nullable<SectionBreakType>, SectionProperties> PreviousSectionBreakTypeProperty
Field Value
StylePropertyDefinition<System.Nullable<SectionBreakType>, SectionProperties>

Properties

ActualPageMargin

Declaration
public Padding ActualPageMargin { get; set; }
Property Value
Padding

Columns

Gets or sets the text columns in the Section.

Declaration
public SectionColumnCollection Columns { get; set; }
Property Value
SectionColumnCollection

The section columns.

ColumnsSerializationData

This property supports XAML serialization infrastructure and is not intended to be used directly from your code.

Declaration
[XamlCompositePropertySerializable]
public SectionColumnCollectionSerializationData ColumnsSerializationData { get; set; }
Property Value
SectionColumnCollectionSerializationData

EndnotesFirstNumber

Gets or sets the endnotes starting number.

Declaration
[XamlSerializable(1)]
public int EndnotesFirstNumber { get; set; }
Property Value
System.Int32

EndnotesNumberingFormat

Gets or sets the endnotes numbering format.

Declaration
[XamlSerializable]
public ListNumberingFormat EndnotesNumberingFormat { get; set; }
Property Value
ListNumberingFormat

EndnotesNumberingRestartType

Gets or sets the type of the endnotes numbering restart.

Declaration
[XamlSerializable]
public NumberingRestartType EndnotesNumberingRestartType { get; set; }
Property Value
NumberingRestartType

FirstPageNumber

Gets or sets the page number that appears on the first page of the section.

Declaration
[XamlSerializable(null)]
public Nullable<int> FirstPageNumber { get; set; }
Property Value
System.Nullable<System.Int32>

The page number.

FooterBottomMargin

Gets or sets the footer bottom margin.

Declaration
[XamlSerializable(48)]
public int FooterBottomMargin { get; set; }
Property Value
System.Int32

The footer bottom margin.

Footers

Gets or sets the footers.

Declaration
[XamlCompositePropertySerializable]
public Footers Footers { get; set; }
Property Value
Footers

The footers.

FootnotesFirstNumber

Gets or sets the footnotes starting number.

Declaration
[XamlSerializable(1)]
public int FootnotesFirstNumber { get; set; }
Property Value
System.Int32

FootnotesNumberingFormat

Gets or sets the footnotes numbering format.

Declaration
[XamlSerializable]
public ListNumberingFormat FootnotesNumberingFormat { get; set; }
Property Value
ListNumberingFormat

FootnotesNumberingRestartType

Gets or sets the type of the footnotes numbering restart.

Declaration
[XamlSerializable]
public NumberingRestartType FootnotesNumberingRestartType { get; set; }
Property Value
NumberingRestartType

HasDifferentFirstPageHeaderFooter

Gets or sets a value indicating whether first page header/footer is different.

Declaration
[XamlSerializable(false)]
public bool HasDifferentFirstPageHeaderFooter { get; set; }
Property Value
System.Boolean

true if first page header/footer is different; otherwise, false.

Headers

Gets or sets the headers.

Declaration
[XamlCompositePropertySerializable]
public Headers Headers { get; set; }
Property Value
Headers

The headers.

HeaderTopMargin

Gets or sets the header top margin.

Declaration
[XamlSerializable(48)]
public int HeaderTopMargin { get; set; }
Property Value
System.Int32

The header top margin.

IsEmpty

Gets a value indicating whether the section is empty.

Declaration
public bool IsEmpty { get; }
Property Value
System.Boolean

true if the section is empty; otherwise, false.

Number

Gets the section number (starting from 1).

Declaration
public int Number { get; }
Property Value
System.Int32

PageMargin

Declaration
[XamlSerializable]
public Padding PageMargin { get; set; }
Property Value
Padding

PageOrientation

Declaration
[XamlSerializable]
public PageOrientation PageOrientation { get; set; }
Property Value
Telerik.Windows.Documents.Model.PageOrientation

PageSize

Declaration
[XamlSerializable]
public Size PageSize { get; set; }
Property Value
System.Windows.Size

PreviousSectionBreakType

Declaration
[XamlSerializable]
public SectionBreakType PreviousSectionBreakType { get; set; }
Property Value
SectionBreakType

Methods

CopyPropertiesFromOverride(DocumentElement)

Copies the properties from another document element to the current instance.

Declaration
protected override void CopyPropertiesFromOverride(DocumentElement fromElement)
Parameters
DocumentElement fromElement

The Section to copy the properties from.

Overrides
DocumentElement.CopyPropertiesFromOverride(DocumentElement)

CreateLayoutBox(DocumentStructureCollection)

Creates a SectionLayoutBox for the element.

Declaration
public override LayoutBox CreateLayoutBox(DocumentStructureCollection documentCollection)
Parameters
DocumentStructureCollection documentCollection

The document collection.

Returns
LayoutBox

The new SectionLayoutBox.

Overrides
DocumentElement.CreateLayoutBox(DocumentStructureCollection)

CreateNewElementInstance()

Creates a new Section instance.

Declaration
protected override DocumentElement CreateNewElementInstance()
Returns
DocumentElement

The new instance.

Overrides
DocumentElement.CreateNewElementInstance()

GetFooterByPageNumber(Int32)

Gets the footer by page number.

Declaration
public Footer GetFooterByPageNumber(int pageNumber)
Parameters
System.Int32 pageNumber

The page number.

Returns
Footer

GetFooterByType(HeaderFooterType)

Gets the footer by its type.

Declaration
public Footer GetFooterByType(HeaderFooterType footerType)
Parameters
HeaderFooterType footerType

Type of the footer.

Returns
Footer

GetFooterHeight(Int32)

Gets the height of the footer for a page.

Declaration
public float GetFooterHeight(int pageNumber)
Parameters
System.Int32 pageNumber

The page number.

Returns
System.Single

GetHeaderByPageNumber(Int32)

Gets the header by page number.

Declaration
public Header GetHeaderByPageNumber(int pageNumber)
Parameters
System.Int32 pageNumber

The page number.

Returns
Header

GetHeaderByType(HeaderFooterType)

Gets the header by its type.

Declaration
public Header GetHeaderByType(HeaderFooterType headerType)
Parameters
HeaderFooterType headerType

Type of the header.

Returns
Header

GetHeaderFooterTypeByPageNumber(Int32)

Gets the header/footer type by page number.

Declaration
public HeaderFooterType GetHeaderFooterTypeByPageNumber(int pageNumber)
Parameters
System.Int32 pageNumber

The page number.

Returns
HeaderFooterType

GetHeaderHeight(Int32)

Gets the height of the header for a page.

Declaration
public float GetHeaderHeight(int pageNumber)
Parameters
System.Int32 pageNumber

The page number.

Returns
System.Single

IsFooterLinkedToPrevious(HeaderFooterType)

Determines whether a footer is linked to the previous section footer.

Declaration
public bool IsFooterLinkedToPrevious(HeaderFooterType headerFooterType)
Parameters
HeaderFooterType headerFooterType

Type of the footer.

Returns
System.Boolean

true if the footer is linked to the previous section footer; otherwise, false.

IsHeaderLinkedToPrevious(HeaderFooterType)

Determines whether a header is linked to the previous section header.

Declaration
public bool IsHeaderLinkedToPrevious(HeaderFooterType headerFooterType)
Parameters
HeaderFooterType headerFooterType

Type of the header.

Returns
System.Boolean

true if the header is linked to the previous section header; otherwise, false.

LinkFooterToPrevious(HeaderFooterType)

Links the footer of this section to the previous section footer.

Declaration
public void LinkFooterToPrevious(HeaderFooterType headerFooterType)
Parameters
HeaderFooterType headerFooterType

Type of the header or footer.

LinkHeaderToPrevious(HeaderFooterType)

Links the header of this section to the previous section header.

Declaration
public void LinkHeaderToPrevious(HeaderFooterType headerFooterType)
Parameters
HeaderFooterType headerFooterType

Type of the header or footer.

OnChildDocumentContainerChanged()

Declaration
public void OnChildDocumentContainerChanged()

OnChildDocumentContainerChanging()

Declaration
public void OnChildDocumentContainerChanging()

OnHeadersFootersChanged(EventArgs)

Declaration
protected virtual void OnHeadersFootersChanged(EventArgs e)
Parameters
System.EventArgs e

OnParentChanged()

Declaration
protected override void OnParentChanged()
Overrides
DocumentElement.OnParentChanged()

SetFooterByPageNumber(Int32, Footer)

Sets the footer by page number.

Declaration
public void SetFooterByPageNumber(int pageNumber, Footer footer)
Parameters
System.Int32 pageNumber

The page number.

Footer footer

The footer.

SetFooterByType(HeaderFooterType, Footer)

Sets a footer according to type.

Declaration
public void SetFooterByType(HeaderFooterType footerType, Footer footer)
Parameters
HeaderFooterType footerType

Type of the footer.

Footer footer

The footer.

SetHeaderByPageNumber(Int32, Header)

Sets the header by page number.

Declaration
public void SetHeaderByPageNumber(int pageNumber, Header header)
Parameters
System.Int32 pageNumber

The page number.

Header header

The header.

SetHeaderByType(HeaderFooterType, Header)

Sets a header according to type.

Declaration
public void SetHeaderByType(HeaderFooterType headerType, Header header)
Parameters
HeaderFooterType headerType

Type of the header.

Header header

The header.

SetMainDocument(RadDocument)

Sets the main document. This method is used to link the headers and footers in a section with the main body document.

Declaration
public void SetMainDocument(RadDocument document)
Parameters
RadDocument document

The document.

UnlinkFooterFromPrevious(HeaderFooterType)

Removes the link between the footer of this section and the previous section footer.

Declaration
public void UnlinkFooterFromPrevious(HeaderFooterType headerFooterType)
Parameters
HeaderFooterType headerFooterType

Type of the header or footer.

UnlinkHeaderFromPrevious(HeaderFooterType)

Removes the link between the header of this section and the previous section header.

Declaration
public void UnlinkHeaderFromPrevious(HeaderFooterType headerFooterType)
Parameters
HeaderFooterType headerFooterType

Type of the header or footer.

Extension Methods

CollectionExtensions.ToEnumerable<T>(T)
EnumerableExtensions.ToEnumerable<T>(T)

Was this article helpful?

Tell us how we can improve this article

Skip
Getting Started
  • Install Now
  • Demos
  • SDK Samples Browser
  • Sample Applications
  • Themes Generator
Support Resources
  • Code Library
  • Knowledge Base
  • MVVM Support
  • Videos
  • GitHub SDK Repository
  • System Requirements
Community
  • Forums
  • Blogs
  • XAML Feedback Portal
  • Document Processing Feedback Portal

Copyright © 2018 Progress Software Corporation and/or its subsidiaries or affiliates.
All Rights Reserved.

Progress, Telerik, and certain product names used herein are trademarks or registered trademarks of Progress Software Corporation and/or one of its subsidiaries or affiliates in the U.S. and/or other countries. See Trademarks for appropriate markings.