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 表示行前不存在字元的尾端邊緣。 如果 x 座標在線條結尾之後，則函式會擷取 超出 線條長度的第一個索引，而 piTrailing 則為 0。 0 值表示行后不存在字元的前置邊緣。
重要從 Windows 8 開始：若要維護在 Windows 7 上執行的能力，使用 Uniscribe 的模組必須在其連結庫清單中指定 gdi32.lib 之前指定 Usp10.lib。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | usp10.h |
| 程式庫 | Usp10.lib |
| Dll | Usp10.dll |
| 可轉散發套件 | Windows Me/98/95 上的 Internet Explorer 5 或更新版本 |