scriptGetFontLanguageTags 函数 (usp10.h)

项目
08/26/2023

检索可用于指定项且受 OpenType 处理的指定脚本标记支持的语言标记列表。从指定设备上下文或缓存中的字体检索构成列表的标记。

语法

HRESULT ScriptGetFontLanguageTags(
  [in, optional] HDC             hdc,
  [in, out]      SCRIPT_CACHE    *psc,
  [in, optional] SCRIPT_ANALYSIS *psa,
  [in]           OPENTYPE_TAG    tagScript,
  [in]           int             cMaxTags,
  [out]          OPENTYPE_TAG    *pLangsysTags,
  [out]          int             *pcTags
);

参数

[in, optional] hdc

设备上下文的句柄。有关详细信息，请参阅缓存。

[in, out] psc

指向标识脚本缓存的SCRIPT_CACHE 结构的指针。

[in, optional] psa

指向从先前调用 ScriptItemizeOpenType 获取的 SCRIPT_ANALYSIS 结构的指针。此参数标识整形引擎，以便可以检索相应字体和脚本的字体语言标记。

或者，应用程序可以将此参数设置为 NULL 以检索未筛选的结果。

[in] tagScript

一个OPENTYPE_TAG结构，用于定义为其请求关联语言标记列表的脚本标记。

[in] cMaxTags

pLangSysTags 指定的数组的长度。

[out] pLangsysTags

指向缓冲区的指针，此函数在其中检索标识与输入条件匹配的语言标记的OPENTYPE_TAG 结构的数组。

[out] pcTags

指向语言标记数组中元素数的指针。

返回值

如果成功，则返回 0。如果函数不成功，则返回非零 HRESULT 值。应用程序可以使用 SUCCEEDED 和 FAILED 宏测试返回值。

如果匹配标记数超过 cMaxTags，则函数将失败并E_OUTOFMEMORY。应用程序可以尝试使用较大的缓冲区再次调用。

注解

虽然正式声明为 ULONG 类型，但 OPENTYPE_TAG 结构包含一个 4 字节数组，其中包含空间 A-Z 或 a-z 的四个 8 位 ASCII 值。例如，罗马尼亚语、乌尔都语和波斯语的语言标记分别为“ROM”、“URD”和“FAR”。请注意，每个标记以空格结尾。

重要从 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 或更高版本