SetSignProcessAppearanceTemplate

Seguridad y firmas

Descripción

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

La plantilla se expande una vez al generar la firma, por lo que el mismo diseño puede reutilizarse con distintos metadatos de firma y valores de la 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 los 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 del texto en el intervalo `0..1`

Valores devueltos

1	La plantilla se aceptó
0	El identificador del proceso, la sintaxis de llaves, el nombre del marcador de posición, la longitud de la plantilla, el número de marcadores de posición o el formato de fecha no eran válidos

Observaciones

Utilice {{ y }} para emitir llaves literales

Una plantilla puede contener hasta 32.768 caracteres y 256 apariciones de marcadores de posición

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

Llamar posteriormente a SetSignProcessAppearanceText vuelve a seleccionar la apariencia heredada basada en líneas

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

Véase también

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds