ScriptCPtoX 函式 (usp10.h)
從回合的左端或前置邊緣產生 x 位移至邏輯字元 叢集的前置或尾端邊緣。
語法
HRESULT ScriptCPtoX(
[in] int iCP,
[in] BOOL fTrailing,
[in] int cChars,
[in] int cGlyphs,
[in] const WORD *pwLogClust,
[in] const SCRIPT_VISATTR *psva,
[in] const int *piAdvance,
[in] const SCRIPT_ANALYSIS *psa,
[out] int *piX
);
參數
[in] iCP
執行中的邏輯字元位置。 此參數對應於叢集中任何邏輯字元的位移。
[in] fTrailing
TRUE 表示使用邏輯字元叢集的尾端邊緣來計算位移。 此參數設定為 FALSE ，以使用邏輯字元叢集的前置邊緣。
[in] cChars
執行中的字元數。
[in] cGlyphs
執行中的字元數目。
[in] pwLogClust
邏輯叢集的指標。
[in] psva
視覺屬性SCRIPT_VISATTR陣列的指標。
[in] piAdvance
進階寬度值的指標。
[in] psa
SCRIPT_ANALYSIS 結構的指標。 fLogicalOrder 成員會指定要從中測量位移的執行結尾。 如果設定旗標，則會使用執行的前置邊緣。 如果未設定旗標，則會使用回合的左端。
[out] piX
函式擷取插入號 x 位置的緩衝區指標。
傳回值
若成功，即傳回 0。 如果非零 HRESULT 值失敗，此函式會傳回非零的 HRESULT 值。 應用程式可以使用 SUCCEEDED 和 FAILED 宏來測試傳回值。
備註
字元的開頭或尾端邊緣和執行的前置邊緣取決於執行中的文字方向。
對於插入號在 (叢集中間的腳本，例如阿拉伯文和希伯來文) ，擷取的 x 位置可以是行中任何字碼點的插補位置。
對於以傳統方式貼齊叢集界限的腳本 (，例如泰文和印度) ，x 位置會貼齊至叢集的要求邊緣，其中包含 iCP 所指示邏輯字元位置的叢集。
重要從 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 或更新版本 |