Share via


ITfProperty::SetValueStore 方法 (msctf.h)

使用屬性存放區物件設定文字範圍的 屬性值。

語法

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

參數

[in] ec

包含可識別編輯內容的編輯 Cookie。 這是從 ITfDocumentMgr::CreateCoNtextITfEditSession::D oEditSession取得。

[in] pRange

ITfRange介面的指標,其中包含屬性值設定的範圍。 此參數不可為 Null。 如果 pRange 是空的,這個方法就會失敗。

[in] pPropStore

取得屬性資料的 ITfPropertyStore 介面指標。

傳回值

這個方法可以傳回其中一個值。

描述
S_OK
此方法成功。
E_INVALIDARG
一或多個參數無效。
E_FAIL
發生未指定的錯誤。
TF_E_NOLOCK
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

另請參閱

ITfDocumentMgr::CreateCoNtext

ITfEditSession::D oEditSession

ITfProperty

ITfProperty::SetValue

ITfPropertyStore

ITfRange