次の方法で共有

ITfRange::ShiftEnd メソッド (msctf.h)

  • [アーティクル]

範囲の終了アンカーを移動します。

構文

HRESULT ShiftEnd(
  [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 にすることができます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 メソッドは正常に実行されました。
E_FAIL
 未指定のエラーが発生しました。
E_INVALIDARG
 1 つ以上のパラメーターが無効です。
TF_E_NOLOCK
 ec によって識別される編集コンテキストには、読み取り専用ロックがありません。

解説

範囲の開始位置と終了位置をアンカーと呼びます。

このメソッドは、領域の境界を越えてアンカーを移動することはできません。 シフトが領域の境界に達した場合、実際にシフトされた文字数は要求よりも少なくなります。 ITfRange::ShiftEndRegion は、アンカーを隣接する領域にシフトするために使用されます。

シフト操作によって範囲の終了アンカーが開始アンカーの後に移動する場合、開始アンカーは終了アンカーと同じ場所に移動します。

ITfRange::ShiftEnd には長い操作を指定できます。 パフォーマンスを向上させるには、可能な場合 は ITfRange::ShiftEndToRange を 使用します。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー msctf.h
[DLL] Msctf.dll
再頒布可能パッケージ Windows 2000 Professional の TSF 1.0

関連項目

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfRange

ITfRange::ShiftEndRegion

ITfRange::ShiftStart

TF_HALTCOND