Freigeben über


KeyPress-Ereignis

Tritt auf, wenn der Benutzer eine Taste drückt und freigibt.

PROCEDURE Object.KeyPress
LPARAMETERS [nIndex,] nKeyCode, nShiftAltCtrl

Parameter

Sie müssen in der Ereignisprozedur eine LPARAMETERS- oder PARAMETERS-Anweisung sowie einen Namen für jeden Parameter einbeziehen.

  • nIndex
    Kennzeichnet ein Steuerelement eindeutig, wenn es sich in einem Steuerelementarray befindet.

  • nKeyCode
    Enthält die Nummer für die gedrückte Taste. Eine Liste mit den Codes für Sondertasten und Tastenkombinationen finden Sie unter INKEY( ).

  • nShiftAltCtrl
    Legt ein Bit fest, wenn eine Zusatztaste gedrückt gehalten und gleichzeitig die in nKeyCode identifizierte Taste gedrückt wird.

    Gültige Zusatztasten sind die UMSCHALTTASTE, STRG und die ALT-Tasten.

    Die in nShiftAltCtrl zurückgegebenen Werte für einzelne Zusatztasten sind in der folgenden Tabelle aufgelistet.

    Zusatztastenwerte für nShiftAltCtrl

    Taste Value
    UMSCHALTTASTE 1
    STRG 2
    ALT 4

    Dieser Parameter ist die Summe der Bits, wobei die Bits mit den kleinsten Werten der UMSCHALT- (Bit 0), STRG- (Bit 1) und ALT-TASTE (Bit 2 ) entsprechen.

    Diese Bits entsprechen den Werten 1, 2 und 4. Dieser Parameter zeigt den Zustand dieser Tasten an. Einige, alle oder kein Bit können festgelegt sein. Dadurch wird angegeben, dass einige, alle oder keine Taste gedrückt wurde. Wird z. B. sowohl STRG als auch ALT gedrückt, lautet der Wert für nShiftAltCtrl 6.

Hinweise

Das Objekt mit dem Fokus erhält das Ereignis.

Ein Formular kann das KeyPress-Ereignis in drei Sonderfällen erhalten:

  • Das Formular enthält keine Steuerelemente oder keines der Steuerelemente ist sichtbar und aktiviert.
  • Die KeyPreview-Eigenschaft des Formulars ist auf Wahr (.T.) festgelegt. Zuerst erhält das Formular das KeyPress-Ereignis und anschließend erhält das Steuerelement mit dem Fokus das Ereignis.
  • Wenn ein Steuerelement auf dem Formular einen Tastenanschlag nicht verarbeiten kann (wenn z. B. TAB gedrückt wird, um den Fokus auf das nächste Steuerelement zu positionieren).

Ein KeyPress-Ereignis ist nützlich zum Abfangen von Tastenanschlägen, die in ein Steuerelement eingegeben werden. Sie können damit Tastenanschläge sofort auf Gültigkeit überprüfen oder Zeichen beim Eingeben formatieren. Mit Hilfe der KeyPreview-Eigenschaft können globale Tastaturbehandlungsroutinen erstellt werden.

Das KeyPress-Ereignis tritt nicht bei Tastenkombinationen mit der Taste ALT auf.

Siehe auch

INKEY( ) | KeyPreview-Eigenschaft

Betrifft: Kontrollkästchen-Steuerelement (CheckBox) | Kombinationsfeld-Steuerelement (ComboBox) | Befehlsschaltflächen-Steuerelement (CommandButton) | Bearbeitungsfeld-Steuerelement | Formularobjekt (Form) | Listenfeld-Steuerelement (ListBox) | Optionsfeld-Steuerelement (OptionButton) | Drehfeld-Steuerelement (Spinner Control) | Textfeld-Steuerelement (TextBox)