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

Article
03/05/2024

Obtient 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 GetSpotLocation(
  [out] INT32       *pageIndex,
  [out] IOpcPartUri **pagePartName,
  [out] float       *x,
  [out] float       *y
);

Paramètres

[out] pageIndex

Valeur d’index du composant FixedPage qui contient la signature ou la demande de signature numérique. Si aucun emplacement spot n’est spécifié pour la demande de signature, –1 est retourné.

[out] pagePartName

Pointeur vers une interface IOpcPartUri de la partie qui contient le FixedPage sur lequel la signature numérique doit être affichée.

[out] x

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

[out] 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_POINTER	pageIndex, pagePartName, x ou y a la valeur NULL.
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

Condition requise	Valeur
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