共用方式為

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 或更新版本

另請參閱

SCRIPT_STRING_ANALYSIS

Uniscribe

Uniscribe 函式