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

ブラシのソースとして使用されるローカルで共有されていないビジュアルのインターフェイスポインターを設定します。

構文

HRESULT SetVisualLocal(
  [in] IXpsOMVisual *visual
);

[in] visual

ブラシのビジュアルとして設定する IXpsOMVisual インターフェイスへのポインター。ローカルビジュアルが設定されている場合、 NULL ポインターを渡すと解放されます。

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

リターンコード	説明
S_OK	メソッドが成功しました。
XPS_E_NO_CUSTOM_OBJECTS	visual は、認識されたインターフェイスの実装を指していません。 XPS ドキュメント API インターフェイスのカスタム実装はサポートされていません。

SetVisualLocal を呼び出すと、ビジュアル参照キーが解放され、GetVisualLookup は参照パラメーターに NULL ポインターを返します。次の表では、このプロパティのローカル値と参照値の関係について説明します。

呼び出された最新のメソッド	GetVisual によってビジュアルで返されるオブジェクト	GetVisualLocal によってビジュアルで返されるオブジェクト	GetVisualLookup によってルックアップで返される文字列
SetVisualLocal (このメソッド)。	SetVisualLocal によって設定されるビジュアル。	SetVisualLocal によって設定されるビジュアル。	NULL ポインター。
SetVisualLookup	リソースディレクトリから SetVisualLookup によって設定されたキーと一致する参照キーを使用して取得されるビジュアル。	NULL ポインター。	SetVisualLookup によって設定される参照キー。
SetVisualLocal も SetVisualLookup もまだ呼び出されていません。	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