Class
Section

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

Definition

Namespace:Telerik.Windows.Documents.Model

Assembly:Telerik.Windows.Controls.RichTextBox.dll

Syntax:

cs-api-definition
public class Section : BlockContainerBase, IBlockContainer

Inheritance: objectDocumentElementBlockBlockContainerBaseSection

Implements: IBlockContainer

Inherited Members BlockContainerBase.BlocksDocumentElement.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.OnStylePropertyChanged(StylePropertyChangeEventArgs)DocumentElement.OnParentChanging()DocumentElement.ChildIndexDocumentElement.HasStyleDocumentElement.StyleDocumentElement.StyleNameDocumentElement.TagDocumentElement.FirstLayoutBoxDocumentElement.IsFirstLayoutBoxInitializedDocumentElement.DocumentElementsDocumentElement.ParentDocumentElement.ChildrenDocumentElement.PreviousSiblingDocumentElement.NextSiblingDocumentElement.CursorDocumentElement.StyleChangingDocumentElement.StyleChangedDocumentElement.StylePropertyChangedDocumentElement.ParentChangingDocumentElement.ParentChangedDocumentElement.PropertyValueChanged

Constructors

Section()

Initializes a new instance of the Section class.

Declaration

cs-api-definition
public Section()

Section(Section)

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

Declaration

cs-api-definition
public Section(Section originalSection)

Parameters

originalSection

Section

The original section.

Fields

ColumnsProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<SectionColumnCollection, SectionProperties> ColumnsProperty

Field Value

StylePropertyDefinition<SectionColumnCollection, SectionProperties>

EndnotesFirstNumberProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<int?, SectionProperties> EndnotesFirstNumberProperty

Field Value

StylePropertyDefinition<int?, SectionProperties>

EndnotesNumberingFormatProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<ListNumberingFormat?, SectionProperties> EndnotesNumberingFormatProperty

Field Value

StylePropertyDefinition<ListNumberingFormat?, SectionProperties>

EndnotesNumberingRestartTypeProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<NumberingRestartType?, SectionProperties> EndnotesNumberingRestartTypeProperty

Field Value

StylePropertyDefinition<NumberingRestartType?, SectionProperties>

FooterBottomMarginProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<int?, SectionProperties> FooterBottomMarginProperty

Field Value

StylePropertyDefinition<int?, SectionProperties>

FootnotesFirstNumberProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<int?, SectionProperties> FootnotesFirstNumberProperty

Field Value

StylePropertyDefinition<int?, SectionProperties>

FootnotesNumberingFormatProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<ListNumberingFormat?, SectionProperties> FootnotesNumberingFormatProperty

Field Value

StylePropertyDefinition<ListNumberingFormat?, SectionProperties>

FootnotesNumberingRestartTypeProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<NumberingRestartType?, SectionProperties> FootnotesNumberingRestartTypeProperty

Field Value

StylePropertyDefinition<NumberingRestartType?, SectionProperties>

HasDifferentFirstPageHeaderFooterProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<bool?, SectionProperties> HasDifferentFirstPageHeaderFooterProperty

Field Value

StylePropertyDefinition<bool?, SectionProperties>

HeaderTopMarginProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<int?, SectionProperties> HeaderTopMarginProperty

Field Value

StylePropertyDefinition<int?, SectionProperties>

LineNumberingProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<LineNumbering, SectionProperties> LineNumberingProperty

Field Value

StylePropertyDefinition<LineNumbering, SectionProperties>

PageMarginProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<Padding?, SectionProperties> PageMarginProperty

Field Value

StylePropertyDefinition<Padding?, SectionProperties>

PageOrientationProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<PageOrientation?, SectionProperties> PageOrientationProperty

Field Value

StylePropertyDefinition<PageOrientation?, SectionProperties>

PageSizeProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<Size?, SectionProperties> PageSizeProperty

Field Value

StylePropertyDefinition<Size?, SectionProperties>

PreviousSectionBreakTypeProperty

Declaration

