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を返します。 関数は、成功しない場合は 0 以外の HRESULT 値を返します。 アプリケーションでは、 SUCCEEDED マクロと FAILED マクロを使用して戻り値をテストできます。
注釈
x 座標が文字の上端に対応する場合、 piTrailing の値は 0 です。 x 座標が文字の末尾の端に対応する場合、 piTrailing の値は正の整数です。 ScriptXtoCP の場合、独自にレンダリングできる文字の値は 1 です。 次の正当な論理カーソル位置へのオフセットを示すために、文字がクラスター内にカーソルが配置されていないスクリプト内のクラスターの一部である場合、値は 1 より大きくなります。
x 座標が行の先頭の前にある場合、関数は piCh の場合は -1、 piTrailing の場合は -1 を取得し、行の前に存在しない文字の末尾の端を示します。 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 のインターネット エクスプローラー 5 以降 |