ブラシに使用する共有マトリックス変換インターフェイスの参照キーの名前を取得します。
キー名は、リソース ディクショナリ内の共有リソースを識別します。
構文
HRESULT GetTransformLookup(
[out, retval] LPWSTR *key
);
パラメーター
[out, retval] key
ブラシに使用する共有マトリックス変換インターフェイスの参照キーの名前。 参照キー名が設定されていない場合、またはローカル マトリックス変換が設定されている場合は、 NULL ポインターが返されます。
このパラメーターで返される値は、ルックアップ キーまたは変換を設定するために最後に呼び出されたメソッドによって異なります。
| 呼び出された最新のメソッド | キーで返される文字列 |
|---|---|
| NULL ポインター。 | |
| SetTransformLookup によって設定されるキー。 | |
| SetTransformLocal も SetTransformLookup もまだ呼び出されていません。 | NULL ポインター。 |
戻り値
このメソッドは HRESULT を返します。 使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。 この表に記載されていない XPS ドキュメント API の戻り値については、「 XPS ドキュメント エラー」を参照してください。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
key は NULL です。 |
注釈
このメソッドは IXpsOMMatrixTransform インターフェイス ポインターを返しません。ディクショナリからこのポインターを取得するには、 IXpsOMDictionary::GetByKey を呼び出します。
変換によって、グラデーションの変換方法が決まります。 イメージに最終的にレンダリングされるグラデーションの可視部分は、グラデーション ブラシを使用しているパス、ストローク、またはグリフによって決まります。
このメソッドは、 キーで返される文字列によって使用されるメモリを割り当てます。 key が NULL でない場合は、CoTaskMemFree 関数を使用してメモリを解放します。
要件
| サポートされている最小のクライアント | Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | xpsobjectmodel.h |