FAQ Java GUIConsultez toutes les FAQ

Cas général :Lorsque l'on reçoit une action d'un bouton de la souris, il y a deux solutions pour identifier le bouton concerné : la première consiste à utiliser la méthode getButton() et de comparer le résultat avec les constantes BUTTON1, BUTTON2 et BUTTON3. Cette solution n'est pas pleinement satisfaisante car la documentation ne précise pas lequel est effectivement le bouton gauche. On préférera donc utiliser la classe javax.swing.SwingUtilities qui commente plus généreusement son fonctionnement :

void mousePressed(MouseEvent mouseEvent) {
        if ( SwingUtilities.isLeftMouseButton(mouseEvent) ) {
                /** Bouton GAUCHE */
        } else if(SwingUtilities.isMiddleMouseButton(mouseEvent) ) {
                /** Bouton du MILIEU */
        } else if(SwingUtilities.isRightMouseButton(mouseEvent)) {
                /** Bouton DROIT */
        } 
} 

Gardez toujours à l'esprit que certains systèmes n'ont pas de 2ème et/ou 3ème bouton, les traitements doivent donc être accessibles par un autre moyen.

Ouvrir le menu contextuel :Il est tentant d'ouvrir le menu contextuel lorsque l'on détecte l'utilisation du bouton droit, mais cette implémentation ne serait pas portable, certains systèmes n'ont qu'un bouton de souris (Mac) d'autres n'utilisent pas le droit pour ouvrir le menu contextuel (linux permet de configurer les choses les plus folles). Pour cela, on utilisera la méthode isPopupTrigger() et on prendra soin de la tester dans mousePressed(java.awt.event.MouseEvent) et dans mouseReleased(java.awt.event.MouseEvent). Le faire dans les deux cas est très important pour que le programme fonctionne correctement sur tous les systèmes.

JDK 1.0 :Dans la classe java.awt.Frame des variables de classe (variable statique) définissent des curseurs, en choisir un et faire :

setCursor(Frame.celui_desire);
// par exemple : DEFAULT_CURSOR, WAIT_CURSOR ... 

JDK 1.1 et +:

myComponent.setCursor(Cursor.getPredefinedCursor(Cursor.WAIT_CURSOR));

Sachant que la classe Cursor définit un certain nombre de curseurs par défaut ( DEFAULT_CURSOR, WAIT_CURSOR... ) on peut ainsi changer le curseur dans un Dialog ce qui n'était pas possible précédemment. Le changement de curseur est automatiquement hérité par tous les fils, sauf si ceux-çi précisent explicitement un autre curseur.

Sur un événement de type java.awt.event.MouseEvent, la méthode getClickCount() permet de connaître le nombre de clics et donc de gérer les doubles.

De manière générale, ce cas ne devrait pas se produire. Le double clic ayant souvent une fonction complémentaire du simple clic.

La seule solution est l'utilisation de 'timer' qui sera lancé lors d'un simple clic et arrêté lors d'un 2ème clic. Si le temps est écoulé sans que le timer n'ait été arrêté par le 2ème clic, alors on exécute l'action associée au simple clic !

La classe java.awt.Robot permet entre autres de déplacer automatiquement la souris via la méthode mouseMove(int,int). La classe Robot permet également d'actionner les boutons de la souris ou d'entrer des touches au clavier.

Attention :Le déplacement automatique de la souris a le don d'énerver certains utilisateurs, il est donc conseillé de l'utiliser prudemment et/ou de permettre à l'utilisateur de désactiver cette fonction.

Les formats de fichiers '.cur' et '.ani' ne sont pas supportés en standard par l'API de Java. La meilleure solution consiste donc à utiliser un programme extérieur pour convertir ces fichiers dans un format reconnu par la JVM ('.png' ou '.gif' sont parfaitement adaptés pour ça). Les plus courageux peuvent se mettre à la recherche d'une bibliothèque additionnelle...

A partir d'un composant avec MouseEvent

En enregistrant un MouseEvent auprès de votre composant graphique, vous pouvez avoir accès à la position de la souris relativement à ce composant. Il vous suffira ensuite d'utiliser la méthode getLocationOnScreen() de Component pour calculer la position de la souris par rapport à l'écran.

int x = (int)(mouseEvent.getPoint().getX() + monComposant.getLocationOnScreen().getX());
int y = (int)(mouseEvent.getPoint().getY() + monComposant.getLocationOnScreen().getY());

Vous pouvez aussi utiliser la méthode convertPointToScreen() de la classe javax.swing.SwingUtilities. Par exemple :

MouseEvent event = ...; 
Component composant = ...;
Point locationComposant = event.getPoint();
Point locationEcran = SwingUtilities.convertPointToScreen(locationComposant, composant);

Sans composant graphique

A partir de Java 5.0 (Tiger), si vous voulez connaître la position de la souris (même en dehors d'une fenêtre) vous pouvez utiliser l'objet MouseInfo du package java.awt. Par exemple :

PointerInfo pointer = MouseInfo.getPointerInfo();
Point location = pointer.getLocation(); 
System.out.println("La souris se trouve en "+location);

Attention, l'instance de PointerInfo n'est pas mise à jour automatiquement. Vous devrez en récupérer une nouvelle instance à chaque fois.

Avant Java 5.0, la seule solution possible est de passer par JNI (Java Native Interface). Vous pourrez ainsi avoir accès grâce à des langages plus proches du système aux cooordonnées de la souris à l'écran. Attention tout de même, vous risquez de perdre la portabilité de votre application.

Depuis Java 5.0, il est possible de connaître le nombre de boutons de la souris grâce à la méthode statique MouseInfo.getNumberOfButtons() :

System.out.println("La souris possède " + MouseInfo.getNumberOfButtons() + " bouton(s).");

Il vous faudra pour cela employer la classe Robot.

Voici un petit exemple avec la touche A :

Robot robot = new Robot();		/** création du robot */
robot.keyPress(KeyEvent.VK_A);		/** pression de la touche A */
robot.keyRelease(KeyEvent.VK_A);	/** relachement de la touche A*/

Bien sur il est possible de combiner plusieurs touches, par exemple pour faire un A majuscule, il faut combiner le A avec la touche shift.