ScriptStringXtoCP 函数 (usp10.h)

将 x 坐标转换为字符位置。

语法

HRESULT ScriptStringXtoCP(
  [in]  SCRIPT_STRING_ANALYSIS ssa,
  [in]  int                    iX,
  [out] int                    *piCh,
  [out] int                    *piTrailing
);

参数

[in] ssa

字符串 的SCRIPT_STRING_ANALYSIS 结构。

[in] iX

x 坐标。

[out] piCh

指向变量的指针,此函数在其中检索对应于 x 坐标的字符位置。

[out] piTrailing

指向变量的指针,此函数在其中检索一个值,该值指示 x 坐标是字符位置的前导边缘还是尾边缘。 有关详细信息,请参见“备注”部分。

返回值

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

注解

如果 x 坐标对应于字符的前边缘,则 piTrailing 的值为 0。 如果 x 坐标对应于字符的尾边,则 piTrailing 的值是正整数。 对于 ScriptXtoCP,对于可以单独呈现的字符,该值为 1。 如果字符是脚本中未放置游标的群集的一部分,则该值大于 1,以指示下一个合法逻辑游标位置的偏移量。

如果 x 坐标位于行的开头之前,则 函数将检索 -1( piCh )和 1( piTrailing),指示行前不存在字符的尾边。 如果 x 坐标在线条的末尾之后,则函数将检索 piCh 超出线条长度的第一个索引,为 piTrailing 检索 0。 0 值指示行后不存在字符的前边缘。

重要从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

Uniscribe

Uniscribe 函数