Création d'interfaces graphiques Java avec des composants Swing

Cet article explore la boîte à outils Swing de Java. Une bibliothèque pour créer des interfaces utilisateur graphiques (GUI) à l'aide de composants tels que JFrame, JDialog et JApplet, qui servent de conteneurs essentiels de niveau supérieur. Il montre également comment créer un formulaire de contact simple à l'aide des composants Swing.

---

Swing est une bibliothèque Java utilisée pour créer des interfaces utilisateur graphiques (GUI) simples. Il s'agit d'une boîte à outils de widgets GUI fournissant une collection de composants pour la construction d'interfaces graphiques. (Oracle Docs, s.d.a). Les composants Swing sont entièrement écrits dans le langage de programmation Java. Il existe trois classes de conteneurs de niveau supérieur généralement utiles : JFrame, JDialog et JApplet (Oracle Docs, s.d. b).

Conteneur de niveau supérieur :

Un JFrame est une fenêtre de niveau supérieur avec un titre et une bordure.

(Oracle Docs, s.d.b, Comment créer des cadres (fenêtres principales).

Une fenêtre JDialog est une sous-fenêtre indépendante qui est temporairement visible en dehors de la fenêtre principale de l'application Swing.

(Oracle Docs, s.d.b, Comment créer des boîtes de dialogue)

«JApplet, une applet Java est un type spécial de programme Java qu'un navigateur compatible avec la technologie Java peut télécharger depuis Internet et exécuter. Une applet est généralement intégrée à une page Web et s'exécute dans le contexte d'un navigateur. Une applet doit être une sous-classe de l'applet. Classe d'applets. La classe Applet fournit l'interface standard entre l'applet et l'environnement du navigateur » (Oracle Docs, s.d.c).
Chaque programme qui utilise des composants Swing comprend au moins un conteneur de niveau supérieur. Ce conteneur de niveau supérieur sert de racine d'une hiérarchie de confinement, qui englobe tous les composants Swing au sein du conteneur (Oracle Docs, s.d.b).

En général, une application autonome avec une interface graphique basée sur Swing aura au moins une hiérarchie de confinement avec un JFrame comme racine. Par exemple, si une application comporte une fenêtre principale et deux boîtes de dialogue, elle aura trois hiérarchies de confinement, chacune avec son propre conteneur de niveau supérieur. La fenêtre principale aura un JFrame comme racine, tandis que chaque boîte de dialogue aura un JDialog comme racine. Une applet basée sur Swing a également au moins une hiérarchie de confinement, dont une enracinée par un objet JApplet. Par exemple, une applet qui affiche une boîte de dialogue aura deux hiérarchies de confinement. Les composants dans la fenêtre du navigateur appartiennent à une hiérarchie de confinement enracinée par un objet JApplet, tandis que la boîte de dialogue appartient à une hiérarchie de confinement enracinée par un objet JDialog.

Classe JComponent :

À l'exception des conteneurs de niveau supérieur, tous les composants Swing qui commencent par « J » sont dérivés de la classe JComponent. Par exemple, JPanel, JScrollPane, JButton et JTable héritent tous de JComponent. Cependant, JFrame et JDialog ne le font pas, car ce sont des conteneurs de niveau supérieur (Oracle Docs, s.d.b, The JComponent Class)

Différences entre le cadre et le panneau :

Cadre :
Un JFrame est un conteneur de niveau supérieur qui représente une fenêtre avec un titre, des bordures et des boutons.
Il est généralement utilisé comme fenêtre principale d'une application.
Un JFrame peut contenir plusieurs composants, notamment JPanel, JScrollPane, JButton, JTable, etc.

Panneau :
Un JPanel est un conteneur générique utilisé pour regrouper un ensemble de composants dans une fenêtre.
Il n'a pas de décorations de fenêtre comme une barre de titre ou un bouton de fermeture.
Un JPanel est souvent utilisé pour organiser et gérer la mise en page au sein d'un JFrame.

Chaque programme qui utilise des composants Swing comprend au moins un conteneur de niveau supérieur. Ce conteneur de niveau supérieur sert de racine d'une hiérarchie de confinement, qui englobe tous les composants Swing au sein du conteneur (Oracle Docs, s.d.b).

En général, une application autonome avec une interface graphique basée sur Swing aura au moins une hiérarchie de confinement avec un JFrame comme racine. Par exemple, si une application comporte une fenêtre principale et deux boîtes de dialogue, elle aura trois hiérarchies de confinement, chacune avec son propre conteneur de niveau supérieur. La fenêtre principale aura un JFrame comme racine, tandis que chaque boîte de dialogue aura un JDialog comme racine.

Une applet basée sur Swing possède également au moins une hiérarchie de confinement, dont une enracinée par un objet JApplet. Par exemple, une applet qui affiche une boîte de dialogue aura deux hiérarchies de confinement. Les composants dans la fenêtre du navigateur appartiennent à une hiérarchie de confinement enracinée par un objet JApplet, tandis que la boîte de dialogue appartient à une hiérarchie de confinement enracinée par un objet JDialog.

L'exemple ci-dessous inclut un JFrame et un JPanel, ainsi que des composants supplémentaires tels que des boutons, des champs de texte et des étiquettes utilisant un GridBagLayout. De plus, il affiche également un message utilisant JDialog, le composant JOptionPane et un composant de fenêtre Dialog. Il s'agit d'un formulaire de contact simple à interface utilisateur graphique (GUI) utilisant des composants Swing.

//--- Abstract Window Toolkit (AWT)

// Provides layout manager for arranging components in five regions: 
// north, south, east, west, and center.
import java.awt.BorderLayout;
// Grid layout - Specifies constraints for components that are laid out using the GridBagLayout.
import java.awt.GridBagConstraints;
// Grid - layout manager that aligns components vertically and horizontally, 
// without requiring the components to be of the same size.
import java.awt.GridBagLayout;
// Gird padding - Specifies the space (padding) between components and their borders.
import java.awt.Insets;
// Button - Provides the capability to handle action events like button clicks.
import java.awt.event.ActionEvent;
// Button event - Allows handling of action events, such as button clicks.
import java.awt.event.ActionListener;

//--- swing GUI

// Button - Provides a button component that can trigger actions when clicked.
import javax.swing.JButton;
// Frame - Provides a window with decorations 
// such as a title, border, and buttons for closing and minimizing.
import javax.swing.JFrame;
// Labels - Provides a display area for a short text string or an image, or both.
import javax.swing.JLabel;
// Submition Message - Provides standard dialog boxes such as message, input, and confirmation dialogs.
import javax.swing.JOptionPane;
// Panel - Provides a generic container for grouping components together.
import javax.swing.JPanel;
// Scroll user message - Provides to the a scrollable view of a lightweight component.
import javax.swing.JScrollPane;
// User message - Provides a multi-line area to display/edit plain text.
import javax.swing.JTextArea;
// Name & Email - Provides a single-line text field for user input.
import javax.swing.JTextField;

/**
 * This class generates a simple contact form. The form includes fields for the
 * user's name, email, and message, and a submit button to submit the form.
 * 
 * @author Alejandro Ricciardi
 * @version 1.0
 * @date 06/16/2024
 */
public class contactForm {
    /**
     * The main method to create and display the contact form.
     *
     * @param args Command line arguments
     */
    public static void main(String[] args) {

        /*------------
         |   Frame   |
         ------------*/

        // ---- Initializes frame
        // Creates the main application frame
        JFrame frame = new JFrame("Contact Form");
        frame.setSize(400, 300); // Set the size of the frame
                // Close the application when the frame is closed
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); 
        frame.setLayout(new BorderLayout()); // Use BorderLayout for the frame

        /*------------
         |   Panel   |
         ------------*/

        // ---- Initializes panel
        // Create a panel with GridBagLayout
        JPanel panel = new JPanel(new GridBagLayout());
        GridBagConstraints gridForm = new GridBagConstraints();
        gridForm.insets = new Insets(5, 5, 5, 5); // Add padding around components

        // ---- Creates and adds grid components to the panel       // -- Name
        // Adds "Name" label
        JLabel nameLabel = new JLabel("Name:");
        gridForm.gridx = 0; // Position at column 0
        gridForm.gridy = 0; // Position at row 0
        panel.add(nameLabel, gridForm);
        // Add text field for name input
        JTextField nameField = new JTextField(20);
        gridForm.gridx = 1; // Position at column 1
        gridForm.gridy = 0; // Position at row 0
        panel.add(nameField, gridForm);

        // -- Email
        // Add "Email" label
        JLabel emailLabel = new JLabel("Email:");
        gridForm.gridx = 0; // Position at column 0
        gridForm.gridy = 1; // Position at row 1
        panel.add(emailLabel, gridForm);
        // Adds text field for email input
        JTextField emailField = new JTextField(20);
        gridForm.gridx = 1; // Position at column 1
        gridForm.gridy = 1; // Position at row 1
        panel.add(emailField, gridForm);

        // Adds "Message" label
        JLabel messageLabel = new JLabel("Message:");
        gridForm.gridx = 0; // Position at column 0
        gridForm.gridy = 2; // Position at row 2
        panel.add(messageLabel, gridForm);

        // -- Message
        // Adds text area for message input with a scroll pane
        JTextArea messageArea = new JTextArea(5, 20);
        JScrollPane scrollPane = new JScrollPane(messageArea);
        gridForm.gridx = 1; // Position at column 1
        gridForm.gridy = 2; // Position at row 2
        panel.add(scrollPane, gridForm);
        // Adds "Submit" button
        JButton submitButton = new JButton("Submit");
        gridForm.gridx = 1; // Position at column 1
        gridForm.gridy = 3; // Position at row 3
        panel.add(submitButton, gridForm);

        // Adds the panel to the frame's center
        frame.add(panel, BorderLayout.CENTER);

        // Make the frame visible
        frame.setVisible(true);

        /*------------
         |  JDialog  |
         ------------*/
        // Add action listener to the submit button
        ActionListener submitBtnClicked = new ActionListener() {
            @Override
            public void actionPerformed(ActionEvent e) {
                // Display a message dialog when the submit button is clicked
                JOptionPane.showMessageDialog(frame, "Message was sent!");
            }
        };

        submitButton.addActionListener(submitBtnClicked);
    }
}

Si vous souhaitez en savoir plus sur les fenêtres de dialogue, la vidéo suivante décrit comment implémenter un message JDialog JOptionPane.

Pour résumer, la boîte à outils Swing de Java propose un ensemble de composants qui permettent aux développeurs de créer des interfaces graphiques conviviales et visuellement structurées. La bibliothèque utilise des conteneurs de niveau supérieur tels que JFrame, JDialog et JApplet, ainsi que des éléments essentiels tels que JPanel et JOptionPane.

---

Références :

Oracle Docs. (s.d.a). Balançoire. Oracle. https://docs.oracle.com/javase/8/docs/technotes/guides/swing/

Oracle Docs. (s.d.b). Utilisation de conteneurs de niveau supérieur. Les didacticiels Java™. Oracle. https://docs.oracle.com/javase/tutorial/uiswing/components/toplevel.html

Oracle Docs. (s.d.c). Applet Java. Les didacticiels Java™. Oracle. https://docs.oracle.com/javase/tutorial/deployment/applet/index.html

---

Publié à l'origine par Alex.omegapy sur Medium le 3 novembre 2024.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!