Méthode ITfKeystrokeMgr::AdviseKeyEventSink (msctf.h)

Article
08/24/2023

Installe un récepteur d’événements clés pour recevoir des événements de clavier.

Syntaxe

HRESULT AdviseKeyEventSink(
  [in] TfClientId      tid,
  [in] ITfKeyEventSink *pSink,
  [in] BOOL            fForeground
);

Paramètres

[in] tid

Identificateur du client propriétaire du récepteur d’événements de clé. Cette valeur est obtenue par un appel précédent à ITfThreadMgr::Activate.

[in] pSink

Pointeur vers une interface ITfKeyEventSink .

[in] fForeground

Spécifie si ce récepteur d’événements clés est fait du récepteur d’événements de clé de premier plan. Si cette valeur est TRUE, ce récepteur d’événements clés est fait du récepteur d’événements de clé de premier plan. Sinon, ce récepteur d’événements clés ne devient pas le récepteur d’événements de clé de premier plan.

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	Un ou plusieurs paramètres ne sont pas valides.
CONNECT_E_ADVISELIMIT	Un récepteur d’événements clés est installé pour le client identifié par tid .

Notes

Le récepteur d’événements de touche de premier plan reçoit tous les événements de clavier. Un récepteur d’événements de clé non au premier plan reçoit uniquement les clés conservées et les événements clés qui se produisent sur du texte marqué appartenant à l’identificateur du client.

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

ITfKeyEventSink

ITfKeystrokeMgr

ITfThreadMgr::Activate

Partager via