Freigeben über


ITfProperty::Clear-Methode (msctf.h)

Leert den Eigenschaftswert über den angegebenen Bereich.

Syntax

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

Parameter

[in] ec

Enthält ein Bearbeitungscooky, das den Bearbeitungskontext identifiziert. Dies wird von ITfDocumentMgr::CreateContext oder ITfEditSession::D oEditSession abgerufen.

[in] pRange

Zeiger auf eine ITfRange-Schnittstelle , die den Bereich enthält, für den die Eigenschaft gelöscht wird. Wenn dieser Parameter NULL ist, werden alle Werte für diese Eigenschaft über den gesamten Bearbeitungskontext gelöscht.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert BESCHREIBUNG
S_OK
Die Methode war erfolgreich.
E_INVALIDARG
pRange ist ungültig.
TF_E_NOLOCK
Der von ec identifizierte Bearbeitungskontext verfügt nicht über eine Lese-/Schreibsperre.
TF_E_READONLY
Der Bearbeitungskontext ist schreibgeschützt.
TF_E_NOTOWNEDRANGE
Der TSF-Manager besitzt den Bereich nicht.

Hinweise

Es ist nicht erforderlich, diese Methode aufzurufen, wenn ein Kontext zerstört werden soll. Der TSF-Manager löscht alle Eigenschaften, wenn der Kontext aus dem Kontextstapel entfernt wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile msctf.h
DLL Msctf.dll
Verteilbare Komponente TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfRange