Manuel de référence du programmeur XUL

<key>

Attributs Enfants communs
id  * * *
key  
keycode  
command  
alt  
shift  
control  
onkeydown  
onkeyup  
onkeypress  
oncommand  

<key> est un widget XUL obligatoire. Les attaches principales définissent un rapport entre entre les combinaisons de frappe et la fonctionnalité de l'interface. Les clés sont typiquement accédées par le clavier.
 
 

 

key
Description
key est un attribut requis pour indiquer la clé primaire de l'attache pour un dérouleur d'événement. 
Syntaxe
<key id="string" key="caractère clavier" />


Exemple

<keyset>
   <key id="newKey" key="n" onkeydown="New()" />
   <key id="openKey" key="o" onkeydown="Open()" />
   <key id="saveKey" key="s" onkeydown="Save()" />
</keyset>
Notes
La valeur de key n'est pas sensible à la casse, ainsi "S" signifie la même chose que "s". Quand il n'y a aucun modificateur indiqué, la clé primaire travaille par elle-même pour appeler le dérouleur d'événement. Quand un modificateur et une clé sont indiqués, alors tous les deux doivent être appuyés pour inciter le dérouleur d'événement.

 

 

keycode
Description
keybode est un attribut facultatif indiquant les clés de commande de clavier pour appeler des dérouleurs d'événement.
Syntaxe
<key id="string" keycode="caractère clavier" />
Exemple
<key id="saveKey" key="s" keycode="VK_HOME" onkeydown="HomePage()" />
Notes
Les codes clefs communs apparaissent dans la table suivante:
 
keycode affichage clavier
VK_HOME Début
VK_END Fin
VK_LEFT Flèche gauche
VK_RIGHT Flèche droite
VK_PAGE_UP Touche Page Up
VK_PAGE_DOWN Touche Page Down
VK_DELETE Touche Supprime
VK_INSERT Touche Insertion
VK_END Touche fin
VK_F2 (et al) Touche Fonction
VK_ENTER Touche Entrée
 
command
Description
command est un attribut facultatif pour indiquer des clés de commande à utiliser  en même temps que la clé primaire key pour appeler des dérouleurs d'événement.
Syntaxe
<key id="string" key="caractère clavier" command="[ true | false]" />
Exemple
<key id="saveKey" key="s" command="true" onkeydown="Save()" />
Notes
L'exemple ci-dessus définit une clé combinaison liant la commande + "s". Les clés de commande changent suivant la plateforme, comme montré dans la table suivante:
 
Modificateur GTK Macintosh Windows
command control command control
alt alt option alt
shift shift shift shift
control control control control
 
alt
Description
alt est un attribut facultatif pour indiquer des clés de commande à utiliser  en même temps que la clé primaire pour appeler des dérouleurs d'événement.
Syntaxe
<key id="string" key="caractère clavier" alt="[ true | false]" />
Exemple
<key id="saveKey" key="s" alt="true" onkeydown="Save()" />
Notes
L'exemple ci-dessus définit une clé combinaison liant ALT + "s". Les touches ALT changent de plateforme en plateforme, comme montré dans la table suivante:
 
Modificateur GTK Macintosh Windows
command control command control
alt alt option alt
shift shift shift shift
control control control control
shift
Description
shift est un attribut facultatif pour indiquer des clés de commande à utiliser  en même temps que la clé primaire pour appeler des dérouleurs d'événement.
Syntaxe
<key id="string" key="caractère clavier" shift="[ true | false]" />
Exemple
<key id="saveKey" key="s" shift="true" onkeydown="Save()" />
Notes
L'exemple ci-dessus définit une clé combinaison liant SHIFT + "s". Les touches SHIFT changent de plateforme en plateforme, comme montré dans la table suivante:
 
Modificateur GTK Macintosh Windows
command control command control
alt alt option alt
shift shift shift shift
control control control control
control
Description
control est un attribut facultatif pour indiquer des clés de commande à utiliser  en même temps que la clé primaire pour appeler des dérouleurs d'événement.
Syntaxe
<key id="string" key="caractère clavier" control="[ true | false]" />
Exemple
<key id="saveKey" key="s" control="true" onkeydown="Save()" />
Notes
L'exemple ci-dessus définit une clé combinaison liant CONTROL + "s". Les touches CONTROL changent de plateforme en plateforme, comme montré dans la table suivante:
 
Modificateur GTK Macintosh Windows
command control command control
alt alt option alt
shift shift shift shift
control control control control
onkeydown
Description
onkeydown est un attribut facultatif pour créer des dérouleurs d'événement pour les attaches principales. 
Syntaxe
<key id="string" key="caractère clavier" onkeydown="code dérouleur d'évènement" />
Exemple
<key id="saveKey" key="S" onkeydown="Save()" />
Notes
L'événement de touche appuyée keydown est actionné quand l'utilisateur appuie sur la clé indiquée par l'attribut principal (et les modificateurs). L'événement keypress est totalement équivalent aux événements keydown et keyup ensemble.

 
 

 

onkeyup
Description
onkeyup est un attribut facultatif pour créer des dérouleurs d'événement pour les attaches principales. 
Syntaxe
<key id="string" key="caractère clavier" onkeyup="code dérouleur d'évènement" />
Exemple
<key id="saveKey" key="S" onkeyup="Save()" />
Notes
L'événement de touche relevée keyup est actionné quand l'utilisateur relache la clé indiquée par l'attribut principal (et les modificateurs). L'événement keypress est totalement équivalent aux événements keydown et keyup ensemble.

 
 
 

 

onkeypress
Description
onkeypress est un attribut facultatif pour créer des dérouleurs d'événement pour les attaches principales. 
Syntaxe
<key id="string" key="caractère clavier" onkeypress="code dérouleur d'évènement" />
Exemple
<key id="saveKey" key="S" onkeypress="Save()" />
Notes
L'événement keypress est actionné quand l'utilisateur appuie sur la touche indiquée par l'attribut principal (et les modificateurs). L'événement de keypress est totalement équivalent aux événements keydown et keyup ensemble.

 
 
 

 

oncommand
Description
oncommand est un attribut facultatif pour créer des dérouleurs d'événement pour les attaches principales. 
Syntaxe
<key id="string" key="caractère clavier" oncommand="code dérouleur d'évènement" />
Exemple
<key id="saveKey" key="S" oncommand="Save()" />
Notes
XXX. Toujours pas mis à jour. L'événement de keypress est actionné quand l'utilisateur appuie sur la touche indiquée par l'attribut principal (et les modificateurs). L'événement de keypress est totalement équivalent aux événements keydown et keyup ensemble.

 

 


 

Last updated: 4/12/00 Ian Oeschger
French version (7/3/00) Matthieu Camus