SetSignProcessAppearanceTemplate

Segurança e assinaturas

Descrição

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

O modelo é expandido uma única vez quando a assinatura é produzida, pelo que o mesmo esquema pode ser reutilizado com metadados de assinatura e valores de aplicação 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 devolvido por uma função `NewSignProcessFrom*`
TemplateText	Texto e quebras de linha que contêm qualquer um dos marcadores de posição incorporados `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` e `{page}`, além de nomes personalizados registados com SetSignProcessAppearanceVariable
SignerName	Valor substituído por `{signer}`
DateFormat	Formato de data e hora Delphi utilizado por `{date}`, ou uma cadeia vazia para `yyyy-mm-dd hh:nn:ss`
FontSize	Tamanho do tipo de letra em pontos ou `0` para ajustar automaticamente o bloco de texto
FontRed, FontGreen, FontBlue	Componentes da cor do texto no intervalo `0..1`

Valores devolvidos

1	O modelo foi aceite
0	O ID do processo, a sintaxe de chavetas, o nome do marcador de posição, o comprimento do modelo, o número de marcadores de posição ou o formato da data era inválido

Observações

Utilize {{ e }} para emitir chavetas literais

Um modelo pode conter até 32 768 carateres e 256 ocorrências de marcadores de posição

As variáveis personalizadas em falta são expandidas para texto vazio, enquanto as variáveis integradas refletem sempre o processo de assinatura atual

A chamada posterior de SetSignProcessAppearanceText volta a selecionar a apresentação antiga baseada em linhas

Uma imagem de campo continua a ter precedência, e os processos de carimbo temporal de documento não processam uma apresentação de texto

Consulte também

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds