Partager via


Méthode IXpsSignatureRequest ::SetSpotLocation (xpsdigitalsignature.h)

Spécifie la page et l’emplacement sur la page où la signature numérique visible ou la demande de signature numérique seront affichées.

Syntaxe

HRESULT SetSpotLocation(
  [in] INT32 pageIndex,
  [in] float x,
  [in] float y
);

Paramètres

[in] pageIndex

Valeur d’index du composant FixedPage dans le document XPS qui contient la signature numérique visible ou la demande de signature numérique.

Si la valeur de ce paramètre est –1, un élément SpotLocation n’est pas écrit dans le balisage SignatureDefinitions.

Si la valeur de ce paramètre n’est pas –1, il doit s’agir d’un numéro de page qui existe dans la partie FixedDocument à laquelle est attaché le bloc de signature qui contient cette demande.

[in] x

Valeur de coordonnée x du spot de signature sur la page.

[in] y

Valeur de coordonnée y du spot de signature sur la page.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles de la table qui suit. Pour connaître les valeurs de retour qui ne sont pas répertoriées dans ce tableau, consultez Erreurs de l’API signature numérique XPS et Erreurs de document XPS.

Code de retour Description
S_OK
S_OK
E_UNEXPECTED
L’interface n’est pas connectée au gestionnaire de signatures.

Remarques

L’emplacement du spot de signature est spécifié dans les unités XPS dans le coin supérieur gauche de la page. Il existe 96 unités XPS par pouce.

Configuration requise

   
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête xpsdigitalsignature.h

Voir aussi

IXpsSignatureBlock

IXpsSignatureManager

IXpsSignatureRequest

XML Paper Specification

Erreurs de l’API signature numérique XPS

Erreurs de document XPS