Méthode ITfTextInputProcessor ::Activate (msctf.h)

Active un service de texte lors du démarrage d’une session utilisateur.

Syntaxe

HRESULT Activate(
  [in] ITfThreadMgr *ptim,
  [in] TfClientId   tid
);

Paramètres

[in] ptim

Pointeur vers l’interface ITfThreadMgr pour le gestionnaire de threads propriétaire du service de texte.

[in] tid

Spécifie l’identificateur du client pour le service de texte.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

TSF appelle cette méthode après avoir créé un instance d’un service de texte avec un appel à CoCreateInstance. Cela permet d’effectuer les opérations nécessaires au démarrage du service de texte.

Cette méthode ajoute généralement une référence au gestionnaire de threads pour la session et conseille les récepteurs pour les événements qui impliquent le service de texte, tels que le changement de focus, les frappes et les événements de fenêtre. Il personnalise également la barre de langue pour le service de texte.

La méthode ITfTextInputProcessor ::D eactivate correspondante qui arrête le service de texte doit libérer toutes les références au paramètre ptim .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msctf.h
DLL	Sptip.dll
Composant redistribuable	TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITfTextInputProcessor

ITfTextInputProcessor ::D eactivate

ITfThreadMgr