Développons en Java

13/07/2003

• Intercepter les actions de l'utilisateur avec Java version 1.0
• Intercepter les actions de l'utilisateur avec Java version 1.1
• L'interface ItemListener L'interface TextListener L'interface MouseMotionListener L'interface MouseListener L'interface WindowListener Les différentes implémentations des Listener Résumé

• ActionListener : clic de souris ou enfoncement de la touche Enter
• ItemListener : utilisation d'une liste ou d'une case à cocher
• MouseMotionListener : evénément de souris
• WindowListener : événement de fenetre

• importer le groupe de classe java.awt.event import java.awt.event.*;
• la classe doit déclarer qu'elle utilisera une ou plusieurs interfaces d'écoute public class AppletAction extends Applet implements ActionListener{ Pour déclarer plusieurs interfaces, il suffit de les séparer par des virgules public class MonApplet extends Applet implements ActionListener, MouseListener {
• Appel à la méthode addXXX() pour enregistrer l'objet qui gerera les évenements XXX du composant Il faut configurer le composant pour qu'il possède un "écouteur" pour l'événement utilisateur concerné. Button b = new Button(«boutton»); b.addActionListener(this); Ce code créé l'objet de la classe Button et appelle sa méthode addActionListener(). Cette méthode permet de préciser qu'elle sera la classe qui va gérer l'évenement utilisateur de type ActionListener du bouton. Cette classe doit impérativement implémenter l'interface de type EventListener correspondante soit dans cette exemple ActionListener. L'instruction this indique que la classe elle même recevra et gérera l'évenement utilisateur. L'apparition d'un évenement utilisateur généré par un composant doté d'un auditeur appelle automatiquement une méthode, qui doit se trouver dans la classe référencée dans l'instruction qui lie l'auditeur au composant. Dans l'exemple, cette méthode doit être située dans la même classe parce que c'est l'objet lui même qui est spécifié avec l'instruction this. Une autre classe indépendante peut être utilisée : dans ce cas il faut préciser une instance de cette classe en temps que paramètre.
• implémenter les méthodes déclarées dans les interfaces Chaque auditeur possède des méthodes différentes qui sont appelées pour traiter leurs évenéments. Par exemple, l'interface ActionListener envoie des évenements à une classe nommée actionPerformed( ). public void actionPerformed(ActionEvent evt) { //insérer ici le code de la méthode }; Pour identifier le composant qui a généré l'evénement il faut utiliser la méthode getActionCommand() de l'objet ActionEvent fourni en paramètre de la méthode : String composant = evt.getActionCommand(); getActionCommand renvoie une chaine de caractères. Si le composant est un bouton, alors il renvoie le texte du bouton, si le composant est une zone de saisie, c'est le texte saisie qui sera renvoyé (il faut appuyer sur "Entrer" pour générer l'événement), etc ... La méthode getSource() renvoie l'objet qui a généré l'événement. Cette méthode est plus sure que la précédente Button b = new Button(« bouton »); ... void public actionPerformed(actionEvent evt) { Object source = evt.getSource(); if (source == b) // action a effectuer } La méthode getSource() peut être utilisé avec tous les évenements utilisateur. package applets; import java.applet.*; import java.awt.*; import java.awt.event.*; public class AppletAction extends Applet implements ActionListener{ public void actionPerformed(ActionEvent evt) { String composant = evt.getActionCommand(); showStatus("Action sur le composant : " + composant); } public void init() { super.init(); Button b1 = new Button("boutton 1"); b1.addActionListener(this); add(b1); Button b2 = new Button("boutton 2"); b2.addActionListener(this); add(b2); Button b3 = new Button("boutton 3"); b3.addActionListener(this); add(b3); } }

Checkbox cb = new Checkbox(« choix »,true);
cb.addItemListener(this);

package applets;
import java.applet.*;
import java.awt.*;
import java.awt.event.*;
public class AppletItem extends Applet implements ItemListener{
   public void init() { 
      super.init();
      Checkbox cb = new Checkbox("choix 1", true);
      cb.addItemListener(this);
      add(cb);
   }
   public void itemStateChanged(ItemEvent item) {
      int status = item.getStateChange();
      if (status == ItemEvent.SELECTED)
         showStatus("choix selectionne");
      else
         showStatus("choix non selectionne");
   }
}

package applets;
import java.applet.*;
import java.awt.*;
import java.awt.event.*;
public class AppletItem extends Applet implements ItemListener{
   public void init() { 
      Choice c = new Choice();
      c.add("choix 1");
      c.add("choix 2");
      c.add("choix 3");
      c.addItemListener(this);
      add(c);
}
   public void itemStateChanged(ItemEvent item) {
      Object obj = item.getItem();
      String selection = (String)obj;
      showStatus("choix : "+selection);
   }
}

package applets;
import java.applet.*;
import java.awt.*;
import java.awt.event.*;
public class AppletMotion extends Applet implements MouseMotionListener{
   private int x;
   private int y;
   public void init() { 
      super.init();
      this.addMouseMotionListener(this);
   }
   public void mouseDragged(java.awt.event.MouseEvent e) {}
   public void mouseMoved(MouseEvent e) {
      x = e.getX();
      y = e.getY();
      repaint();
      showStatus("x = "+x+" ; y = "+y);
   }
   public void paint(Graphics g) {
      super.paint(g);
      g.drawString("x = "+x+" ; y = "+y,20,20);
   }
}

• public void mouseClicked(MouseEvent e);
• public void mousePressed(MouseEvent e);
• public void mouseReleased(MouseEvent e);
• public void mouseEntered(MouseEvent e);
• public void mouseExited(MouseEvent e);

package applets;
import java.applet.*;
import java.awt.*;
import java.awt.event.*;
public class AppletMouse extends Applet implements MouseListener {
   int nbClick = 0;
   public void init() {
      super.init();
      addMouseListener(this);
   }
   public void mouseClicked(MouseEvent e) {
      nbClick++;
      repaint();
   }
   public void mouseEntered(MouseEvent e) {}
   public void mouseExited(MouseEvent e) {}
   public void mousePressed(MouseEvent e) {}
   public void mouseReleased(MouseEvent e) {}
   public void paint(Graphics g) {
      super.paint(g);
      g.drawString("Nombre de clics : "+nbClick,10,10);
   }
}

class gestionClics extends MouseAdapter {
   public void mousePressed(MouseEvent e) {
      //traitement
   }
}

• public void windowOpened(WindowEvent e)
• public void windowClosing(WindowEvent e)
• public void windowClosed(WindowEvent e)
• public void windowIconified(WindowEvent e)
• public void windowDeinconified(WindowEvent e)
• public void windowActivated(WindowEvent e)
• public void windowDeactivated(WindowEvent e)

package test;
import java.awt.event.*;
class GestionnaireFenetre extends WindowAdpter {
   public void windowClosing(WindowEvent e) {
      System.exit(0);
   }
}

package test;
import java.awt.*;
import java.awt.event.*;
public class TestFrame extends Frame {
   private GestionnaireFenetre gf = new GestionnaireFenetre();
   public TestFrame(String title) {
     super(title);
     addWindowListener(gf);
   }
   public static void main(java.lang.String[] args) {
      try {
         TestFrame tf = new TestFrame("TestFrame");       
         tf.setVisible(true);
      } catch (Throwable e) {
         System.err.println("Erreur");
         e.printStackTrace(System.out);
      }
   }
}

package test;
import java.awt.*;
import java.awt.event.*;
public class TestFrame3 extends Frame implements WindowListener {
   public TestFrame3(String title) {
      super(title);
      this.addWindowListener(this);
   }
   public static void main(java.lang.String[] args) {
      try {
         TestFrame3 tf = new TestFrame3("testFrame3");  
         tf.setVisible(true);
      } catch (Throwable e) {
         System.err.println("Erreur");
         e.printStackTrace(System.out);
      }
   }
   public void windowActivated(java.awt.event.WindowEvent e) {}
   public void windowClosed(java.awt.event.WindowEvent e) {}
   public void windowClosing(java.awt.event.WindowEvent e) {
      System.exit(0);
   }
   public void windowDeactivated(java.awt.event.WindowEvent e) {}
   public void windowDeiconified(java.awt.event.WindowEvent e) {}
   public void windowIconified(java.awt.event.WindowEvent e) {}
   public void windowOpened(java.awt.event.WindowEvent e) {}
}

package test;
import java.awt.*;
import java.awt.event.*;
public class TestFrame4 extends Frame {
   public TestFrame4(String title) {
      super(title);
      gestEvt ge = new gestEvt();
      addWindowListener(ge);
   }
   public static void main(java.lang.String[] args) {
      try {
         TestFrame4 tf = new TestFrame4("testFrame4");
         tf.setVisible(true);
      } catch (Throwable e) {
         System.err.println("Erreur");
         e.printStackTrace(System.out);
      }
   }
}

package test;
import java.awt.event.*;
public class gestEvt implements WindowListener {
   public void windowActivated(WindowEvent e) {}
   public void windowClosed(WindowEvent e) {}
   public void windowClosing(WindowEvent e) {
      System.exit(0);
   }
   public void windowDeactivated(WindowEvent e) {}
   public void windowDeiconified(WindowEvent e) {}
   public void windowIconified(WindowEvent e) {}
   public void windowOpened(WindowEvent e) {}
}

package test;
import java.awt.*;
import java.awt.event.*;
public class TestFrame2 extends Frame {
   class gestEvt implements WindowListener {
      public void windowActivated(WindowEvent e) {};
      public void windowClosed(WindowEvent e) {};
      public void windowClosing(WindowEvent e) {
         System.exit(0);
      };
      public void windowDeactivated(WindowEvent e) {};
      public void windowDeiconified(WindowEvent e) {};
      public void windowIconified(WindowEvent e) {};
      public void windowOpened(WindowEvent e) {};
   };
   private gestEvt ge = new TestFrame2.gestEvt();
   public TestFrame2(String title) {
     super(title);
     addWindowListener(ge);
   }
   public static void main(java.lang.String[] args) {
      try {
         TestFrame2 tf = new TestFrame2("TestFrame2");       
         tf.setVisible(true);
      } catch (Throwable e) {
         System.err.println("Erreur");
         e.printStackTrace(System.out);
      }
   }
}

package test;
import java.awt.*;
import java.awt.event.*;
public class TestFrame1 extends Frame {
   public TestFrame1(String title) {
      super(title);
      addWindowListener(new WindowAdapter() {
         public void windowClosed(.WindowEvent e) {
            System.exit(0);
         };
      });       
   }
   public static void main(java.lang.String[] args) {
      try {
         TestFrame1 tf = new TestFrame1("TestFrame");       
         tf.setVisible(true);
      } catch (Throwable e) {
         System.err.println("Erreur");
         e.printStackTrace(System.out);
      }
   }
}

• associer au composant qui est à l'origine de l'évenement un controleur adéquat : utilisation des méthodes addXXXListener() Le paramètre de ces méthodes indique l'objet qui a la charge de répondre au message : cet objet doit implémenter l'interface XXXListener correspondant ou dérivé d'une classe XXXAdapter (créer une classe qui implémente l'interface associé à l'événement que l'on veut gérer. Cette classe peut être celle du composant qui est à l'origine de l'événement (facilité d'implémentation) ou une classe indépendante qui détermine la frontière entre l'interface graphique (émission d'événement) et celle qui représente la logique de l'application (traitement des événements) ).
• les classes XXXAdapter sont utiles pour créer des classes dédiées au traitement des évenements car elles implémentent des méthodes par défaut pour celles définies dans l'interface XXXListener dérivées de EventListener. Il n'existe une classe Adapter que pour les interface qui possédent plusieurs méthodes.
• implémenter la méthode associé à l'événement qui fournit en paramètre un objet de type AWTEvent (classe mère de tout événement) qui contient des informations utiles (position du curseur, état du clavier ...).