IXpsOMPath：：SetFillBrushLookup 方法 (xpsobjectmodel.h)

设置资源字典中共享画笔的查找键名称，以用作填充画笔。

语法

HRESULT SetFillBrushLookup(
  [in] LPCWSTR lookup
);

参数

[in] lookup

资源字典中要用作填充画笔的画笔的键名称。

返回值

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

返回代码	说明
S_OK	方法成功。
XPS_E_INVALID_RESOURCE_KEY	根据 XML 纸张规范， 查找 的值不是有效的查找键字符串。
XPS_E_INVALID_LOOKUP_TYPE	lookup 中的查找键名称引用不是画笔的对象。
XPS_E_LOOKUP_NOT_FOUND	找不到具有与 查找中传递的值匹配的键名称的对象。

注解

调用 SetFillBrushLookup 后，将释放本地填充画笔，GetFillBrushLocal 在 brush 参数中返回 NULL 指针。 下表解释了此属性的本地值和查阅值之间的关系。

最近调用的方法	GetFillBrush 在画笔中返回的对象	GetFillBrushLocal 在画笔中返回的对象	GetFillBrushLookup 在查找中返回的字符串
SetFillBrushLocal	由 SetFillBrushLocal 设置的本地画笔。	由 SetFillBrushLocal 设置的本地画笔。	NULL 指针。
SetFillBrushLookup (此方法)	使用与 SetFillBrushLookup 设置的键匹配的查找键从资源目录检索的共享画笔。	NULL 指针。	由 SetFillBrushLookup 设置的查找键。
尚未调用 SetFillBrushLocal 和 SetFillBrushLookup 。	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

另请参阅

IXpsOMPath

XML 纸张规范

XPS 文档错误