AddPageNumberPlaceholder

Pagina-indeling, paginering, tekst

Beschrijving

Registreert een textbox op de geselecteerde pagina en stelt het tekenen uit tot de definitieve pagina- en hoofdstuktellingen bekend zijn

Syntaxis

Delphi

Function TPDFlib.AddPageNumberPlaceholder(Left, Top, Width, Height: Double; Const Text: WideString; Options: Integer): Integer;

ActiveX

Function PDFlib::AddPageNumberPlaceholder(Left As Double, Top As Double, Width As Double, Height As Double, Text As String, Options As Long) As Long

DLL

int DLAddPageNumberPlaceholder(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t* Text, int Options);
int DLAddPageNumberPlaceholderA(int InstanceID, double Left, double Top, double Width, double Height, const char* Text, int Options);

Parameters

Left, Top, Width, Height	Textboxgeometrie in het huidige coördinatensysteem
Text	Sjabloon met pagineringstokens en gewone tekst
Options	Verticale plaatsing en no-wrap-optie van 0 tot en met 5, met dezelfde betekenis als `DrawTextBox`

Tokens

`<%PageNo%>`	Physical selected page number
`<%TotalPages%>`	Final document page count
`<%ChapterPageNo%>`	Paginanummer binnen het huidige hoofdstuk, beginnend bij 1
`<%ChapterTotalPages%>`	Definitieve paginatelling van het huidige hoofdstuk
`<%ChapterName%>`	Name registered by `StartPageNumberChapter`

Retourwaarden

Geeft de placeholder-identificator terug (beginnend bij 1), of 0 bij ongeldige geometrie, opties, tekst, selectie, of een document waarvan de placeholders al zijn opgelost

Opmerkingen

De aanroep legt het geselecteerde font, de tekstgrootte, kleuren, uitlijning, spatiëring, kerning, decoratie, schaal, oorsprong en de getransleerde textboxgeometrie vast, zonder pagina-inhoud te tekenen

Datum-, tijd- en custom OnCalcVariable-tokens volgen dezelfde regels als ExpandVariableTokens Roep

ResolvePageNumberPlaceholders exact één keer, nadat de volledige paginstructuur stabiel is en vóór het opslaan