IXpsOMVisual：：SetOpacityMaskBrushLocal 方法 (xpsobjectmodel.h)
将 IXpsOMBrush 接口指针设置为本地非共享不透明度蒙板画笔。
语法
HRESULT SetOpacityMaskBrushLocal(
[in] IXpsOMBrush *opacityMaskBrush
);
参数
[in] opacityMaskBrush
指向要设置为本地非共享不透明度蒙板画笔的 IXpsOMBrush 接口的指针。 NULL 指针清除以前分配的不透明蒙板画笔。
返回值
该方法返回 HRESULT。 可能的值包括但不限于下表中的值。 有关此表中未列出的 XPS 文档 API 返回值的信息，请参阅 XPS 文档错误。
| 返回代码 | 说明 |
|---|---|
|
方法成功。 |
|
opacityMaskBrush 不指向已识别的接口实现。 不支持 XPS 文档 API 接口的自定义实现。 |
注解
调用 SetOpacityMaskBrushLocal 后，将释放不透明蒙板画笔查找键，并且 GetOpacityMaskBrushLookup 在 key 参数中返回 NULL 指针。 下表说明了此属性的本地值和查找值之间的关系。
| 最近调用的方法 | GetOpacityMaskBrush 以 opacityMaskBrush 返回的对象 | GetOpacityMaskBrushLocal 在 opacityMaskBrush 中返回的对象 | GetOpacityMaskBrushLookup 在键中返回的字符串 |
|---|---|---|---|
| setOpacityMaskBrushLocal (此方法) | 由 SetOpacityMaskBrushLocal 设置的局部不透明蒙板画笔。 | 由 SetOpacityMaskBrushLocal 设置的局部不透明蒙板画笔。 | NULL 指针。 |
| 检索到的共享不透明蒙板画笔，其查找键与资源目录中的 SetOpacityMaskBrushLookup 设置的键匹配。 | NULL 指针。 | 由 SetOpacityMaskBrushLookup 设置的查找键。 | |
| 尚未调用 SetOpacityMaskBrushLocal 和 SetOpacityMaskBrushLookup 。 | 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 |