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

Article
08/24/2023

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

Partager via