Pour faciliter l'accès aux fonctionnalités graphiques de Java, nous avons défini pour ce cours le package graphique. Les types de ce paquet et leurs membres publics ont tous un nom en français afin de les distinguer des types de la bibliothèque standard de Java (API Java 2).

Le tableau ci-dessous précise le nom des paquets dans lesquels sont définis les types cités dans ce document.

Installation

Sauvegardez le fichier d'archives graphique.tgz dans votre répertoire ~/info/classes, placez-vous dans ce répertoire et extrayez les fichiers de classe qu'il contient au moyen de :

  tar zxvf graphique.tgz

Ceci crée un répertoire graphique sous ~/info/classes, qui contient les fichiers de classe nécessaires.

Fonctionnalités

Pour pouvoir réaliser des dessins dans une fenêtre, on doit étendre la classe FenetreGraphique du paquet graphique. Cette classe permet d'ouvrir une fenêtre graphique composée de haut en bas d'une barre de menu (avec un menu Fichier), d'une zone de dessin et d'une ligne d'information :

La méthode void dessiner(Graphics2D g2), qui par défaut ne fait rien, est appelée quand une demande d'affichage de la zone de dessin a lieu. Elle doit être redéfinie dans une extension de la classe FenetreGraphique. La re-définition de cette méthode doit contenir les instructions nécessaires à la réalisation du tracé qui apparaîtra dans la zone de dessin. Cette méthode possède un paramètre g2 appelé contexte graphique qui rassemble les attributs courants relatifs au tracé comme par exemple l'épaisseur du trait, la couleur de remplissage, etc.

La méthode void re_dessiner() provoque le ré-affichage du contenu de la fenêtre de dessin : la zone de dessin est effacée puis la méthode précédente est appelée. Cette méthode doit être appelée lorsque le dessin a changé.

Exemple

import java.awt.*;
import graphique.FenetreGraphique;

class Ex1 extends FenetreGraphique {
  Ex1 () {}
  Ex1 (int w, int h, Color c) {super(w,h,c);}

  public void dessiner(Graphics2D g2) {
    g2.setPaint(Color.red);
    g2.drawString("ENPC", 0, getHauteur());
  }
}

class Ex1Main {
  public static void main(String[] args) {
    FenetreGraphique fenêtre = new Ex1();
    fenêtre.ouvrir();
    fenêtre.informer("Un premier exemple");
  }
}

Système de coordonnées

Objets graphiques

• les figures géométriques de type Shape telles que rectangles, ellipses, lignes polygonales, etc. ;
• les textes de type String, dans différentes polices. ;
• les images de type Image ;Un objet de ce type est obtenu en invoquant le méthode chargerImage().

Les figures géométriques

Les segments de droite sont représentés par des objets de la classe Line2D. On en obtient une instance en appelant le constructeur suivant :

  Line2D.Float(float x1, float y1, float x2, float y2)

Les rectangles sont représentés par des objets de la classe Rectangle2D. On en obtient une instance en appelant le constructeur suivant :

  Rectangle2D.Float(float x, float y, float w, float h)

Les ellipses sont représentées par des objets de la classe Ellipse2D. On en obtient une instance en appelant le constructeur suivant :

  Ellipse2D.Float(float x, float y, float w, float h) 

Exemple

  void dessinePoint(Graphics2D g2, Point p)
  {
    float d = 5; // diamètre du cercle
    
    // Crée un petit cercle de 5 unités de diamètre, centré en p
    Shape c = new Ellipse2D.Float(p.x-d/2, p.y-d/2, d, d);
    // Fixe la couleur de tracé
    g2.setPaint(Color.yellow);
    // Dessine le cercle
    g2.draw(c);
  }

Les arcs d'ellipses sont représentés par des objets de la classe Arc2D. On en obtient une instance en appelant le constructeur suivant :

  Arc2D.Float(float x, float y, float w, float h, 
              float start, float extent, int type) 

Les polygones quelconques sont représentées par des objets de la classe GeneralPath. On en obtient une instance en appelant le constructeur suivant :

  GeneralPath()

  void moveTo(float x, float y)

  void lineTo(float x, float y)

  void closePath()

Les chaînes de caractères

  FontMetrics fm = g2.getFontMetrics(f);

  fm.stringWidth(s)

Les images

  int getWidth(ImageObserver obs)

  int getHeight(ImageObserver obs)

Les attributs

  g2.setPaint(Color.blue);

Couleur

  Color(float r, float v, float b) 

  void setPaint(Paint paint)

Largeur du trait

  BasicStroke(float w)

  void setStroke(Stroke s)

Police de caractères

  Font(String nom, int style, int taille)

  setFont(Font font)

Les méthodes de tracé

Dessiner un contour

  void draw(Shape s)

Remplir l'intérieur d'un contour

  void fill(Shape s)

Écrire du texte

  void drawString(String s, float x, float y)

Inclure une image

  boolean drawImage(Image img, int x, int y, ImageObserver obs)

Événements clavier

Un événement clavier est un objet de type KeyEvent qui est produit lorsque l'utilisateur tape sur une touche de son clavier. Ce type est défini dans le paquet java.awt.event.

Il y a trois sortes d'événements clavier correspondant respectivement à l'enfoncement d'une touche, le relâchement d'une touche et la séquence enfoncement / relâchement d'une touche associée à un caractère. Le traitement d'un événement est confié à une méthode ayant un prototype standardisé, spécialisée pour un type donné d'événement.

Ci-dessous, quelques méthodes utiles définies sur ce type.

  char getKeyChar()

  int getKeyCode()

 
  boolean isShiftDown()
  boolean isControlDown()
  boolean isMetaDown() 

