ITfContext::SetSelection メソッド (msctf.h)

文書内の選択範囲を設定します。

構文

HRESULT SetSelection(
  [in] TfEditCookie       ec,
  [in] ULONG              ulCount,
  [in] const TF_SELECTION *pSelection
);

パラメーター

[in] ec

編集セッションを識別する編集 Cookie が含まれています。 これは、 ITfEditSession::D oEditSession に渡される値です。

[in] ulCount

pSelection 配列内の選択範囲の数を指定します。

[in] pSelection

各選択範囲の情報を含む TF_SELECTION 構造体の配列。

戻り値

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

値	説明
S_OK	メソッドは正常に実行されました。
TF_E_NOSELECTION	ドキュメントに選択がありません。
TF_E_NOLOCK	ec の Cookie が無効です。

注釈

選択範囲は、強調表示されたテキストのスパン、またはスパンが空の場合は挿入ポイントであり、文書内のユーザー フォーカス領域を識別します。 一部のドキュメントでは、複数の選択を行うことができます。 pSelection では、ドキュメント キャレットの位置を表しているため、長さ 0 の選択は 1 つだけです。

アプリケーションで選択範囲の対象となるテキストを調整する必要がある場合は、呼び出し元がロックを解除するまで待機する必要があります。 ただし、アプリケーションは、S_OKを返しながら、TF_SELECTION構造体のスタイル メンバーを調整できます。

呼び出し元は、1 つの選択が設定されている場合にのみ 、fInterimChar フラグを設定できます。 この場合、選択範囲は 1 文字にまたがり、TF_SELECTION構造体の ase メンバーは TFAE_NONE に設定されます。

要件

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

こちらもご覧ください

ITfContext インターフェイス、 ITfEditSession::D oEditSession、 TF_SELECTION 構造体、 ITfContext::GetSelection