AddKeyboardShortcut()

Syntax

AddKeyboardShortcut(#Window, Shortcut, Event)
Beschreibung
Fügt einen Tastatur-Shortcut ("Tastenkürzel") zum angegebenen Fenster hinzu. Ein Shortcut generiert ein Menü-Ereignis (wie ein Menü-Eintrag), da sie meistens im Zusammenhang mit Menüs benutzt werden.

Parameter

#Window Das zu verwendende Fenster.
Shortcut Dies kann eine der folgenden Konstanten sein: 
  #PB_Shortcut_Back
  #PB_Shortcut_Tab
  #PB_Shortcut_Clear
  #PB_Shortcut_Return
  #PB_Shortcut_Menu
  #PB_Shortcut_Pause
  #PB_Shortcut_Print       (Druck)
  #PB_Shortcut_Capital
  #PB_Shortcut_Escape
  #PB_Shortcut_Space       (Leertaste)
  #PB_Shortcut_PageUp      (Bild auf)
  #PB_Shortcut_PageDown    (Bild ab)
  #PB_Shortcut_End         (Ende)
  #PB_Shortcut_Home        (Pos 1)
  #PB_Shortcut_Left        (Cursor links)
  #PB_Shortcut_Up          (Cursor hoch)
  #PB_Shortcut_Right       (Cursor rechts)
  #PB_Shortcut_Down        (Cursor runter)
  #PB_Shortcut_Select
  #PB_Shortcut_Execute
  #PB_Shortcut_Snapshot
  #PB_Shortcut_Insert      (Einfg)
  #PB_Shortcut_Delete      (Entf)
  #PB_Shortcut_Help
  #PB_Shortcut_0
  #PB_Shortcut_1
  #PB_Shortcut_2
  #PB_Shortcut_3
  #PB_Shortcut_4
  #PB_Shortcut_5
  #PB_Shortcut_6
  #PB_Shortcut_7
  #PB_Shortcut_8
  #PB_Shortcut_9
  #PB_Shortcut_A
  #PB_Shortcut_B
  #PB_Shortcut_C
  #PB_Shortcut_D
  #PB_Shortcut_E
  #PB_Shortcut_F
  #PB_Shortcut_G
  #PB_Shortcut_H
  #PB_Shortcut_I
  #PB_Shortcut_J
  #PB_Shortcut_K
  #PB_Shortcut_L
  #PB_Shortcut_M
  #PB_Shortcut_N
  #PB_Shortcut_O
  #PB_Shortcut_P
  #PB_Shortcut_Q
  #PB_Shortcut_R
  #PB_Shortcut_S
  #PB_Shortcut_T
  #PB_Shortcut_U
  #PB_Shortcut_V
  #PB_Shortcut_W
  #PB_Shortcut_X
  #PB_Shortcut_Y
  #PB_Shortcut_Z
  #PB_Shortcut_LeftWindows
  #PB_Shortcut_RightWindows
  #PB_Shortcut_Apps
  #PB_Shortcut_Pad0
  #PB_Shortcut_Pad1
  #PB_Shortcut_Pad2
  #PB_Shortcut_Pad3
  #PB_Shortcut_Pad4
  #PB_Shortcut_Pad5
  #PB_Shortcut_Pad6
  #PB_Shortcut_Pad7
  #PB_Shortcut_Pad8
  #PB_Shortcut_Pad9
  #PB_Shortcut_Multiply
  #PB_Shortcut_Add
  #PB_Shortcut_Separator
  #PB_Shortcut_Subtract
  #PB_Shortcut_Decimal
  #PB_Shortcut_Divide
  #PB_Shortcut_F1
  #PB_Shortcut_F2
  #PB_Shortcut_F3
  #PB_Shortcut_F4
  #PB_Shortcut_F5
  #PB_Shortcut_F6
  #PB_Shortcut_F7
  #PB_Shortcut_F8
  #PB_Shortcut_F9
  #PB_Shortcut_F10
  #PB_Shortcut_F11
  #PB_Shortcut_F12
  #PB_Shortcut_F13
  #PB_Shortcut_F14
  #PB_Shortcut_F15
  #PB_Shortcut_F16
  #PB_Shortcut_F17
  #PB_Shortcut_F18
  #PB_Shortcut_F19
  #PB_Shortcut_F20
  #PB_Shortcut_F21
  #PB_Shortcut_F22
  #PB_Shortcut_F23
  #PB_Shortcut_F24
  #PB_Shortcut_Numlock
  #PB_Shortcut_Scroll
Die oben angegebene Taste kann mit jeder der folgenden Konstanten kombiniert werden: 
  #PB_Shortcut_Shift
  #PB_Shortcut_Control
  #PB_Shortcut_Alt
  #PB_Shortcut_Command
Event Der Wert, welcher vom EventMenu() Befehl zurückgegeben wird. Dieser Wert hat einen begrenzten Gültigkeitsbereich, von 0 bis 64000. Standardmäßig hat ein Fenster bereits die #PB_Shortcut_Tab und #PB_Shortcut_Tab|#PB_Shortcut_Shift Shortcuts, um die Tabulator und Shift-Tabulator Tasten(kombinationen) durch die Gadgets korrekt zu handhaben. Ein Shortcut kann mittels RemoveKeyboardShortcut() entfernt werden.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Anmerkungen

Die #PB_Shortcut_Command Konstante ist nur nützlich auf Mac OSX und ermöglicht die Verwendung der 'Apfel'-Taste (links oder rechts) zur Definition von Tastenkürzeln. Diese Konstante wird auch auf anderen OS unterstützt (um die Portierbarkeit zu vereinfachen), agiert dort jedoch wie #PB_Shortcut_Control. Die Tastenkürzel Apple+Q und Apple+P sind auf Mac OSX für die #PB_Menu_Quit und #PB_Menu_Preferences Menü-Einträge im Anwendungs-Menü vordefiniert und können nicht erneut zugewiesen werden.

Beispiel

  AddKeyboardShortcut(0, #PB_Shortcut_Control | #PB_ShortCut_F, 15) ; Erstellt ein Tastaturkürzel 'CTRL+F' (STRG-F) für das Fenster 0,
                                                                    ; welches nach Tastendruck ein Menüereignis '15' liefert

Beispiel: Erweitertes Beispiel mit Tastenkürzel für Menü-Einträge und ohne diese ("standalone")

  #Window = 0
  Enumeration Menu
    #Menu
    #PopupMenu
  EndEnumeration
  Enumeration Menu_items
    #mOpen
    #mCopy
    #mDummy
  EndEnumeration
  
  If OpenWindow(#Window, 200, 200, 200, 100, "Press Ctrl+D")
    If CreateMenu(#Menu, WindowID(#Window))  ; Erstelle ein reguläres Menü mit Titel und einem Eintrag
      MenuTitle("File")
      MenuItem(#mOpen, "Open" + #TAB$ + "Ctrl+O")
    EndIf
    If CreatePopupMenu(#PopupMenu)  ; Erstelle ein zusätzliches Pop-up Menü
      MenuItem(#mCopy, "Copy" + #TAB$ + "Ctrl+Shift+C")
    EndIf
    AddKeyboardShortcut(#Window, #PB_Shortcut_Control | #PB_Shortcut_D, #mDummy)  ; Tastenkürzel 'standalone' (ohne Menü-Eintrag)
    AddKeyboardShortcut(#Window, #PB_Shortcut_Control | #PB_Shortcut_O, #mOpen)   ; Tastenkürzel für den Menü-Eintrag
    AddKeyboardShortcut(#Window, #PB_Shortcut_Control | #PB_Shortcut_Shift | #PB_Shortcut_C, #mCopy)  ; Tastenkürzel für den Pop-up Menü-Eintrag
    Repeat
      Select WaitWindowEvent()
        Case #PB_Event_RightClick  ; Zeige das Pop-up Menü nach einem rechten Mausklick
          DisplayPopupMenu(#PopupMenu, WindowID(#Window))
        Case #PB_Event_Menu
          Select EventMenu()
            Case #mDummy : Debug "Dummy"
            Case #mOpen : Debug "Open"
            Case #mCopy : Debug "Copy"
          EndSelect
        Case #PB_Event_CloseWindow
          End
      EndSelect
    ForEver
  EndIf

Siehe auch

RemoveKeyboardShortcut()

Unterstützte OS

Alle

Window Inhaltsverzeichnis - AddWindowTimer() ->