SetSignProcessAppearanceTemplate

Sécurité et signatures

Description

Configure un modèle d'apparence de texte visible pour un processus de signature numérique

Le modèle est développé une fois lors de la production de la signature, afin que la même disposition puisse être réutilisée avec d'autres métadonnées de signature et valeurs d'application

Syntaxe

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);

Paramètres

SignProcessID	Valeur renvoyée par une fonction `NewSignProcessFrom*`
TemplateText	Texte et sauts de ligne contenant les espaces réservés intégrés `{signer}`, `{reason}`, `{location}`, `{contact}`, `{date}`, `{field}` et `{page}`, ainsi que les noms personnalisés enregistrés avec SetSignProcessAppearanceVariable
SignerName	Valeur substituée à `{signer}`
DateFormat	Format de date et d'heure Delphi utilisé par `{date}`, ou chaîne vide pour `yyyy-mm-dd hh:nn:ss`
FontSize	Taille de police en points, ou `0` pour ajuster automatiquement le bloc de texte
FontRed, FontGreen, FontBlue	Composantes de couleur du texte dans la plage `0..1`

Valeurs de retour

1	Le modèle a été accepté
0	L'identifiant du processus, la syntaxe des accolades, le nom de l'espace réservé, la longueur du modèle, le nombre d'espaces réservés ou le format de date n'était pas valide

Remarques

Utilisez {{ et }} pour émettre des accolades littérales

Un modèle peut contenir jusqu'à 32 768 caractères et 256 occurrences d'espaces réservés

Les variables personnalisées manquantes deviennent du texte vide, tandis que les variables intégrées reflètent toujours le processus de signature actuel

Un appel ultérieur à SetSignProcessAppearanceText sélectionne de nouveau l'apparence héritée fondée sur des lignes

Une image de champ reste prioritaire, et les processus d'horodatage de document ne rendent pas d'apparence textuelle

Voir aussi

SetSignProcessAppearanceVariable, SetSignProcessAppearanceText, SetSignProcessFieldBounds