cs-api-definition
public static readonly StylePropertyDefinition<SectionBreakType?, SectionProperties> PreviousSectionBreakTypeProperty

Field Value

StylePropertyDefinition<SectionBreakType?, SectionProperties>

Properties

ActualPageMargin

Represents the actual margin of a page in a document.

Declaration

cs-api-definition
public Padding ActualPageMargin { get; set; }

Property Value

Padding

Columns

Gets or sets the text columns in the Section.

Declaration

cs-api-definition
public SectionColumnCollection Columns { get; set; }

Property Value

SectionColumnCollection

The section columns.

EndnotesFirstNumber

Gets or sets the endnotes starting number.

Declaration

cs-api-definition
[XamlSerializable(1)]
public int EndnotesFirstNumber { get; set; }

Property Value

int

EndnotesNumberingFormat

Gets or sets the endnotes numbering format.

Declaration

cs-api-definition
[XamlSerializable(ListNumberingFormat.Decimal)]
public ListNumberingFormat EndnotesNumberingFormat { get; set; }

Property Value

ListNumberingFormat

EndnotesNumberingRestartType

Gets or sets the type of the endnotes numbering restart.

Declaration

cs-api-definition
[XamlSerializable(NumberingRestartType.Continuous)]
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

cs-api-definition
[XamlSerializable(null)]
public int? FirstPageNumber { get; set; }

Property Value

int?

The page number.

FooterBottomMargin

Gets or sets the footer bottom margin.

Declaration

cs-api-definition
[XamlSerializable(48)]
public int FooterBottomMargin { get; set; }

Property Value

int

The footer bottom margin.

Footers

Gets or sets the footers.

Declaration

cs-api-definition
[XamlCompositePropertySerializable]
public Footers Footers { get; set; }

Property Value

Footers

The footers.

FootnotesFirstNumber

Gets or sets the footnotes starting number.

Declaration

cs-api-definition
[XamlSerializable(1)]
public int FootnotesFirstNumber { get; set; }

Property Value

int

FootnotesNumberingFormat

Gets or sets the footnotes numbering format.

Declaration

cs-api-definition
[XamlSerializable(ListNumberingFormat.Decimal)]
public ListNumberingFormat FootnotesNumberingFormat { get; set; }

Property Value

ListNumberingFormat

FootnotesNumberingRestartType

Gets or sets the type of the footnotes numbering restart.

Declaration

cs-api-definition
[XamlSerializable(NumberingRestartType.Continuous)]
public NumberingRestartType FootnotesNumberingRestartType { get; set; }

Property Value

NumberingRestartType

HasDifferentFirstPageHeaderFooter

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

Declaration

cs-api-definition
[XamlSerializable(false)]
public bool HasDifferentFirstPageHeaderFooter { get; set; }

Property Value

bool

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

HeaderTopMargin

Gets or sets the header top margin.

Declaration

cs-api-definition
[XamlSerializable(48)]
public int HeaderTopMargin { get; set; }

Property Value

int

The header top margin.

Headers

Gets or sets the headers.

Declaration

cs-api-definition
[XamlCompositePropertySerializable]
public Headers Headers { get; set; }

Property Value

Headers

The headers.

IsEmpty

Gets a value indicating whether the section is empty.

Declaration

cs-api-definition
public bool IsEmpty { get; }

Property Value

bool

true if the section is empty; otherwise, false.

LineNumbering

Gets or sets the line numbering in the Section.

Declaration

cs-api-definition
public LineNumbering LineNumbering { get; set; }

Property Value

LineNumbering

The line numbering.

Number

Gets the section number (starting from 1).

Declaration

cs-api-definition
public int Number { get; }

Property Value

int

PageMargin

Represents the page margin settings for a document section in the Telerik Windows Document Model.

Declaration

cs-api-definition
[XamlSerializable]
public Padding PageMargin { get; set; }

Property Value

Padding

PageOrientation

Represents the orientation of a page in a document.

Declaration

cs-api-definition
[XamlSerializable]
public PageOrientation PageOrientation { get; set; }

Property Value

PageOrientation

PageSize

