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 值。 应用程序可以使用 SUCCEEDED 和 FAILED 宏测试返回值。
注解
如果 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 或更高版本 |