IXpsOMVisualBrush::GetVisual メソッド (xpsobjectmodel.h)

ブラシのソースとして使用される解決済みビジュアルのインターフェイスへのポインターを取得します。

構文

HRESULT GetVisual(
  [out, retval] IXpsOMVisual **visual
);

[out, retval] visual

ブラシのソースとして使用される解決済みビジュアルオブジェクトの IXpsOMVisual インターフェイスへのポインター。ビジュアルが設定されていない場合は、 NULL ポインターが返されます。

このパラメーターで返される値は、ビジュアルオブジェクトを設定するために最後に呼び出されたメソッドによって異なります。

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

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

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

このメソッドは、 IXpsOMVisual インターフェイスポインターを返します。ただし、
返されるインターフェイスには、IXpsOMCanvas、IXpsOMPath、IXpsOMGlyphs など、IXpsOMVisual から継承する任意のインターフェイスを指定できます。

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