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 インターフェイスへのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| 値 | 説明 |
|---|---|
|
メソッドは正常に実行されました。 |
|
1 つ以上のパラメーターが無効です。 |
|
未指定のエラーが発生しました。 |
|
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 |