IXpsOMVisual：：GetOpacityMaskBrush 方法 (xpsobjectmodel.h)

获取指向视觉对象不透明度蒙板画笔的 IXpsOMBrush 接口的指针。

语法

HRESULT GetOpacityMaskBrush(
  [out, retval] IXpsOMBrush **opacityMaskBrush
);

[out, retval] opacityMaskBrush

指向视觉对象的不透明度蒙板画笔的 IXpsOMBrush 接口的指针。如果尚未为此视觉对象设置不透明蒙板画笔，则返回 NULL 指针。

此参数中返回的值取决于最近调用的方法来设置画笔。

最近调用的方法	以 opacityMaskBrush 返回的对象
SetOpacityMaskBrushLocal	由 SetOpacityMaskBrushLocal 设置的局部不透明蒙板画笔。
SetOpacityMaskBrushLookup	检索到的共享不透明蒙板画笔，其查找键与资源目录中的 SetOpacityMaskBrushLookup 设置的键匹配。
尚未调用 SetOpacityMaskBrushLocal 和 SetOpacityMaskBrushLookup 。	NULL 指针。

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

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

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