IXpsOMGlyphsEditor::SetGlyphMappings 方法 (xpsobjectmodel.h)

设置 XPS_GLYPH_MAPPING 结构的数组,这些结构描述如何将 UnicodeString 属性中的 UTF-16 标量值映射到 XPS_GLYPH_INDEX 结构数组中的条目。

语法

HRESULT SetGlyphMappings(
  [in] UINT32                  glyphMappingCount,
  [in] const XPS_GLYPH_MAPPING *glyphMappings
);

参数

[in] glyphMappingCount

数组中由 glyphMappings 引用的XPS_GLYPH_MAPPING结构的数目。 值为 0 将清除 属性。

[in] glyphMappings

包含字形映射值的 XPS_GLYPH_MAPPING 结构数组。 如果 glyphMappingCount 为 0,则忽略此参数并可以设置为 NULL

返回值

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

返回代码 说明
S_OK
方法成功。
E_INVALIDARG
一个或多个 XPS_GLYPH_MAPPING 结构的成员具有无效的值。 在以下情况下可能会发生这种情况:字符串长度和起始位置的总和小于起始位置;索引位置和索引长度之和小于起始位置;索引的长度为 0。
E_POINTER
glyphMappingsNULL,glyphMappingCount 大于 0。
XPS_E_MAPPING_OUT_OF_ORDER
在一个或多个 XPS_GLYPH_MAPPING 结构中,元素不按顺序排列。

要求

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

另请参阅

IXpsOMGlyphsEditor

XML 纸张规范

XPS 文档错误

XPS_GLYPH_MAPPING