ITfIntegratableCandidateListUIElement::OnKeyDown-Methode (ctffunc.h)

Artikel
03/01/2024

Verarbeitet einen Tastendruck.

Syntax

HRESULT OnKeyDown(
  [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_KEYDOWN.

[in] lParam

Gibt die Wiederholungsanzahl, den Scancode, das Flag mit erweiterter Taste, den Kontextcode, das vorherige Schlüsselstatusflaggen und das Übergangsstatusflagge des Schlüssels an. Weitere Informationen zu diesem Parameter finden Sie im lParam-Parameter in WM_KEYDOWN.

[out] pfEaten

TRUE , wenn das Schlüsselereignis behandelt wurde; andernfalls FALSE.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Mit der OnKeyDown-Methode kann eine App den Textdienst abfragen, wenn sie einen bestimmten Schlüssel in einem Integrationsstil verarbeiten möchte. Das Verhalten der OnKeyDown-Methode kann vom Integrationsstil abhängen. Wenn der Textdienst *pfEaten=TRUE zurückgibt, sollte die App keine Verarbeitung des Schlüssels durchführen. Wenn FALSE zurückgegeben wird, kann die App eine eigene Aktion als Reaktion auf den Schlüssel ausführen.

GUID_INTEGRATIONSTYLE_SEARCHBOX ({E6D1BD11-82F7-4903-AE21-1A6397CDE2EB}) ermöglicht die Implementierung einer Tastatureingabe, bei der der Benutzer den wahrgenommenen Tastaturfokus vom Suchfeld auf die Kandidatenliste verschieben kann, um Suchvorschläge zu erhalten. Der Textdienst kann Schlüssel wie VK_UP und VK_DOWN verarbeiten, bevor search sie verarbeitet, um seinen internen Zustand zu ändern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ctffunc.h

Weitere Informationen

ITfIntegratableCandidateListUIElement

Freigeben über