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 単位で指定されます。 1 インチあたり 96 個の XPS ユニットがあります。


サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	xpsdigitalsignature.h