AddPageNumberPlaceholder

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

Descripción

Registra un cuadro de texto en la página seleccionada y pospone su dibujo hasta conocer los conteos finales 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	Ubicación vertical y opción de no ajuste de 0 a 5 con el mismo significado que `DrawTextBox`

Tokens

`<%PageNo%>`	Número físico de página seleccionada
`<%TotalPages%>`	Cantidad final de páginas del documento
`<%ChapterPageNo%>`	Número de página basado en 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 para geometría, opciones, texto o selección no válidos, o para un documento cuyos marcadores de posición ya se resolvieron

Observaciones

La llamada captura la fuente seleccionada, el tamaño de texto, los colores, la alineación, el espaciado, el kerning, la decoración, la escala, el origen y la geometría traducida del cuadro de texto sin dibujar contenido de página

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

Llame a ResolvePageNumberPlaceholders exactamente una vez después de que la estructura completa de páginas sea estable y antes de guardar