IXpsOMVisualBrush::GetVisual 方法 (xpsobjectmodel.h)

获取指向要用作画笔源的已解析视觉对象的接口的指针。

语法

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

参数

[out, retval] visual

指向用作画笔源的已解析视觉对象的 IXpsOMVisual 接口的指针。 如果尚未设置视觉对象,则返回 NULL 指针。

此参数中返回的值取决于最近调用了哪个方法来设置视觉对象。

最近调用的方法 在视觉对象中返回的对象

SetVisualLocal

SetVisualLocal 设置的视觉对象。

SetVisualLookup

从资源目录检索到的视觉对象,其中包含与 SetVisualLookup 设置的键匹配的查找键。
尚未调用 SetVisualLocalSetVisualLookup NULL 指针。

返回值

该方法返回 HRESULT。 可能的值包括但不限于后面的表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息,请参阅 XPS 文档错误

返回代码 说明
S_OK
方法成功。
E_POINTER
visualNULL
XPS_E_LOOKUP_INVALID_TYPE
SetStrokeBrushLookup 设置的查找键名称引用不是画笔的对象。
XPS_E_LOOKUP_NOT_FOUND
找不到具有与查找值匹配的键名称的对象。

注解

此方法返回 IXpsOMVisual 接口指针。 但是,
返回的接口可以是继承自 IXpsOMVisual 的任何接口,例如 IXpsOMCanvasIXpsOMPathIXpsOMGlyphs

要求

要求
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 xpsobjectmodel.h

另请参阅

IXpsOMCanvas

IXpsOMGlyphs

IXpsOMPath

IXpsOMVisual

IXpsOMVisualBrush

XML 纸张规范

XPS 文档错误