ITfProperty::Clear, méthode (msctf.h)

  • Article

Vide la valeur de la propriété sur la plage spécifiée.

Syntaxe

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

Paramètres

[in] ec

Contient un cookie de modification qui identifie le contexte de modification. Ceci est obtenu à partir de ITfDocumentMgr::CreateContext ou ITfEditSession::D oEditSession.

[in] pRange

Pointeur vers une interface ITfRange qui contient la plage pour laquelle la propriété est effacée. Si ce paramètre a la valeur NULL, toutes les valeurs de cette propriété sur l’ensemble du contexte de modification sont effacées.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur Description
S_OK
 La méthode a réussi.
E_INVALIDARG
 pRange n’est pas valide.
TF_E_NOLOCK
 Le contexte d’édition identifié par ec n’a pas de verrou en lecture/écriture.
TF_E_READONLY
 Le contexte de modification est en lecture seule.
TF_E_NOTOWNEDRANGE
 Le gestionnaire TSF n’est pas propriétaire de la plage.

Notes

Il n’est pas nécessaire d’appeler cette méthode lorsqu’un contexte est sur le point d’être détruit. Le gestionnaire TSF efface toutes les propriétés lorsque le contexte est supprimé de la pile de contextes.

Spécifications

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête msctf.h
DLL Msctf.dll
Composant redistribuable TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITfDocumentMgr::CreateContext

ITfEditSession::D oEditSession

ITfProperty

ITfRange