IXpsSignatureRequest：：SetSpotLocation 方法 (xpsdigitalsignature.h)

指定會顯示可見數位簽章或數位簽章要求之頁面上的頁面和位置。

語法

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

[in] pageIndex

XPS 檔中 FixedPage 元件的索引值，其中包含可見的數位簽章或數位簽章要求。

如果此參數的值是 – 1，SpotLocation 元素將不會寫入 SignatureDefinitions 標記。

如果這個參數的值不是 –1，它必須是包含此要求的簽章區塊所附加之 FixedDocument 元件中的頁碼。

[in] x

頁面上簽署點的 X 座標值。

[in] y

頁面上簽署點的 Y 座標值。

方法會傳回 HRESULT。可能的值包括但不限於下列資料表中的值。如需此表格中未列出的傳回值，請參閱 XPS 數位簽章 API 錯誤和 XPS 檔錯誤。

傳回碼	描述
S_OK	此方法已成功。
E_UNEXPECTED	介面未連線到簽章管理員。

簽署點的位置是在頁面左上角的 XPS 單位中指定。每英吋 96 個 XPS 單位。