共用方式為


iTfProperty::Clear 方法 (msctf.h)

在指定的範圍中清空屬性值。

語法

HRESULT Clear(
  [in] TfEditCookie ec,
  [in] ITfRange     *pRange
);

參數

[in] ec

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

[in] pRange

ITfRange介面的指標,其中包含已清除屬性的範圍。 如果此參數為 Null,則會清除整個編輯內容上此屬性的所有值。

傳回值

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

描述
S_OK
此方法成功。
E_INVALIDARG
pRange 無效。
TF_E_NOLOCK
ec所識別的編輯內容沒有讀取/寫入鎖定。
TF_E_READONLY
編輯內容是唯讀的。
TF_E_NOTOWNEDRANGE
TSF 管理員不會擁有範圍。

備註

當內容即將終結時,就不需要呼叫這個方法。 當內容從內容堆疊中移除時,TSF 管理員將會清除所有屬性。

需求

   
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 msctf.h
Dll Msctf.dll
可轉散發套件 Windows 2000 專業版上的 TSF 1.0

另請參閱

ITfDocumentMgr::CreateCoNtext

ITfEditSession::D oEditSession

ITfProperty

ITfRange