HeadersFooters
The HeadersFooters properties define the placement of headers and footers in printed documents. Headers and footers contain three sections: left, center and right. Each section specifies the text color and font in the associated area of printed documents. Macros can be used as desired. Please note that properties are case-sensitive:
NAME
|
VALUES
|
DEFINITION |
Enabled |
Enables headers and footers. If set to False then headers and footers are not created and no further properties from this section are used.
Default value: False
|
|
FirstPageNumber |
Integer |
Defines the page at which headers and footers start. The value of this property is used in the %[Page] macro.
Default value: 1
|
OffsetLeft OffsetTop OffsetRight OffsetBottom |
Integer |
These properties define the location of headers and footers. The units used are tenths of a millimeter.
Default value: 127
|
Headers and footers are defined with two sections: Header and Footer. These sections are identical and contain three identical subsections: Left, Center and Right. The following properties apply to all subsections:
NAME
|
VALUES
|
DEFINITION |
Font |
String |
Specifies the font used for headers and footers.
Default value: Arial
|
FontSize |
All values from 10 - 32768 |
Specifies font size in tenths of a point. (1 point is 1/72 inch).
Default value: 100
|
FontBold |
Enables/disables bold for the text used.
Default value: False
|
|
FontItalic |
Enables/disables italics for the text used.
Default value: False
|
|
Color
|
RGB COLORREF |
Defines the color of the text used.
Default value: 0 (black)
|
Value |
String |
Defines the text used. Macros can be used in this property as desired.
Default value: empty string
|
Example
The following example will place a red label with the current page number at the right-top corner of each page, with the font Verdana, in bold and at 12 pt size:
(C++)
printer.Option[L"HeadersFooters.Enabled"] = TRUE;
printer.Option[L"HeadersFooters.Header.Right.Font"] = L"Verdana";
printer.Option[L"HeadersFooters.Header.Right.FontBold"] = TRUE;
printer.Option[L"HeadersFooters.Header.Right.FontSize"] = 120;
printer.Option[L"HeadersFooters.Header.Right.color"] = RGB(255, 0, 0);
printer.Option[L"HeadersFooters.Header.Right.Value"] = L"Page %[Page]";
(VB)
With PDFPrinter
.Option("HeadersFooters.Enabled") = TRUE;
.Option("HeadersFooters.Header.Right.Font") = "Verdana";
.Option("HeadersFooters.Header.Right.FontBold") = "Yes";
.Option("HeadersFooters.Header.Right.FontSize") = 120;
.Option("HeadersFooters.Header.Right.color") = 255;
.Option("HeadersFooters.Header.Right.Value") = "Page %[Page]";
End With