Share via


ITfKeystrokeMgr::AdviseKeyEventSink-Methode (msctf.h)

Installiert eine Schlüsselereignissenke, um Tastaturereignisse zu empfangen.

Syntax

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

Parameter

[in] tid

Bezeichner des Clients, der die Schlüsselereignissenke besitzt. Dieser Wert wird durch einen vorherigen Aufruf von ITfThreadMgr::Activate abgerufen.

[in] pSink

Zeiger auf eine ITfKeyEventSink-Schnittstelle .

[in] fForeground

Gibt an, ob diese Schlüsselereignissenke zur Vordergrundschlüsselereignissenke gemacht wird. Wenn dies TRUE ist, wird diese Schlüsselereignissenke zur Ereignissenke des Vordergrundschlüssels gemacht. Andernfalls wird diese Schlüsselereignissenke nicht zur Vordergrundschlüsselereignissenke.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert BESCHREIBUNG
S_OK
Die Methode war erfolgreich.
E_INVALIDARG
Mindestens ein Parameter ist ungültig.
CONNECT_E_ADVISELIMIT
Auf dem durch tid identifizierten Client ist eine Schlüsselereignissenke installiert.

Hinweise

Die Vordergrundtasten-Ereignissenke empfängt alle Tastaturereignisse. Eine Nicht-Vordergrund-Schlüsselereignissenke empfängt nur beibehaltene Schlüssel und Schlüsselereignisse, die über Text auftreten, der dem Clientbezeichner gehört.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile msctf.h
DLL Msctf.dll
Verteilbare Komponente TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfKeyEventSink

ITfKeystrokeMgr

ITfThreadMgr::Activate