IXpsOMVisual::SetClipGeometryLookup メソッド (xpsobjectmodel.h)
リソース ディクショナリ内の共有クリップ ジオメトリの参照キー名を設定します。
構文
HRESULT SetClipGeometryLookup(
[in] LPCWSTR key
);
パラメーター
[in] key
ディクショナリ内のクリップ ジオメトリの参照キー名。 NULL ポインターは、以前に割り当てられたキー名をクリアします。
戻り値
このメソッドは HRESULT を返します。 使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。 この表に記載されていない XPS ドキュメント API の戻り値については、「 XPS ドキュメント エラー」を参照してください。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
XML Paper Specification によると、lookup の値は有効な参照キー文字列ではありません。 |
|
キー内の参照キー名は、ジオメトリではないオブジェクトを参照します。 |
|
key で渡された値と一致するキー名を持つオブジェクトが見つかりませんでした。 |
注釈
SetClipGeometryLookup を呼び出すと、ローカル クリップ ジオメトリが解放され、GetClipGeometryLocal は clipGeometry パラメーターに NULL ポインターを返します。 次の表では、このプロパティのローカル値と参照値の関係について説明します。
| 呼び出された最新のメソッド | GetClipGeometry によって clipGeometry で返されるオブジェクト | GetClipGeometryLocal によって clipGeometry で返されるオブジェクト | GetClipGeometryLookup によってキーで返される文字列 |
|---|---|---|---|
| SetClipGeometryLocal によって設定されるローカル クリップ ジオメトリ。 | SetClipGeometryLocal によって設定されるローカル クリップ ジオメトリ。 | NULL ポインター。 | |
| SetClipGeometryLookup (このメソッド) | リソース ディレクトリから SetClipGeometryLookup によって設定されたキーと一致するルックアップ キーを使用して取得される共有クリップ ジオメトリ。 | NULL ポインター。 | SetClipGeometryLookup によって設定される参照キー。 |
| SetClipGeometryLookup も SetClipGeometryLocal もまだ呼び出されていません。 | NULL ポインター。 | NULL ポインター。 | NULL ポインター。 |
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | xpsobjectmodel.h |