IXpsOMGlyphsEditor::SetGlyphIndices 方法 (xpsobjectmodel.h)

设置一个 XPS_GLYPH_INDEX 结构数组,用于描述字体中要使用的字形索引。

语法

HRESULT SetGlyphIndices(
  [in] UINT32                indexCount,
  [in] const XPS_GLYPH_INDEX *glyphIndices
);

参数

[in] indexCount

glyphIndices 引用的数组中XPS_GLYPH_INDEX结构的数目。 值为 0 会清除 属性。

[in] glyphIndices

包含字形索引 的XPS_GLYPH_INDEX 结构的数组。 如果 indexCount 为 0,则忽略此参数。

返回值

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

返回代码 说明
S_OK
方法成功。
E_INVALIDARG
一个或多个XPS_GLYPH_INDEX结构的索引字段具有无效的值。 索引字段的值必须介于 和 之间,包括 –1 和 65535 (0xFFFF) 。
E_POINTER
glyphIndicesNULL,indexCount 大于 0。
XPS_E_INVALID_FLOAT
一个或多个XPS_GLYPH_INDEX结构的 advanceWidthhorizontalOffsetverticalOffset 字段具有无效的浮点值。
XPS_E_NEGATIVE_FLOAT
一个或多个XPS_GLYPH_INDEX结构的 advanceWidth 字段具有无效的值。 advanceWidth 字段必须具有非负值或恰好为 –1.0 的值;不完全为 –1.0 的负值无效。

注解

glyphIndices 中传递的字形索引将覆盖从 UnicodeString 属性到字形索引的默认 cmap 映射。 每个 XPS_GLYPH_INDEX 结构还具有前进宽度以及垂直和水平偏移信息。

要求

要求
最低受支持的客户端 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_INDEX