AddPageNumberPlaceholder

Sidlayout, Sidbrytning, Text

Beskrivning

Spelar in en textruta på den valda sidan och skjuter upp dess ritning tills slutliga sid- och kapitelantal är kända

Syntax

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);

Parametrar

Left, Top, Width, Height	Textrutans geometri i aktuellt koordinatsystem
Text	Mall med sidnumreringstokens och vanlig text
Options	Vertikal placering och no-wrap-option från 0 till 5 med samma betydelse som `DrawTextBox`

Tokens

`<%PageNo%>`	Physical selected page number
`<%TotalPages%>`	Slutligt sidantal för dokumentet
`<%ChapterPageNo%>`	1-baserat sidnummer inom aktuellt kapitel
`<%ChapterTotalPages%>`	Slutligt sidantal för det aktuella kapitlet
`<%ChapterName%>`	Name registered by `StartPageNumberChapter`

Returvärden

Returnerar den 1-baserade platshållaridentifieraren, eller 0 för ogiltig geometri, options, text, val, eller ett dokument vars platshållare redan lösts

Anmärkningar

Anropet fångar det valda typsnittet, textstorlek, färger, justering, mellanrum, kerning, utsmyckning, skala, origo och den översatta textrutgeometrin utan att rita sidinnehåll

Datum-, tids- och anpassade OnCalcVariable-token använder samma regler som ExpandVariableTokensAnropa

ResolvePageNumberPlaceholders exakt en gång efter att hela sidstrukturen stabiliserats och före sparning