SetSignProcessAppearanceTemplate

Seguridad y firmas

Descripción

Configura una plantilla de apariencia de texto visible para un proceso de firma digital

La plantilla se expande una vez al producirse la firma, por lo que el mismo diseño puede reutilizarse con distintos metadatos de firma y valores de aplicación

Sintaxis

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 devuelto por una función `NewSignProcessFrom*`
TemplateText	Texto y saltos de línea que contienen cualquiera de los marcadores integrados `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` y `{page}`, además de nombres personalizados registrados con SetSignProcessAppearanceVariable
SignerName	Valor sustituido por `{signer}`
DateFormat	Formato de fecha y hora de Delphi utilizado por `{date}`, o una cadena vacía para `yyyy-mm-dd hh:nn:ss`
FontSize	Tamaño de fuente en puntos, o `0` para ajustar automáticamente el bloque de texto
FontRed, FontGreen, FontBlue	Componentes de color de texto en el intervalo `0..1`

Valores devueltos

1	Se aceptó la plantilla
0	El ID del proceso, la sintaxis de llaves, el nombre del marcador de posición, la longitud de la plantilla, el recuento de marcadores de posición o el formato de fecha no eran válidos

Observaciones

Use {{ y }} para emitir llaves literales

Una plantilla puede contener hasta 32,768 caracteres y 256 apariciones de marcadores de posición

Las variables personalizadas ausentes se expanden como texto vacío, mientras que las variables integradas siempre reflejan el proceso de firma actual

Llamar después a SetSignProcessAppearanceText vuelve a seleccionar la apariencia heredada basada en líneas

Una imagen de campo sigue teniendo prioridad y los procesos de sello de tiempo del documento no representan una apariencia de texto

Véase también

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds