(msctf.h) ITfProperty：：SetValue 方法

設定範圍之 屬性的值。

語法

HRESULT SetValue(
  [in] TfEditCookie  ec,
  [in] ITfRange      *pRange,
  [in] const VARIANT *pvarValue
);

參數

[in] ec

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

[in] pRange

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

[in] pvarValue

包含新屬性值之 VARIANT 結構的指標。 僅支援類型為 VT_I4、VT_UNKNOWN、VT_BSTR 和 VT_EMPTY的值。

傳回值

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

值	描述
S_OK	此方法成功。
E_INVALIDARG	一或多個參數無效。
E_OUTOFMEMORY	發生記憶體配置失敗。
E_FAIL	發生未指定的錯誤。
TF_E_NOLOCK	ec 所識別的編輯內容沒有讀取/寫入鎖定。
TF_E_READONLY	編輯內容是唯讀的。
TF_E_NOTOWNEDRANGE	TSF 管理員不會擁有範圍。

備註

當修改屬性值涵蓋的文字時，將會捨棄以這個方法設定的屬性值。 若要取得文字編輯值回應的自定義控制權，請使用 ITfProperty：：SetValueStore。

使用這個方法設定的值會串行化，但不會串行化類型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：：SetValueStore

ITfRange