Événements souris

Un événement souris est un objet de type MouseEvent qui est produit lorsque l'utilisateur déplace sa souris ou clique sur un bouton. Ce type est défini dans le paquet java.awt.event. Il y a plusieurs sortes d'événements souris :

• enfoncement d'un bouton
• relâchement d'un bouton
• clic sur un bouton. Un clic est une séquence enfoncement / relâchement.
• déplacement
• déplacement avec un bouton enfoncé

Quelques méthodes définies sur ce type

  int getClickCount() 

  int getX() 
  int getY() 
  Point getPoint() 

 
  boolean isShiftDown()
  boolean isControlDown()
  boolean isMetaDown() 

int getModifiers()

  (e.getModifiers() & InputEvent.BUTTON2_MASK) ==
  InputEvent.BUTTON2_MASK

Un exemple

  List points = new ArrayList();

  public void mouseClicked(MouseEvent e)
  {
    // Si clic gauche, ajoute un point à la liste
    if ((e.getModifiers() & InputEvent.BUTTON1_MASK) 
        == InputEvent.BUTTON1_MASK)
      points.add(e.getPoint());
    else // Sinon retire tous les points de la liste
      points.clear();
    
    // Demande le ré-affichage de la liste de points
    re_dessiner();
  }

Ajouter d'autres composants d'interface

Il est possible d'ajouter d'autres items de menu au menu existant et d'autres menus à la barre de menus de la façon suivante :

import java.awt.*;
import javax.swing.*;
import graphique.FenetreGraphique;

class Ex4 extends FenetreGraphique {
  JMenuBar jmb;
  JMenu jm0, jm1;
  JMenuItem jmi0, jmi1;
  Ex4 () {
    étendreMenus();
  }
  Ex4 (int w, int h, Color c) {
    super(w,h,c); 
    étendreMenus();
  }

  void étendreMenus() {
    // la barre de menu
    jmb = getJMenuBar();

    // le premier menu
    jm0 = jmb.getMenu(0);
    // addition d'un item de menu
    jmi0 = new JMenuItem("Item de menu");
    jm0.add(jmi0);

    // addition d'un menu
    jm1 = new JMenu("Nouveau menu");
    jmi1 = new JMenuItem("Item de menu");
    jm1.add(jmi1);
    jmb.add(jm1);
  }

  // ...
}

exemple d'extension

Ouvrir une fenêtre de dialogue

Une fenêtre de dialogue permet de saisir des données.

import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import graphique.FenetreGraphique;

class Ex6 extends FenetreGraphique {
  Ex6 () {
  }

  Ex6 (int w, int h, Color c) {
    super(w,h,c); 
  }

  public void mouseClicked(MouseEvent e)
  {
    // Si clic droit, ouvre une fenêtre de saisie
    if ((e.getModifiers() & InputEvent.BUTTON3_MASK) 
        == InputEvent.BUTTON3_MASK) {
      Saisie dialogue = new Saisie(this);
      dialogue.pack();
      dialogue.setLocationRelativeTo(this);
      dialogue.setLocation(e.getPoint());
      dialogue.show();
    }
  }

  public void dessiner(Graphics2D g2) {
    g2.setPaint(Color.red);
    g2.drawString("ENPC", 0, getHauteur());
  }
}

class Ex6Main {
  public static void main(String[] args) {
    FenetreGraphique fenêtre = new Ex6();
    fenêtre.ouvrir();
    fenêtre.informer("Exemple avec fenêtre de saisie");
  }
}

class Saisie extends JDialog {
  FenetreGraphique parent;
  Container conteneur;
  GridLayout placement = new GridLayout(3,2);
  JLabel champ1Label = new JLabel("Le champ 1");
  JTextField champ1Text = new JTextField();
  JLabel champ2Label = new JLabel("Le champ 2");
  JTextField champ2Text = new JTextField();

  Action valider = new AbstractAction("Valider") {
    public void actionPerformed(ActionEvent e) {
      parent.informer(champ1Text.getText() + ", " 
		      + champ2Text.getText());
      dispose();
    }
  };
                          
  JButton validerButton = new JButton(valider);

  Action effacer = new AbstractAction("Effacer") {
    public void actionPerformed(ActionEvent e) {
      champ1Text.setText("");
      champ2Text.setText("");
    }
  };
                          
  JButton effacerButton = new JButton(effacer);

  // vérifie que les champs saisis sont numériques
  KeyListener kl = new KeyAdapter() {
      public void keyTyped(KeyEvent e) {
	char c = e.getKeyChar();
	if (!((c >= '0') && (c <= '9') ||
	      (c == KeyEvent.VK_BACK_SPACE) ||
	      (c == KeyEvent.VK_DELETE))) {
	  getToolkit().beep();
	  e.consume();
	}
      }
    };

  public Saisie(FenetreGraphique parent) {
    super((Frame)null, "Saisie des paramètres", true);
    this.parent = parent;
    this.setDefaultCloseOperation(WindowConstants.DISPOSE_ON_CLOSE);
    conteneur = getContentPane();
    conteneur.setLayout(placement);
    this.setSize(new Dimension(400, 300));
    this.setTitle("Saisie");
    placement.setHgap(20);
    placement.setVgap(10);

    champ1Text.addKeyListener(kl);
    champ2Text.addKeyListener(kl);

    conteneur.add(champ1Label);
    conteneur.add(champ1Text);
    conteneur.add(champ2Label);
    conteneur.add(champ2Text);
    conteneur.add(validerButton);
    conteneur.add(effacerButton);
  }
}

Last modified: Mon Nov 26 12:13:34 MET 2001