PageLabel Class Documentation

class PageLabel : SystemIDisposable

Namespace:Datalogics::PDFL

Inherits from:
SystemIDisposable

Detailed Description

Describes numbering labels for a range of pages.

PageLabel describes how to construct a label string for a range of pages. It contains information on number style, any prefixes, and a starting position within the document.

Note that a single PageLabel describes the label string for several pages all pages up until the first page covered by the next PageLabel, or the end of the document.

Also note that if a Document has any PageLabels, there must be one that starts at page index 0. This will be automatically created if the user does not supply one.

Referenced by

Uses types

Constructor & Destructor Documentation

PageLabel

PageLabel(int start, NumberStyle ns)

Parameters

start: int

Starting page index in the Document for this range

ns: NumberStyle

Numbering style for this range

Convenience constructor creates a range with no prefix starting with number 1.

PageLabel

PageLabel(int start, NumberStyle ns, string p, int first)

Parameters

start: int

Starting page index in the Document for this range

ns: NumberStyle

Numbering style for this range

p: string

Prefix string for this range

first: int

First number appearing on a page in this range

Public constructor

Property Documentation

EndPageIndex

int EndPageIndex[get]

The zero-based ending page index for this page label range.

You cannot set the end index for a range; you must change the start index for the following range. A value of -1 means the end index for this PageLabel is unknown (e.g. when the label has not yet been added to a Document).

FirstNumberInRange

int FirstNumberInRange[get, set]

The first numeric value used for page labels in this range.

Must be greater than or equal to 1.

NumberStyle

NumberStyle NumberStyle[get, set]

The NumberStyle used for generating page labels in this range.

Prefix

string Prefix[get, set]

The prefix string prepended to page labels in this range.

For example, a prefix of "A-" with decimal numbering starting at 1 would produce labels "A-1", "A-2", "A-3", etc.

StartPageIndex

int StartPageIndex[get, set]

The zero-based starting page index for this page label range in the Document.

Member Function Documentation

Dispose

void Dispose()

Returns:

void

ToString

override string ToString()

Returns:

override string

A string describing this PageLabel.

Returns a string representation of this PageLabel.

The string includes the start page, end page, number style, prefix, and first page number of this label range.