IXpsOMGradientBrush::GetTransform メソッド (xpsobjectmodel.h)

ブラシの解決されたマトリックス変換を含む IXpsOMMatrixTransform インターフェイスへのポインターを取得します。

構文

HRESULT GetTransform(
  [out, retval] IXpsOMMatrixTransform **transform
);

[out, retval] transform

ブラシの解決された行列変換を含む IXpsOMMatrixTransform インターフェイスへのポインター。変換が設定されていない場合は、 NULL ポインターが返されます。

このパラメーターで返される値は、変換を設定するために最後に呼び出されたメソッドによって異なります。

呼び出された最新のメソッド	変換で返されるオブジェクト
SetTransformLocal	SetTransformLocal によって設定されるローカル変換。
SetTransformLookup	リソースディレクトリから SetTransformLookup によって設定されたキーと一致する参照キーを使用して取得される共有変換。
SetTransformLocal も SetTransformLookup もまだ呼び出されていません。	NULL ポインター。

このメソッドは HRESULT を返します。使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。この表に記載されていない XPS ドキュメント API の戻り値については、「 XPS ドキュメントエラー」を参照してください。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	transform は NULL です。
XPS_E_LOOKUP_INVALID_TYPE	SetStrokeBrushLookup によって設定された参照キー名は、ブラシではないオブジェクトを参照します。
XPS_E_LOOKUP_NOT_FOUND	参照値に一致するキー名を持つオブジェクトが見つかりませんでした。ルックアップで渡された値と一致するキー名を持つオブジェクトが見つかりませんでした。

変換によって、グラデーションの変換方法が決まります。イメージに最終的にレンダリングされるグラデーションの可視部分は、グラデーションブラシを使用しているパス、ストローク、またはグリフによって決まります。

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 および Windows Vista 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	xpsobjectmodel.h