SetSignProcessAppearanceTemplate

Segurança e assinaturas

Descrição

Configura um template de aparência de texto visível para um processo de assinatura digital

O template é expandido uma vez quando a assinatura é produzida, de modo que o mesmo layout possa ser reutilizado com metadados de assinatura e valores de aplicativo diferentes

Sintaxe

Delphi

Function TPDFlib.SetSignProcessAppearanceTemplate(SignProcessID: Integer; Const TemplateText, SignerName, DateFormat: WideString; FontSize, FontRed, FontGreen, FontBlue: Double): Integer;

ActiveX

Function PDFlib::SetSignProcessAppearanceTemplate(SignProcessID As Long, TemplateText As String, SignerName As String, DateFormat As String, FontSize As Double, FontRed As Double, FontGreen As Double, FontBlue As Double) As Long

DLL

int DLSetSignProcessAppearanceTemplate(int InstanceID, int SignProcessID, const wchar_t * TemplateText, const wchar_t * SignerName, const wchar_t * DateFormat, double FontSize, double FontRed, double FontGreen, double FontBlue);

Parâmetros

SignProcessID	Valor retornado por uma função `NewSignProcessFrom*`
TemplateText	Texto e quebras de linha contendo qualquer um dos placeholders internos `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` e `{page}`, além de nomes personalizados registrados com SetSignProcessAppearanceVariable
SignerName	Valor substituído em `{signer}`
DateFormat	Formato de data e hora Delphi usado por `{date}`, ou uma string vazia para `yyyy-mm-dd hh:nn:ss`
FontSize	Tamanho da fonte em pontos, ou `0` para ajustar o bloco de texto automaticamente
FontRed, FontGreen, FontBlue	Componentes de cor do texto na faixa `0..1`

Valores retornados

1	O template foi aceito
0	O id do processo, a sintaxe de chaves, o nome do placeholder, o comprimento do template, a contagem de placeholders ou o formato de data era inválido

Observações

Use {{ e }} para emitir chaves literais

Um template pode conter até 32.768 caracteres e 256 ocorrências de placeholder

Uma imagem de campo ainda tem precedência, e processos de carimbo de tempo de documento não renderizam uma aparência de texto

Chamar SetSignProcessAppearanceText depois seleciona novamente a aparência legada baseada em linhas

Uma imagem de campo ainda tem precedência, e processos de carimbo de tempo de documento não renderizam uma aparência de texto

Veja também

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds