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

プロパティ ストア オブジェクトを使用して、テキスト範囲の プロパティの値を設定します。

構文

HRESULT SetValueStore(
  [in] TfEditCookie     ec,
  [in] ITfRange         *pRange,
  [in] ITfPropertyStore *pPropStore
);

パラメーター

[in] ec

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

[in] pRange

プロパティ値が設定されている範囲を含む ITfRange インターフェイスへのポインター。 このパラメーターを NULL にすることはできません。 pRange が空の場合、このメソッドは失敗します。

[in] pPropStore

プロパティ データを取得する ITfPropertyStore インターフェイスへのポインター。

戻り値

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

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

解説

ITfProperty::SetValue で設定されたプロパティ値は、プロパティ値の対象となるテキストが変更されると破棄されます。 テキストが変更されたときにプロパティ値がどうなるかを制御するには、 ITfProperty::SetValueStore を使用します。

ITfProperty::SetValue で設定された値は、シリアル化されない型VT_UNKNOWNの値を除き、シリアル化されます。 VT_UNKNOWN型のプロパティ値をシリアル化する必要がある場合は、代わりに ITfProperty::SetValueStore を 使用します。

同じ型の重複するプロパティ値はサポートされていません。

要件

サポートされている最小のクライアント	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

ITfProperty

ITfProperty::SetValue

ITfPropertyStore

ITfRange