AddKeyboardShortcut()

Syntaxe

AddKeyboardShortcut(#Fenetre, Raccourci, Evenement)

Ajoute ou remplace un raccourci clavier.

Arguments

#Fenetre	La fenêtre à utiliser.
Raccourci	Le raccourci clavier peut prendre l'une des valeurs suivantes: #PB_Shortcut_Back (Retour Arrière) #PB_Shortcut_Tab (Tabulation) #PB_Shortcut_Clear #PB_Shortcut_Return (Entrée) #PB_Shortcut_Menu (Alt) #PB_Shortcut_Pause #PB_Shortcut_Print #PB_Shortcut_Capital (Verrouillage Majuscule) #PB_Shortcut_Escape (Echap) #PB_Shortcut_Space (Espace) #PB_Shortcut_PageUp (Page précédente) #PB_Shortcut_PageDown (Page Suivante) #PB_Shortcut_End (Fin) #PB_Shortcut_Home (Début) #PB_Shortcut_Left (Flèche à gauche) #PB_Shortcut_Up (Flèche en haut) #PB_Shortcut_Right (Flèche à droite) #PB_Shortcut_Down (Flèche en bas) #PB_Shortcut_Select #PB_Shortcut_Execute #PB_Shortcut_Snapshot (Impr écran) #PB_Shortcut_Insert #PB_Shortcut_Delete (Suppr) #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 (Touche fenêtre main gauche) #PB_Shortcut_RightWindows (Touche fenêtre main droite) #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 (Arrêt défil) Les touches de raccourci ci-dessus peuvent être combinées avec les valeurs ci-dessous si nécessaire: #PB_Shortcut_Shift : 'Shift' ou 'Majuscule' #PB_Shortcut_Control: 'Control' ou 'CTRL' #PB_Shortcut_Alt : 'Alt' #PB_Shortcut_Command: 'Apple' ou 'Pomme' (MacOS X)
Evenement	Un nombre unique défini par l'utilisateur qui permet d'identifier le raccourci clavier. Ce nombre doit être compris entre 0 et 64000 et il correspond à l'évènement de type menu qui lui est associé. Par défaut, une fenêtre a déjà 2 raccourcis clavier pour permettre les déplacements entre les gadgets avec la touche 'Tab' (Tabulation) et 'Shift+Tab' (Majuscule + Tabulation): #PB_Shorcut_Tab et #PB_Shortcut_Tab|#PB_Shortcut_Shift

Remarques

Un raccourci génère un évènement de type menu (comme le ferait un élément de menu) car la plupart du temps les raccourcis sont utilisés en conjonction avec les menus.
La constante #PB_Shortcut_Command est seulement utile sous MacOS X et permet d'utiliser la touche 'Apple' (droite ou gauche). Cette constante est aussi supportée sur les autres OS (pour faciliter la portabilité) et elle aura alors un rôle identique à #PB_Shortcut_Control.

Un raccourci clavier peut être enlevé avec RemoveKeyboardShortcut().

Exemple

  AddKeyboardShortcut(0, #PB_Shortcut_Control | #PB_ShortCut_F, 15) ; Crée un raccourci clavier CTRL+F sur la fenêtre 0
                                                                    ; qui générera un évènement de valeur 15.

Exemple: Exemple étendu avec des raccourcis clavier avec ou sans menu

  #Window = 0
  Enumeration Menu
    #Menu
    #PopupMenu
  EndEnumeration
  Enumeration Menu_elements
    #mOuvrir
    #mCopier
    #mFactice
  EndEnumeration
  
  If OpenWindow(#Window, 200, 200, 600, 100, "Appuyer sur Ctrl+D  |  Ctrl+O  |  Ctrl+Maj+C")
    If CreateMenu(#Menu, WindowID(#Window))  ; Créer un menu standard avec un titre et un élément de menu
      MenuTitle("Fichier")
      MenuItem(#mOuvrir, "Ouvrir" + #TAB$ + "Ctrl+O")
    EndIf
    If CreatePopupMenu(#PopupMenu)  ; Créer un menu contextuel supplémentaire
      MenuItem(#mCopier, "Copier" + #TAB$ + "Ctrl+Shift+C")
    EndIf
    AddKeyboardShortcut(#Window, #PB_Shortcut_Control | #PB_Shortcut_D, #mFactice)  ; Raccourci clavier autonome (sans élément de menu)
    AddKeyboardShortcut(#Window, #PB_Shortcut_Control | #PB_Shortcut_O, #mOuvrir)   ; Raccourci pour l'élément de menu
    AddKeyboardShortcut(#Window, #PB_Shortcut_Control | #PB_Shortcut_Shift | #PB_Shortcut_C, #mCopier)  ; Raccourci pour l'élément de menu contextuel
    Repeat
      Select WaitWindowEvent()
        Case #PB_Event_RightClick  ; Afficher le menu contextuel avec le clic droit de la souris
          DisplayPopupMenu(#PopupMenu, WindowID(#Window))
        Case #PB_Event_Menu
          Select EventMenu()
            Case #mFactice : Debug "Autonome"
            Case #mOuvrir : Debug "Ouvrir"
            Case #mCopier : Debug "Copier"
          EndSelect
        Case #PB_Event_CloseWindow
          End
      EndSelect
    ForEver
  EndIf

Voir aussi

RemoveKeyboardShortcut()

OS Supportés

Tous