|
Swing - Interface Homme-Machine
4.4.Les conteneurs utilitaires spécifiques
4.4.1.JRootPane
Une instance de JRootPane est créée automatiquement par la JFrame lors de son initialisation. Le constructeur de JFrame fait automatiquement appel à la méthode createRootPane().
Le JRootPane ainsi créé contient les éléments suivants :
- glassPane (un JPanel par défaut)
- layeredPane (un JLayeredPane)
- contentPane (un JPanel par défaut)
- menuBar (un JMenuBar null par défaut)
Voici l’illustration des différents éléments évoqués précédement :
| glassPane |
 |
menuBar
layeredPane
contentPane
|
- glassPane est transparent et s’avère très utile lorsqu’il va s’agir d’intercepter des événements générés par la souris.
- layeredPane correspond à un type particulier (JLayeredPane), et il va permettre de contenir des fenêtres filles à l’instar des applications MDI de Microsoft.
- contentPane est un panneau créé lui aussi par défaut, il reçoit les composants à l’aide de l’instruction suivante :
maJFrame.getContentPane().add(monComponent)
- menuBar n’existe pas par défaut (il est null donc pas encore instancié), mais il est aisément créé par la méthode suivante :
setJMenuBar(menu);
4.4.2.GlassPane
C’est un panneau transparent positionné au dessus du JRootPane auquel il est associé. Il va s’avérer utile dans la capture d’évènements de souris généralement et plus généralement dans la plupart des questions sur le pointeur de la souris.
Il est accéssible via les méthodes getGlassPane() et setGlassPane(Component c) de l’interface RootPaneContainer implémentées par les conteneurs ayant un JRootPane.
4.4.3.JLayeredPane
JLayeredPane est un conteneur qui peut posséder un nombre de couches quasiment illimité. Les composants contenus dans un Layer (une couche de JLayeredPane) sont organisés selon leur position.
Lorsque deux composants d’un même layer se chevauchent le composant de valeur élevée est affichés en dessous de celui de valeur basse.
Cependant, en ce qui concerne les Layers, c’est le contraire qui se passe. Les Layers de valeur élevée sont affichés au dessus des Layers de valeur basse.
Les positions dans un layer
Dans un layer contenant N composants, les positions de ceux-ci sont numérotées de -1 à (N-1). En ce qui concerne l’affichage, le composant de position 0 est au dessus du composant de position N.
La profondeur (Depth)
Lorsqu’un composant est contenu dans un layer, ce dernier est considéré comme étant la profondeur (Depth) du composant.
Mais un composant est aussi représenté par son index. L’index est une valeur entière différente pour chacun des composants du JLayeredPane. On peut interroger un composant pour connaître son index, mais on ne peut pas changer l’index d’un composant.
Chaque Layer d’un JLayeredPane est représenté par un Objet Integer.
La classe JLayeredPane définit les six constantes Integer suivantes :
- FRAME_CONTENT_LAYER
- DEFAULT_LAYER
- PALETTE_LAYER
- MODAL_LAYER
- POPUP_LAYER
- DRAG_LAYER
Ces Layers sont destinés à être les Layers standards.
L’ajout de layers
Lorsque l’on ajoute un composant au JLayeredPane à l’aide de la méthode add(Component), celui-ci est placé dans le layer DEFAULT_LAYER (représenté par Integer(0));
Pour ajouter un composant à un layer particulier, on utilise la méthode add(component, Object).
Pour le layer 10 par exemple, on passera l’objet Integer(10).
On peut aussi passer les valeurs des layers standards, par exemple JLayeredPane.POPUP_LAYER
Pour ajouter un composant à un layer particulier et à une position donnée on utilisera la méthode add(Component composant, Object obj, int position).
4.4.4.JDesktopPane
JDesktopPane est une extension de JLayeredPane spécialement construite pour gérer des fenêtres filles du type JInternalFrame. JDesktopPane permet d’ajouter des composants à l’aide de la méthode add(Component).
Dans le cas de JDesktopPane, le composant que l’on va ajouter est un objet de la classe JInternalFrame qui correspond aux fenêtres filles d’une application MDI.
En plus de la méthode add(), d’autres méthodes peuvent être utiles, comme :
- JInternalFrame [] getAllFrames() : retourne une collection de JInternalFrame actuellement affichées dans le JDesktopPane.
- setSelectedFrame(JInternalFrame f ) : rend la JInternalFrame « f » active.
Il est accéssible par le biais de la méthode getContentPane() et setContentPane(Container c) de l’interface RootPaneContainer implémentées par les conteneurs ayant un JRootPane.
4.4.5.JInternalFrame
JInternalFrame est une fenêtre qui peut être déplacée, agrandie, réduite, iconifiée, … JInternalFrame contient un JRootPane comme JFrame. On peut donc avoir accès à son glassPane, contentPane, LayeredPane, et menuBar. On va donc agir comme on le faisait avec JFrame.
Voici ci-dessous des méthodes utiles :
- setLocation(int x, int y) définit la position de la JInternalFrame.
- setLocationRelativeTo(null) positionne selon le centre de l’écran.
- setSize(int,int) définit la taille de la fenêtre.
- setDefaultCloseOperation() ici on donnera la constante :
- HIDE_ON_CLOSE
- DISPOSE_ON_CLOSE
- DO_NOTHING_ON_CLOSE
- setResizable(boolean) définit si la fenêtre peut être retaillée ou non.
- setIconifiable(boolean) définit si la fenêtre peut être iconifiée ou no
- setIcon(boolean) iconifie / désiconifie la fenêtre.
- setMaximizable(boolean) définit si la fenêtre peut être agrandie ou non
- setMaximum(boolean) maximise la fenêtre ou revient à la taille normale
- setClosable(boolean) définit si la fenêtre peut être fermée ou non
- setClosed(boolean) ferme la fenêtre
4.4.6.ContentPane
C’est le conteneur assosié au JRootPane des conteneurs de haut-niveau et qui contient l’ensemble des composants affichables.
4.4.7.JMenuBar
JMenuBar est une barre de menu, il ne peut en exister qu’une seule par JFrame.
Une instance de JMenuBar est composée de plusieurs instances de JMenu, qui sont les éléments visibles directement dans la barre de menus.
Chaque instance de JMenu peut contenir plusieurs instances de JMenuItem, qui sont les éléments visibles quand l’utilisateur clique sur un menu.
Voici la liste des méthodes les plus utilisées afin de construire une fenêtre avec une barre de menu :
- JMenuBar() Constructeur unique.
- add(JMenu) Méthode d’ajout d’un menu à la barre de menu.
- JMenu() Constructeur par défaut.
- JMenu(string s) Constructeur d’un menu avec son libellé
- add(JMenu) Méthode d’ajout d’un JMenu au menu afin d’obtenir des sous-menus.
- add(JMenuItem item) Méthode d’ajout d’un JMenuItem au menu
- addSeparator() Méthode d’ajout d’une barre de séparation
- Classe JMenuItem (Elément de menu)
- JMenuItem() Constructeur par défaut
- JMenuItem(string s) Constructeur d’un élément de menu avec son libellé
- addActionListener(ActionListener al) Méthode d’ajout de Listener, permettant la gestion des évennements (nous verrons les Listener plus loin dans ce document).
- setJMenuBar(JMenuBar menu) Méthode pour transmettre une barre de menu à JFrame.
Voici un exemple de représentation hiérarchique des différentes classes à utiliser. Vouc remarquerez qu’il est tout à fait possible de réaliser des sous-menus :
 |
|
 |
