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

こちらもご覧ください

IXpsOMCanvas

IXpsOMGlyphs

IXpsOMPath

IXpsOMVisual

IXpsOMVisualBrush

XML Paper Specification

XPS ドキュメント エラー