AddPageNumberPlaceholder

Diseño de página, paginación, texto

Descripción

Registra un cuadro de texto en la página seleccionada y aplaza su dibujo hasta conocer el número final de páginas y capítulos

Sintaxis

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

Parámetros

Left, Top, Width, Height	Geometría del cuadro de texto en el sistema de coordenadas actual
Text	Plantilla que contiene tokens de paginación y texto normal
Options	Colocación vertical y opción sin ajuste de línea de 0 a 5 con el mismo significado que `DrawTextBox`

Tokens

`<%PageNo%>`	Número físico de la página seleccionada
`<%TotalPages%>`	Número final de páginas del documento
`<%ChapterPageNo%>`	Número de página de base uno dentro del capítulo actual
`<%ChapterTotalPages%>`	Recuento final de páginas del capítulo actual
`<%ChapterName%>`	Nombre registrado por `StartPageNumberChapter`

Valores devueltos

Devuelve el identificador de marcador de posición basado en uno, o 0 si la geometría, las opciones, el texto o la selección no son válidos, o si los marcadores de posición del documento ya se han resuelto

Observaciones

Captura fuente, tamaño, colores, alineación, espaciado, interletraje, decoración, escala, origen y geometría traducida del cuadro sin dibujar contenido

Los tokens de fecha, hora y OnCalcVariable personalizados utilizan las mismas reglas que ExpandVariableTokens

Llame a ResolvePageNumberPlaceholders exactamente una vez cuando la estructura esté estable y antes de guardar