Namespace TallComponents.PDF.Layout

Class Section

Renders content onto one or more pages using Paragraphs, Headers, Footers and Areas.

A document has one or more sections that span one or more pages. Within a section a list of paragraphs is rendered in the space available between the margins. A section defines

s and

s that are repeated on each page. It is also possible to add absolutely positioned

s on top of or below the main content.

A section can define one or more columns.

Implent a handler for to insert a header and a handler for .

Syntax


        public class Section
                 : Object
            ,
                ITaggable

Constructors

Creates a new, empty section.

Properties

AreaCollection BackgroundAreas

Get the collection of Area objects that is associated with each page of this Section.

Rectangle BleedBox

A rectangle, expressed in points with the origin at the bottom left corner, defining the region to which the contents of the page should be clipped when output in a production environment.

ColumnCollection Columns

Get or set the collection of columns on the pages of this section.

Rectangle CropBox

The printed or viewed area of the page.

Boolean DoNotBreak

Get or set if this section has to be rendered on a single page.

Footer EvenFooter

Get or set a fixed area at the bottom of each even page of this section.

Header EvenHeader

Get or set a fixed area at the top of each even page of this section.

Boolean ExcludeFromPageCount

Gets or sets a value indicating whether to exclude this section from total pages count.

Get or set a fixed area at the bottom of each page of this section.

AreaCollection ForegroundAreas

Get the collection of Area objects that is associated with each page of this Section.

Get or set a fixed area at the top of each page of this section.

Get the width of the whitespace around the main content in points.

Footer OddFooter

Get or set a fixed area at the bottom of each odd page of this section.

Header OddHeader

Get or set a fixed area at the top of each odd page of this section.

PageOrientation Orientation

Page orientation in the viewer (counterclockwise).

PageSize PageSize

Get or set the height and width of all pages in this section in points.

ParagraphCollection Paragraphs

Returns a paragraphs object. Use this property to add new paragraphs.

Int32 RestartPageNumber

Get or set the page number of the first page of this section.

Boolean StartOnNewPage

Get or set if you want this section to start on a new page.

Rectangle TrimBox

A rectangle, expressed in points with the origin at the bottom left corner, defining the intended dimensions of the finshed page after trimming. May be smaller than the bleed box for printing instructions, cut marks, or color bars.

VerticalAlignment VerticalAlignment

Get or set the vertical alignment of the contained ParagraphCollection.

Methods

Void Compose(Document)

Implement this method in a derived class to generate content dynamically.

Events

QueryPageSettings

Occurs before a new empty page is added to the document.

Occurs right after a new empty page has been added to the document.

Occurs right after the main area has been completely filled with paragraphs.

Occurs when the Compose phase is about to end.

Occurs when the Compose phase starts.