AddPageNumberPlaceholder

Seitenlayout, Paginierung, Text

Beschreibung

Zeichnet ein Textfeld auf der ausgewählten Seite auf und verschiebt dessen Zeichnen, bis die endgültige Seiten- und Kapitelanzahl bekannt ist

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

Parameter

Left, Top, Width, Height	Geometrie des Textfelds im aktuellen Koordinatensystem
Text	Vorlage mit Paginierungstoken und gewöhnlichem Text
Options	Vertikale Platzierung und Kein-Umbruch-Option von 0 bis 5 mit derselben Bedeutung wie `DrawTextBox`

Tokens

`<%PageNo%>`	Physische Nummer der ausgewählten Seite
`<%TotalPages%>`	Endgültige Seitenanzahl des Dokuments
`<%ChapterPageNo%>`	1-basierte Seitennummer innerhalb des aktuellen Kapitels
`<%ChapterTotalPages%>`	Endgültige Seitenanzahl des aktuellen Kapitels
`<%ChapterName%>`	Von `StartPageNumberChapter` registrierter Name

Rückgabewerte

Gibt die einsbasierte Platzhalterkennung zurück oder 0 bei ungültiger Geometrie, ungültigen Optionen, ungültigem Text, ungültiger Auswahl oder einem Dokument, dessen Platzhalter bereits aufgelöst wurden

Anmerkungen

Der Aufruf erfasst ausgewählte Schriftart, Textgröße, Farben, Ausrichtung, Abstände, Kerning, Dekoration, Skalierung, Ursprung und übersetzte Textfeldgeometrie, ohne Seiteninhalt zu zeichnen

Datums-, Zeit- und benutzerdefinierte OnCalcVariable-Token verwenden dieselben Regeln wie ExpandVariableTokens

Rufen Sie ResolvePageNumberPlaceholders genau einmal auf, nachdem die vollständige Seitenstruktur stabil ist und bevor gespeichert wird