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

[アーティクル]
08/24/2023

ITfRange::AdjustForInsert メソッドは、テキストの挿入に合わせて調整するテキストの範囲を展開または縮小します。

構文

HRESULT AdjustForInsert(
  [in]  TfEditCookie ec,
  [in]  ULONG        cchInsert,
  [out] BOOL         *pfInsertOk
);

パラメーター

[in] ec

ITfDocumentMgr::CreateContext または ITfEditSession::D oEditSession から取得した Cookie を編集します。

[in] cchInsert

挿入されたテキストの文字数。この数は、 ITfRange::SetText への futurecall で使用されます。文字数が不明な場合は、0 を使用できます。

[out] pfInsertOk

コンテキスト所有者が挿入を受け入れる (TRUE) か拒否 (FALSE) かを示すフラグへのポインター。

戻り値

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

値	説明
S_OK	メソッドは正常に実行されました。
E_FAIL	メソッドが失敗しました。
E_INVALIDARG	1 つ以上のパラメーターが無効です。
E_NOTIMPL	アプリケーションで選択内容を置き換えることができませんでした。
TF_E_NOLOCK	ec パラメーターの値が無効な Cookie であるか、呼び出し元に読み取り専用ロックがありません。

注釈

編集を開始する前に、このメソッドを使用して、新しいコンポジションを開始する範囲を準備する必要があります。テキストが現在の選択範囲に挿入されていない場合にのみ使用する必要があります。 ITFInsertAtSelection:InsertTextAtSelection または ITfInsertAtSelection::InsertEmbeddedAtSelection は、テキストが現在の選択範囲に挿入されるときに使用する正しいメソッドです。

コンテキスト所有者は、このメソッドを使用して動作を保持し、一貫したユーザーエクスペリエンスを維持できます。たとえば、コンテキスト内の特定の文字またはオブジェクトを変更から保持したり、貧困をサポートしたりできます。

既存のコンポジションを変更する場合、このメソッドは必要ありません。 ITfRange::SetText を直接呼び出して、呼び出し元が以前に入力したテキストを変更することは許容されます。

終了時に *pfInsertOk が FALSE に設定されている場合、この範囲で ITfRange::SetText または ITfRange::InsertEmbedded への今後の呼び出しが失敗する可能性があります。それ以外の場合、 *pfInsertOk は TRUE に設定され、範囲開始アンカーまたは終了アンカーはコンテキスト所有者の判断で再配置できます。

要件

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