IXpsOMTileBrush::SetTransformLookup メソッド (xpsobjectmodel.h)
このブラシの変換として使用される共有マトリックス変換の参照キー名を設定します。参照キーによって参照される共有マトリックス変換は、リソース ディクショナリに格納されます。
構文
HRESULT SetTransformLookup(
[in] LPCWSTR key
);
パラメーター
[in] key
リソース ディクショナリ内の共有マトリックス変換の参照キー名を含む文字列変数。 ルックアップ キーが既に設定されている場合は、 NULL ポインターによってクリアされます。
戻り値
このメソッドは HRESULT を返します。 使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。 この表に記載されていない XPS ドキュメント API の戻り値については、「 XPS ドキュメント エラー」を参照してください。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
XML Paper Specification によると、lookup の値は有効な参照キー文字列ではありません。 |
|
キー内の参照キー名は、ジオメトリではないオブジェクトを参照します。 |
|
key で渡された値と一致するキー名を持つオブジェクトが見つかりませんでした。 |
注釈
変換は、タイル ブラシを使用しているパス、ストローク、またはグリフでブラシ イメージがレンダリングされる前に適用されます。 タイル ブラシには変換が 1 つだけあり、ローカルまたはリモートにすることができます。
SetTransformLookup を呼び出すと、ローカル変換が解放され、GetTransformLocal は変換パラメーターに NULL ポインターを返します。 次の表では、このプロパティのローカル値と参照値の関係について説明します。
| 呼び出された最新のメソッド | GetTransform によって変換で返されるオブジェクト | GetTransformLocal によって変換で返されるオブジェクト | GetTransformLookup によってキーで返される文字列 |
|---|---|---|---|
| SetTransformLocal によって設定される変換。 | SetTransformLocal によって設定される変換。 | NULL ポインター。 | |
| SetTransformLookup (このメソッド) | SetTransformLookup によって設定されたキーと一致するルックアップ キーを使用して、リソース ディレクトリから取得される変換。 | NULL ポインター。 | SetTransformLookup によって設定される参照キー。 |
| SetTransformLocal も SetTransformLookup もまだ呼び出されていません。 | 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 |