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 所指示邏輯字元位置的叢集。

規格需求

另請參閱

SCRIPT_ANALYSIS

SCRIPT_VISATTR

ScriptXtoCP

Uniscribe

Uniscribe 函式