Freigeben über

ITfKeystrokeMgr::KeyUp-Methode (msctf.h)

  • Artikel

Übergibt ein Key Up-Ereignis an den Tastatureingabe-Manager.

Syntax

HRESULT KeyUp(
  [in]  WPARAM wParam,
  [in]  LPARAM lParam,
  [out] BOOL   *pfEaten
);

Parameter

[in] wParam

Gibt den Virtuellen Schlüsselcode des Schlüssels an. Weitere Informationen zu diesem Parameter finden Sie im wParam-Parameter in WM_KEYUP.

[in] lParam

Gibt die Wiederholungsanzahl, den Scancode, das Flag für erweiterte Schlüssel, den Kontextcode, das vorherige Schlüsselzustandsflag und das Übergangszustandsflag des Schlüssels an. Weitere Informationen zu diesem Parameter finden Sie im lParam-Parameter in WM_KEYUP.

[out] pfEaten

Zeiger auf eine BOOL, die beim Beenden angibt, ob das Schlüsselereignis behandelt wird. Wenn dieser Wert TRUE empfängt, wird das Schlüsselereignis behandelt, und das Ereignis sollte nicht an die Anwendung weitergeleitet werden. Wenn dieser Wert FALSE ist, wird das Schlüsselereignis nicht behandelt, und das Ereignis sollte an die Anwendung weitergeleitet werden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert BESCHREIBUNG
S_OK
 Die Methode war erfolgreich.
S_FALSE
 Es werden keine Schlüsselereignissenken installiert.
E_INVALIDARG
 Mindestens ein Parameter ist ungültig.

Hinweise

Wenn diese Methode erfolgreich ist und pfEaten TRUE empfängt, sollte die Anwendung das Key Down-Ereignis nicht verarbeiten. Wenn diese Methode nicht S_OK zurückgibt oder pfEaten FALSE empfängt, sollte die Anwendung das Key Down-Ereignis verarbeiten. Im Folgenden finden Sie ein Beispiel dafür, wie dies implementiert wird.


if(msg.message == WM_KEYUP)
{
    if( pKeyboardMgr->TestKeyUp(msg.wParam, msg.lParam, &fEaten) == S_OK 
        && fEaten 
        && pKeyboardMgr->KeyUp(msg.wParam, msg.lParam, &fEaten) == S_OK 
        && fEaten)
    {
        //The key was handled by the keystroke manager or a TSF text service. Do not pass the key to the application. 
        continue;
    }
    else
    {
        //Let the application process the key. 
    }
}

Wenn der Tastatureingabe-Manager das Schlüsselereignis nicht behandelt, übergibt er das Schlüsselereignis durch einen Aufruf der ITfKeyEventSink::OnKeyUp-Methode an die Textdienste.

Anforderungen

Anforderung Wert
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