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、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 \|UWP 应用]
目标平台	Windows
标头	xpsobjectmodel.h