Gets or sets the size of the page for the document section.

Declaration

cs-api-definition
[XamlSerializable]
public Size PageSize { get; set; }

Property Value

Size

A Size representing the width and height of the page.

PreviousSectionBreakType

Gets or sets the type of the previous section break for the document section.

Declaration

cs-api-definition
[XamlSerializable]
public SectionBreakType PreviousSectionBreakType { get; set; }

Property Value

SectionBreakType

A PreviousSectionBreakType value that indicates the type of break preceding the section.

Methods

CopyPropertiesFromOverride(DocumentElement)

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

Declaration

cs-api-definition
protected override void CopyPropertiesFromOverride(DocumentElement fromElement)

Parameters

fromElement

DocumentElement

The Section to copy the properties from.

Overrides DocumentElement.CopyPropertiesFromOverride(DocumentElement)

CreateLayoutBox(DocumentStructureCollection)

Creates a SectionLayoutBox for the element.

Declaration

cs-api-definition
public override LayoutBox CreateLayoutBox(DocumentStructureCollection documentCollection)

Parameters

documentCollection

DocumentStructureCollection

The document collection.

Returns

LayoutBox

The new SectionLayoutBox.

Overrides DocumentElement.CreateLayoutBox(DocumentStructureCollection)

CreateNewElementInstance()

Creates a new Section instance.

Declaration

cs-api-definition
protected override DocumentElement CreateNewElementInstance()

Returns

DocumentElement

The new instance.

Overrides DocumentElement.CreateNewElementInstance()

GetFooterByPageNumber(int)

Gets the footer by page number.

Declaration

cs-api-definition
public Footer GetFooterByPageNumber(int pageNumber)

Parameters

pageNumber

int

The page number.

Returns

Footer

GetFooterByType(HeaderFooterType)

Gets the footer by its type.

Declaration

cs-api-definition
public Footer GetFooterByType(HeaderFooterType footerType)

Parameters

footerType

HeaderFooterType

Type of the footer.

Returns

Footer

GetFooterHeight(int)

Gets the height of the footer for a page.

Declaration

cs-api-definition
public float GetFooterHeight(int pageNumber)

Parameters

pageNumber

int

The page number.

Returns

float

GetHeaderByPageNumber(int)

Gets the header by page number.

Declaration

cs-api-definition
public Header GetHeaderByPageNumber(int pageNumber)

Parameters

pageNumber

int

The page number.

Returns

Header

GetHeaderByType(HeaderFooterType)

Gets the header by its type.

Declaration

cs-api-definition
public Header GetHeaderByType(HeaderFooterType headerType)

Parameters

headerType

HeaderFooterType

Type of the header.

Returns

Header

GetHeaderFooterTypeByPageNumber(int)

Gets the header/footer type by page number.

Declaration

cs-api-definition
public HeaderFooterType GetHeaderFooterTypeByPageNumber(int pageNumber)

Parameters

pageNumber

int

The page number.

Returns

HeaderFooterType

GetHeaderHeight(int)

Gets the height of the header for a page.

Declaration

cs-api-definition
public float GetHeaderHeight(int pageNumber)

Parameters

pageNumber

int

The page number.

Returns

float

IsFooterLinkedToPrevious(HeaderFooterType)

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

Declaration

cs-api-definition
public bool IsFooterLinkedToPrevious(HeaderFooterType headerFooterType)

Parameters

headerFooterType

HeaderFooterType

Type of the footer.

Returns

bool

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

cs-api-definition
public bool IsHeaderLinkedToPrevious(HeaderFooterType headerFooterType)

Parameters

headerFooterType

HeaderFooterType

Type of the header.

Returns

bool

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

cs-api-definition
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

cs-api-definition
public void LinkHeaderToPrevious(HeaderFooterType headerFooterType)

Parameters

headerFooterType

HeaderFooterType

Type of the header or footer.

OnChildDocumentContainerChanged()

Occurs when the child document container has changed.

Declaration

cs-api-definition
public void OnChildDocumentContainerChanged()

OnChildDocumentContainerChanging()

