Metodo ITfProperty::Clear (msctf.h)

Svuota il valore della proprietà sull'intervallo specificato.

Sintassi

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

Parametri

[in] ec

Contiene un cookie di modifica che identifica il contesto di modifica. Questa operazione viene ottenuta da ITfDocumentMgr::CreateContext o ITfEditSession::D oEditSession.

[in] pRange

Puntatore a un'interfaccia ITfRange che contiene l'intervallo per cui la proprietà viene cancellata. Se questo parametro è NULL, tutti i valori per questa proprietà sull'intero contesto di modifica vengono cancellati.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	pRange non è valido.
TF_E_NOLOCK	Il contesto di modifica identificato da ec non ha un blocco di lettura/scrittura.
TF_E_READONLY	Il contesto di modifica è di sola lettura.
TF_E_NOTOWNEDRANGE	Il gestore TSF non possiede l'intervallo.

Commenti

Non è necessario chiamare questo metodo quando un contesto sta per essere distrutto. Il gestore TSF cancella tutte le proprietà quando il contesto viene rimosso dallo stack di contesto.

Requisiti

Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	msctf.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfRange