ScriptSubstituteSingleGlyph 函数 (usp10.h)
允许使用同一标志符号的一种替代形式替换单个字形,以便进行 OpenType 处理。
语法
HRESULT ScriptSubstituteSingleGlyph(
[in, optional] HDC hdc,
[in, out] SCRIPT_CACHE *psc,
[in, optional] SCRIPT_ANALYSIS *psa,
[in] OPENTYPE_TAG tagScript,
[in] OPENTYPE_TAG tagLangSys,
[in] OPENTYPE_TAG tagFeature,
[in] LONG lParameter,
[in] WORD wGlyphId,
[out] WORD *pwOutGlyphId
);
参数
[in, optional] hdc
设备上下文的句柄。 有关详细信息,请参阅 缓存。
[in, out] psc
指向指示脚本缓存 的SCRIPT_CACHE 结构的指针。
[in, optional] psa
指向从先前调用 ScriptItemizeOpenType 获取的 SCRIPT_ANALYSIS 结构的指针。 此参数标识整形引擎,以便使用正确的替代字形。
或者,应用程序可以将此参数设置为 NULL 以检索未筛选的结果。
[in] tagScript
定义要调整的脚本标记的 OPENTYPE_TAG 结构。
[in] tagLangSys
定义要塑造的语言标记的 OPENTYPE_TAG 结构。
[in] tagFeature
一个OPENTYPE_TAG结构,用于定义要用于塑造备用字形的功能标记。
[in] lParameter
对要替换的备用字形的引用。 此引用是数组的索引,该数组包含功能中定义的所有备用字形,如 OPENTYPE_FEATURE_RECORD所示。 备用字形数组是由 ScriptGetFontAlternateGlyphs 检索到的项之一。
[in] wGlyphId
原始字形的标识符。
[out] pwOutGlyphId
指向此函数检索备用字形标识符的位置的指针。
返回值
如果成功,则返回 0。 如果函数不成功,则返回非零 HRESULT 值。 应用程序可以使用 SUCCEEDED 和 FAILED 宏测试返回值。
注解
此函数使用一对一替换,其中应用程序可以将一个字形替换为一种备用形式。 大多数情况下,应用程序使用此函数在行的开头或结尾设置项目符号或备用字形。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | usp10.h |
Library | Usp10.lib |
DLL | Usp10.dll |
可再发行组件 | 在 Windows XP 上 Usp10.dll 版本 1.600 或更高版本 |