AddPageNumberPlaceholder

Layout da página, Paginação, Texto

Descrição

Registra uma caixa de texto na página selecionada e adia seu desenho até que as contagens finais de página e capítulo sejam conhecidas

Sintaxe

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	Geometria da caixa de texto no sistema de coordenadas atual
Text	Template contendo tokens de paginação e texto comum
Options	Posicionamento vertical e opção de não quebrar linha de 0 a 5, com o mesmo significado de `DrawTextBox`

Tokens

`<%PageNo%>`	Physical selected page number
`<%TotalPages%>`	Final document page count
`<%ChapterPageNo%>`	Número da página dentro do capítulo atual, com base 1
`<%ChapterTotalPages%>`	Contagem final de páginas do capítulo atual
`<%ChapterName%>`	Name registered by `StartPageNumberChapter`

Valores retornados

Retorna o identificador de placeholder baseado em 1, ou 0 para geometria, opções, texto, seleção inválidos ou um documento cujos placeholders já foram resolvidos

Observações

A chamada captura a fonte selecionada, tamanho do texto, cores, alinhamento, espaçamento, kerning, decoração, escala, origem e a geometria traduzida da caixa de texto sem desenhar o conteúdo da página

Tokens de data, hora e OnCalcVariable personalizados usam as mesmas regras de ExpandVariableTokens. Chame

ResolvePageNumberPlaceholders exatamente uma vez, depois que a estrutura completa de páginas estiver estável e antes de salvar