ScriptSubstituteSingleGlyph 函数 (usp10.h)

项目
03/03/2024

允许使用同一标志符号的一种替代形式替换单个字形，以便进行 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 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 或更高版本