ITfRange::ShiftStart メソッド (msctf.h)
範囲の開始アンカーを移動します。
構文
HRESULT ShiftStart(
[in] TfEditCookie ec,
[in] LONG cchReq,
[out] LONG *pcch,
[in] const TF_HALTCOND *pHalt
);
パラメーター
[in] ec
編集コンテキストを識別する編集 Cookie が含まれています。 これは、 ITfDocumentMgr::CreateContext または ITfEditSession::D oEditSession から取得されます。
[in] cchReq
開始アンカーがシフトされる文字数を格納します。 負の値を指定すると、アンカーが後方に移動し、正の値を指定するとアンカーが前方に移動します。
[out] pcch
アンカーがシフトされた文字数を受け取る LONG 値へのポインター。
[in] pHalt
シフトに関する条件を含む TF_HALTCOND 構造体へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| 値 | 説明 |
|---|---|
|
メソッドは正常に実行されました。 |
|
1 つ以上のパラメーターが無効です。 |
|
未指定のエラーが発生しました。 |
|
ec によって識別される編集コンテキストには、読み取り専用ロックがありません。 |
解説
範囲の開始位置と終了位置をアンカーと呼びます。
このメソッドは、領域の境界を越えてアンカーを移動することはできません。 シフトが領域の境界に達した場合、実際にシフトされた文字数は要求よりも少なくなります。 ITfRange::ShiftStartRegion は、アンカーを隣接する領域にシフトするために使用されます。
シフト操作によって範囲開始アンカーが終了アンカーの後に移動する場合、終了アンカーは開始アンカーと同じ位置に移動します。
ITfRange::ShiftStart には長い操作を指定できます。 パフォーマンスを向上させるには、可能な場合 は ITfRange::ShiftStartToRange を使用します。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | msctf.h |
| [DLL] | Msctf.dll |
| 再頒布可能パッケージ | Windows 2000 Professional の TSF 1.0 |