scriptStringGetOrder 函数 (usp10.h)

创建将原始字符位置映射到字形位置的数组。

语法

HRESULT ScriptStringGetOrder(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [out] UINT                   *puOrder
);

参数

[in] ssa

字符串 的SCRIPT_STRING_ANALYSIS 结构。

[out] puOrder

指向缓冲区的指针,此函数在其中检索标志符号位置数组,按原始字符位置编制索引。 数组应至少有空间容纳ScriptString_pcOutChars的 ssa 参数指示的整数数。

返回值

如果成功,则返回S_OK。 如果函数不成功,则返回非零 HRESULT 值。 应用程序可以使用 SUCCEEDEDFAILED 宏测试返回值。

注解

当字形数和字符数相等时,函数将检索引用每个字形的数组。 这与 GetCharacterPlacement 中的处理方式相同。

若要使用此函数,应用程序需要在对 ScriptStringAnalyse 的原始调用中指定SSA_GLYPHS。

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

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 usp10.h
Library Usp10.lib
DLL Usp10.dll
可再发行组件 Windows Me/98/95 上的 Internet Explorer 5 或更高版本

另请参阅

SCRIPT_STRING_ANALYSIS

ScriptStringAnalyse

ScriptString_pcOutChars

Uniscribe

Uniscribe 函数