IXpsSignatureRequest::SetSpotLocation-Methode (xpsdigitalsignature.h)

Artikel
08/28/2023

Gibt die Seite und den Speicherort auf der Seite an, auf der die sichtbare digitale Signatur oder die Digitale Signaturanforderung angezeigt wird.

Syntax

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

Parameter

[in] pageIndex

Der Indexwert des FixedPage-Teils im XPS-Dokument, das die sichtbare digitale Signatur oder die Digitale Signaturanforderung enthält.

Wenn der Wert dieses Parameters –1 ist, wird kein SpotLocation-Element in das SignatureDefinitions-Markup geschrieben.

Wenn der Wert dieses Parameters nicht –1 ist, muss es sich um eine Seitenzahl im FixedDocument-Teil handelt, an den der Signaturblock angefügt ist, der diese Anforderung enthält.

[in] x

Der x-Koordinatenwert der Signaturstelle auf der Seite.

[in] y

Der y-Koordinatenwert der Signaturstelle auf der Seite.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Rückgabewerte, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS Digital Signature-API-Fehler und XPS-Dokumentfehler.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_UNEXPECTED	Die Schnittstelle ist nicht mit dem Signatur-Manager verbunden.

Hinweise

Die Position des Signaturpunkts wird in XPS-Einheiten in der oberen linken Ecke der Seite angegeben. Es gibt 96 XPS-Einheiten pro Zoll.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	xpsdigitalsignature.h