Occurs when the child document container is about to change.

Declaration

cs-api-definition
public void OnChildDocumentContainerChanging()

OnHeadersFootersChanged(EventArgs)

Declaration

cs-api-definition
protected virtual void OnHeadersFootersChanged(EventArgs e)

Parameters

e

EventArgs

OnParentChanged()

Called when the parent of the element has been changed.

Declaration

cs-api-definition
protected override void OnParentChanged()

Overrides DocumentElement.OnParentChanged()

Sets the footer by page number.

Declaration

cs-api-definition
public void SetFooterByPageNumber(int pageNumber, Footer footer)

Parameters

pageNumber

int

The page number.

footer

Footer

The footer.

Sets a footer according to type.

Declaration

cs-api-definition
public void SetFooterByType(HeaderFooterType footerType, Footer footer)

Parameters

footerType

HeaderFooterType

Type of the footer.

footer

Footer

The footer.

SetHeaderByPageNumber(int, Header)

Sets the header by page number.

Declaration

cs-api-definition
public void SetHeaderByPageNumber(int pageNumber, Header header)

Parameters

pageNumber

int

The page number.

header

Header

The header.

SetHeaderByType(HeaderFooterType, Header)

Sets a header according to type.

Declaration

cs-api-definition
public void SetHeaderByType(HeaderFooterType headerType, Header header)

Parameters

headerType

HeaderFooterType

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

cs-api-definition
public void SetMainDocument(RadDocument document)

Parameters

document

RadDocument

The document.

UnlinkFooterFromPrevious(HeaderFooterType)

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

Declaration

cs-api-definition
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

cs-api-definition
public void UnlinkHeaderFromPrevious(HeaderFooterType headerFooterType)

Parameters

headerFooterType

HeaderFooterType

Type of the header or footer.

In this article
DefinitionConstructorsSection()Section(Section)FieldsColumnsPropertyEndnotesFirstNumberPropertyEndnotesNumberingFormatPropertyEndnotesNumberingRestartTypePropertyFooterBottomMarginPropertyFootnotesFirstNumberPropertyFootnotesNumberingFormatPropertyFootnotesNumberingRestartTypePropertyHasDifferentFirstPageHeaderFooterPropertyHeaderTopMarginPropertyLineNumberingPropertyPageMarginPropertyPageOrientationPropertyPageSizePropertyPreviousSectionBreakTypePropertyPropertiesActualPageMarginColumnsEndnotesFirstNumberEndnotesNumberingFormatEndnotesNumberingRestartTypeFirstPageNumberFooterBottomMarginFootersFootnotesFirstNumberFootnotesNumberingFormatFootnotesNumberingRestartTypeHasDifferentFirstPageHeaderFooterHeaderTopMarginHeadersIsEmptyLineNumberingNumberPageMarginPageOrientationPageSizePreviousSectionBreakTypeMethodsCopyPropertiesFromOverride(DocumentElement)CreateLayoutBox(DocumentStructureCollection)CreateNewElementInstance()GetFooterByPageNumber(int)GetFooterByType(HeaderFooterType)GetFooterHeight(int)GetHeaderByPageNumber(int)GetHeaderByType(HeaderFooterType)GetHeaderFooterTypeByPageNumber(int)GetHeaderHeight(int)IsFooterLinkedToPrevious(HeaderFooterType)IsHeaderLinkedToPrevious(HeaderFooterType)LinkFooterToPrevious(HeaderFooterType)LinkHeaderToPrevious(HeaderFooterType)OnChildDocumentContainerChanged()OnChildDocumentContainerChanging()OnHeadersFootersChanged(EventArgs)OnParentChanged()SetFooterByPageNumber(int, Footer)SetFooterByType(HeaderFooterType, Footer)SetHeaderByPageNumber(int, Header)SetHeaderByType(HeaderFooterType, Header)SetMainDocument(RadDocument)UnlinkFooterFromPrevious(HeaderFooterType)UnlinkHeaderFromPrevious(HeaderFooterType)
Not finding the help you need?
Contact Support