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 介面指標。
傳回值
這個方法可以傳回其中一個值。
值 | 描述 |
---|---|
|
此方法成功。 |
|
一或多個參數無效。 |
|
發生未指定的錯誤。 |
|
ec所識別的編輯內容沒有讀取/寫入鎖定。 |
備註
使用 ITfProperty::SetValue 設定的屬性值,將會在修改屬性值涵蓋的文字時捨棄。 若要控制修改文字時屬性值會發生什麼情況,請使用 ITfProperty::SetValueStore 。
使用 ITfProperty::SetValue 設定的值將會序列化,但不會序列化類型VT_UNKNOWN的值除外。 如果必須序列化類型VT_UNKNOWN的屬性值,請改用 ITfProperty::SetValueStore 。
不支援相同類型的重迭屬性值。
需求
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | msctf.h |
Dll | Msctf.dll |
可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |