ITfProperty::Clear メソッド (msctf.h)

指定した範囲のプロパティ値を空にします。

構文

HRESULT Clear(
  [in] TfEditCookie ec,
  [in] ITfRange     *pRange
);

[in] ec

編集コンテキストを識別する編集 Cookie が含まれています。これは、 ITfDocumentMgr::CreateContext または ITfEditSession::D oEditSession から取得されます。

[in] pRange

プロパティがクリアされる範囲を含む ITfRange インターフェイスへのポインター。このパラメーターが NULL の場合、編集コンテキスト全体にわたるこのプロパティのすべての値がクリアされます。

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

値	説明
S_OK	メソッドは正常に実行されました。
E_INVALIDARG	pRange が無効です。
TF_E_NOLOCK	ec によって識別される編集コンテキストには、読み取り/書き込みロックがありません。
TF_E_READONLY	編集コンテキストは読み取り専用です。
TF_E_NOTOWNEDRANGE	TSF マネージャーは範囲を所有していません。

コンテキストが破棄されようとしている場合は、このメソッドを呼び出す必要はありません。コンテキストがコンテキストスタックから削除されると、TSF マネージャーはすべてのプロパティをクリアします。


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