IXpsOMPage::GenerateUnusedLookupKey 方法 (xpsobjectmodel.h)
生成一个唯一名称,该名称可由资源字典中的资源用作查找键。
语法
HRESULT GenerateUnusedLookupKey(
[in] XPS_OBJECT_TYPE type,
[out, retval] LPWSTR *key
);
参数
[in] type
为其生成查找键的 IXpsOMShareable 对象的类型。
[out, retval] key
此方法生成的查找键字符串。
返回值
如果 方法成功,则返回S_OK;否则,它将返回 HRESULT 错误代码。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
key 为 NULL。 |
|
type 是指无法识别的对象类型。 |
注解
为了在字典中是唯一的, GenerateUnusedLookupKey 生成的字符串由基于对象类型的前缀字符串组成,后跟四个唯一的字母数字字符。
下表显示了每种对象类型的前缀字符串。
对象类型 | 此对象类型的前缀字符串 |
---|---|
XPS_OBJECT_TYPE_CANVAS | 帆布_ |
XPS_OBJECT_TYPE_GEOMETRY | 几何_ |
XPS_OBJECT_TYPE_GLYPHS | 符号_ |
XPS_OBJECT_TYPE_IMAGE_BRUSH | IBrush_ |
XPS_OBJECT_TYPE_LINEAR_GRADIENT_BRUSH | LGBrush_ |
XPS_OBJECT_TYPE_MATRIX_TRANSFORM | MTransform_ |
XPS_OBJECT_TYPE_PATH | 路径_ |
XPS_OBJECT_TYPE_RADIAL_GRADIENT_BRUSH | RGBrush_ |
XPS_OBJECT_TYPE_SOLID_COLOR_BRUSH | SCBrush_ |
XPS_OBJECT_TYPE_VISUAL_BRUSH | VBrush_ |
注意
此方法返回在此页上下文中唯一的键字符串。 不保证返回可在多个页面使用的远程字典资源中唯一的密钥。
要求
最低受支持的客户端 | Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | xpsobjectmodel.h |