AddPageNumberPlaceholder

Disposition des pages, pagination, texte

Description

Enregistre une zone de texte sur la page sélectionnée et diffère son tracé jusqu'à ce que le nombre final de pages et de chapitres soit connu

Syntaxe

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

Paramètres

Left, Top, Width, Height	Géométrie de la zone de texte dans le système de coordonnées actuel
Text	Modèle contenant des jetons de pagination et du texte ordinaire
Options	Placement vertical et option sans retour à la ligne de 0 à 5, avec la même signification que `DrawTextBox`

Tokens

`<%PageNo%>`	Numéro physique de la page sélectionnée
`<%TotalPages%>`	Nombre final de pages du document
`<%ChapterPageNo%>`	Numéro de page basé sur 1 dans le chapitre actuel
`<%ChapterTotalPages%>`	Nombre final de pages du chapitre actuel
`<%ChapterName%>`	Nom enregistré par `StartPageNumberChapter`

Valeurs de retour

Renvoie l'identifiant d'espace réservé à base 1, ou 0 en cas de géométrie, options, texte ou sélection non valides, ou si les espaces réservés du document ont déjà été résolus

Remarques

L'appel capture la police, taille, couleurs, alignement, espacement, crénage, décoration, échelle, origine et géométrie traduite de boîte de texte sélectionnés sans dessiner

Les jetons de date, d'heure et personnalisés OnCalcVariable utilisent les mêmes règles que ExpandVariableTokens

Appelez ResolvePageNumberPlaceholders exactement une fois lorsque toute la structure des pages est stable et avant l'enregistrement