(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的值。
傳回值
這個方法可以傳回下列其中一個值。
| 值 | 描述 |
|---|---|
|
此方法成功。 |
|
一或多個參數無效。 |
|
發生記憶體配置失敗。 |
|
發生未指定的錯誤。 |
|
ec 所識別的編輯內容沒有讀取/寫入鎖定。 |
|
編輯內容是唯讀的。 |
|
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 |