Metode IXpsSignatureRequest::SetSpotLocation (xpsdigitalsignature.h)

Artikel
12/22/2023

Menentukan halaman dan lokasi pada halaman tempat tanda tangan digital yang terlihat atau permintaan tanda tangan digital akan ditampilkan.

Sintaks

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

Parameter

[in] pageIndex

Nilai indeks bagian FixedPage dalam dokumen XPS yang berisi tanda tangan digital yang terlihat atau permintaan tanda tangan digital.

Jika nilai parameter ini adalah –1, elemen SpotLocation tidak akan ditulis ke markup SignatureDefinitions.

Jika nilai parameter ini bukan –1, nilai harus berupa nomor halaman yang ada di bagian FixedDocument tempat blok tanda tangan yang berisi permintaan ini dilampirkan.

[in] x

Nilai koordinat x dari tempat penandatanganan di halaman.

[in] y

Nilai koordinat y dari tempat penandatanganan di halaman.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut. Untuk nilai pengembalian yang tidak tercantum dalam tabel ini, lihat Kesalahan XPS Digital Signature API dan Kesalahan Dokumen XPS.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_UNEXPECTED	Antarmuka tidak tersambung ke pengelola tanda tangan.

Keterangan

Lokasi tempat penandatanganan ditentukan dalam unit XPS dari sudut kiri atas halaman. Ada 96 unit XPS per inci.

Persyaratan


Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	xpsdigitalsignature.h