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 值。 应用程序可以使用 SUCCEEDEDFAILED 宏测试返回值。

注解

此函数使用一对一替换,其中应用程序可以将一个字形替换为一种备用形式。 大多数情况下,应用程序使用此函数在行的开头或结尾设置项目符号或备用字形。

重要从 Windows 8 开始:若要保持在 Windows 7 上运行的能力,使用 Uniscribe 的模块必须在其库列表中指定 gdi32.lib 之前的 Usp10.lib。
 

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 usp10.h
Library Usp10.lib
DLL Usp10.dll
可再发行组件 在 Windows XP 上 Usp10.dll 版本 1.600 或更高版本

另请参阅

缓存

OPENTYPE_TAG

SCRIPT_ANALYSIS

SCRIPT_CACHE

ScriptGetFontAlternateGlyphs

ScriptItemizeOpenType

Uniscribe

Uniscribe 函数