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 函数