====== OpenBox: Les Raccourcis Clavier ======
Les raccourcis clavier permettent de lancer des applications, des scripts, des commandes depuis une chaine de caractères tapée sur le clavier. Ces raccourcis sont rassemblés dans le fichier de configuration principal d'[[openbox|Openbox]], ~/.config/openbox/rc.xml. Il existe deux types de raccourcis dans openbox: les "**keybinds**" et les "**mousebinds**". Nous allons décrire ici les différentes sections concernées dans le rc.xml.\\ Notez qu'après toute modification de ce fichier, vous devez reconfigurer openbox pour que les changements soient effectifs.
===== Les Keybinds =====
==== <actions sur les bureaux> ====
Ces raccoucis vous permettent de changer de bureau virtuel avec les touches "Control"+"Alt"+ la direction du bureau vers lequel vous voulez aller (gauche/droite/haut/bas).
<file xml>    <!-- Keybindings for desktop switching -->
    <keybind key="C-A-Left">
      <action name="DesktopLeft">
        <dialog>no</dialog>
        <wrap>no</wrap>
      </action>
    </keybind>
.
.
.</file>
Ces raccoucis vous permettent d'aller directement sur un bureau donné, en utilisant son numéro associé à une touche fonction (FN): touche "windows"+"Fx"
<file xml>    <keybind key="W-F1">
      <action name="Desktop">
        <desktop>1</desktop>
      </action>
    </keybind>
.
.
.</file>

==== <actions sur les fenêtres> ====
Ces raccourcis vous permettent d'envoyer une fenêtre sur un bureau donné avec la combinaison "Shift"+"Alt"+ direction. L'option "wrap" permet de ne pas s'arrêter au dernier bureau virtuel (navigation en boucle), 'no' par défaut.
<file xml>    <keybind key="S-A-Left">
      <action name="SendToDesktopLeft">
        <dialog>no</dialog>
        <wrap>no</wrap>
      </action>
    </keybind>
.
.</file>
Ce raccourci libère votre bureau de toute les fenêtres grâce à la combinaison "windows"+"d". Le retour des fenêtres s'obtient en répétant ce raccourcis.
<file xml>    <keybind key="W-d">
      <action name="ToggleShowDesktop"/>
    </keybind></file>
Ce raccourci ferme la fenêtre au premier plan (celle qui a le "focus").
<file xml>    <keybind key="A-F4">
      <action name="Close"/>
    </keybind></file>
Ce raccourci enlève le focus de la fenêtre.
<file xml>    <keybind key="A-Escape">
      <action name="Lower"/>
      <action name="FocusToBottom"/>
      <action name="Unfocus"/>
    </keybind></file>
Ce raccourci affiche le menu de la fenêtre au prmier plan.
<file xml>    <keybind key="A-space">
      <action name="ShowMenu">
        <menu>client-menu</menu>
      </action>
    </keybind></file>
Ces raccourcis donnent le focus à la fenêtre suivante/précédente sur le(s) bureaux virtuel(s).
<file xml>    <keybind key="A-Tab">
      <action name="NextWindow"/>
    </keybind>
    <keybind key="A-S-Tab">
      <action name="PreviousWindow"/>
    </keybind>
    <keybind key="C-A-Tab">
      <action name="NextWindow">
        <panels>yes</panels>
        <desktop>yes</desktop>
      </action>
    </keybind></file>

==== <lancement d'applications> ====
Ces raccourcis lancent des applications, des scripts, des commandes argumentées depuis une chaîne de caractères. La syntaxe est toujours la même:
<file xml><keybind key="combinaison de touches">                 ## les touches pour lancer l'éxécution.
  <action name="Execute">                              ## l'action du raccourcis, ici éxécution.
    <startupnotify>                                    ## optionnel
      <enabled>true</enabled>                          ## indique si une notification de lancement doit être envoyé.
      <name>"nom"</name>                               ## indique le nom du lanceur
    </startupnotify>                                   ## optionnel
    <command>"commande"</command>                      ## indique la commande à lancer
  </action>
