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	glyphMappings 为 NULL，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