</keybind></file>
quelques exemples:
<file xml>    <!-- Keybindings for running applications -->
    <keybind key="A-F2">
      <action name="Execute">
        <startupnotify>
          <enabled>true</enabled>
          <name>Run Program</name>
        </startupnotify>
        <command>gmrun</command>
      </action>
    </keybind>
    <keybind key="A-F3">
      <action name="Execute">
        <startupnotify>
          <enabled>true</enabled>
          <name>dmenu-bind</name>
        </startupnotify>
        <command>~/.config/dmenu/dmenu-bind.sh</command>
      </action>
    </keybind>
    <keybind key="W-f">
      <action name="Execute">
        <startupnotify>
          <enabled>true</enabled>
          <name>thunar</name>
        </startupnotify>
        <command>thunar</command>
      </action>
    </keybind>
.
.</file>
Vous remarquez que le rc.xml accepte les adresses relatives.\\
\\
Ce raccourci lance le menu des fenêtres ouvertes.
<file xml>    <keybind key="W-Tab">
      <action name="ShowMenu">
        <menu>client-list-combined-menu</menu>
      </action>
    </keybind></file>
Ce raccourci ouvre le menu principal openbox 'root-menu'.
<file xml>    <keybind key="W-space">
      <action name="ShowMenu">
        <menu>root-menu</menu>
      </action>
    </keybind>></file>

===== Les Mousebinds =====
La section concernant le comportement de la souris vient juste après les "keybinds".\\ La première partie concerne la distance minimum pour le "glisser/déposer/déplacer", puis vient la durée du couble-clic et la durée avant de changer de bureau virtuel une fois le bord de l'écran atteint.
<file xml>  <mouse>
    <dragThreshold>8</dragThreshold>
    <!-- number of pixels the mouse must move before a drag begins -->
    <doubleClickTime>200</doubleClickTime>
    <!-- in milliseconds (1000 = 1 second) -->
    <screenEdgeWarpTime>400</screenEdgeWarpTime>
    <!-- Time before changing desktops when the pointer touches the edge of the
       screen while moving a window, in milliseconds (1000 = 1 second).
       Set this to 0 to disable warping --></file>
==== <actions sur les fenêtres> ====
Ces raccouis déterminent le comportement de la souris sur les fenêtres, les boutons, la barre de titre, les angles de redimensionnement... l'endroit où s'applique le raccoucis est défini par '<context name="">'.\\
Ce raccourcis donne le focus à la fenêtre avec la combinaison "Alt"+"clic-gauche".
<file xml>    <context name="Frame">
      <mousebind button="A-Left" action="Press">
        <action name="Focus"/>
        <action name="Raise"/>
      </mousebind>
.
.</file>
Ce raccourci donne le focus à la fenêtre lors d'un clic-gauche sur la barre de titre.
<file xml>    <context name="Titlebar">
      <mousebind button="Left" action="Press">
        <action name="Focus"/>
        <action name="Raise"/>
      </mousebind>
.
.</file>

==== <actions sur le bureau> ====
<file xml>    <context name="Root">                                ## indique une action de la souris sur le bureau
      <!-- Menus -->
      <mousebind button="Middle" action="Press">         ## clic central
        <action name="ShowMenu">
          <menu>client-list-combined-menu</menu>         ## menu des fenêtres
        </action>
      </mousebind>
      <mousebind button="Right" action="Press">          ## clic droit
        <action name="ShowMenu">
          <menu>root-menu</menu>                         ## menu principal openbox
        </action>
      </mousebind>
    </context>                                           ## fin du 'context'
    <context name="MoveResize">                          ## indique l'action de déplacement/redimensionnement
      <mousebind button="Up" action="Click">             ## la molette vers le haut (bouton 4)
        <action name="DesktopPrevious"/>                 ## bascule sur le bureau précédent
      </mousebind>
      <mousebind button="Down" action="Click">           ## la molette vers le bas (bouton 5)
        <action name="DesktopNext"/>                     ## bascule sur le bureau suivant
      </mousebind>
      <mousebind button="A-Up" action="Click">
        <action name="DesktopPrevious"/>
      </mousebind>
      <mousebind button="A-Down" action="Click">
        <action name="DesktopNext"/>
      </mousebind>
    </context>                                           ## fin du 'context'
  </mouse></file>