+ * Cette classe crée la fenêtre du jeu, affiche le mot caché, les lettres incorrectes, + * le dessin du pendu (via {@link Affiche}), et permet à l'utilisateur de saisir des lettres. + * Elle gère également la logique de mise à jour et la fin de partie. + *
+ * + * @author + * @version 1.0 */ public class Action { - // Fenêtre principale du jeu + /** Fenêtre principale du jeu. */ private JFrame gameFrame; - // Labels pour afficher le mot, les lettres incorrectes et les vies + /** Label affichant le mot caché avec les lettres découvertes. */ private JLabel wordLabel; - private JLabel incorrectLettersLabel; - private JLabel livesLabel; - // Champ de saisie pour entrer une lettre + /** Label affichant la liste des lettres incorrectes. */ + private JLabel incorrectLettersLabel; + + /** Champ de texte permettant à l'utilisateur d'entrer une lettre. */ private JTextField letterInputField; - // Instance du jeu + /** Instance du jeu, contenant la logique (mot, vies, lettres, etc.). */ private Random_word game; + /** Composant graphique qui affiche le dessin du pendu. */ + private Affiche affiche; + /** - * Constructeur de la classe Action. - * Initialise le jeu, les composants graphiques et affiche la fenêtre. + * Constructeur de la classe {@code Action}. + *+ * Initialise le jeu, crée les composants graphiques, met en place la mise en page + * et affiche la fenêtre du jeu. + *
*/ public Action() { game = new Random_word(); @@ -36,27 +49,25 @@ public class Action { gameFrame.setVisible(true); } - // ==================== Initialisation des composants ==================== + // ==================== Initialisation ==================== /** - * Initialise tous les composants graphiques : - * - Fenêtre principale - * - Labels pour le mot, les vies et les lettres incorrectes - * - Champ de saisie pour entrer les lettres + * Initialise tous les composants graphiques (labels, champs, boutons...). */ private void initializeComponents() { gameFrame = new JFrame("Hanging Man"); gameFrame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); - gameFrame.setSize(600, 400); + gameFrame.setSize(700, 500); + + affiche = new Affiche(); + affiche.setPreferredSize(new Dimension(350, 400)); + affiche.setBackground(Color.WHITE); + affiche.setOpaque(true); wordLabel = new JLabel(game.getHiddenWord()); wordLabel.setFont(new Font("Arial", Font.BOLD, 32)); wordLabel.setHorizontalAlignment(SwingConstants.CENTER); - livesLabel = new JLabel("Lives: " + game.getLives()); - livesLabel.setFont(new Font("Arial", Font.BOLD, 20)); - livesLabel.setHorizontalAlignment(SwingConstants.CENTER); - incorrectLettersLabel = new JLabel("Incorrect letters: " + game.getIncorrectLetters()); incorrectLettersLabel.setFont(new Font("Arial", Font.PLAIN, 20)); incorrectLettersLabel.setHorizontalAlignment(SwingConstants.CENTER); @@ -65,119 +76,60 @@ public class Action { letterInputField.setFont(new Font("Arial", Font.PLAIN, 24)); } - // ==================== Layout des composants ==================== + // ==================== Mise en page ==================== /** - * Dispose les composants dans la fenêtre principale en utilisant GridBagLayout. - * Sépare la fenêtre en deux parties : le haut (mot et vies) et le bas (lettres incorrectes, saisie, bouton restart) + * Dispose les composants graphiques dans la fenêtre selon un {@link BorderLayout}. */ private void layoutComponents() { - JPanel mainPanel = new JPanel(new GridBagLayout()); - GridBagConstraints mainConstraints = new GridBagConstraints(); - mainConstraints.gridx = 0; - mainConstraints.fill = GridBagConstraints.BOTH; - mainConstraints.insets = new Insets(5, 5, 5, 5); + JPanel mainPanel = new JPanel(new BorderLayout()); - JPanel topPanel = createTopPanel(); - mainConstraints.gridy = 0; - mainConstraints.weighty = 3.0; - mainConstraints.weightx = 1.0; - mainPanel.add(topPanel, mainConstraints); + // --- panneau gauche : dessin du pendu --- + JPanel leftPanel = new JPanel(new BorderLayout()); + leftPanel.add(affiche, BorderLayout.CENTER); + mainPanel.add(leftPanel, BorderLayout.WEST); - JPanel bottomPanel = createBottomPanel(); - mainConstraints.gridy = 1; - mainConstraints.weighty = 1.0; - mainPanel.add(bottomPanel, mainConstraints); + // --- panneau droit : interface du jeu --- + JPanel rightPanel = new JPanel(new GridBagLayout()); + GridBagConstraints gbc = new GridBagConstraints(); + gbc.gridx = 0; + gbc.fill = GridBagConstraints.BOTH; + gbc.insets = new Insets(5, 5, 5, 5); - gameFrame.add(mainPanel, BorderLayout.CENTER); - } + // Mot caché + gbc.gridy = 0; + gbc.weighty = 1.0; + rightPanel.add(wordLabel, gbc); - /** - * Crée le panneau supérieur avec : - * - Le label des vies (à gauche) - * - Le label du mot caché (à droite) - * @return JPanel configuré pour la partie supérieure - */ - private JPanel createTopPanel() { - JPanel topPanel = new JPanel(new GridBagLayout()); - - // Panel pour les vies - JPanel livesPanel = new JPanel(new GridBagLayout()); - GridBagConstraints livesConstraints = new GridBagConstraints(); - livesConstraints.anchor = GridBagConstraints.CENTER; - livesConstraints.fill = GridBagConstraints.NONE; - livesPanel.add(livesLabel, livesConstraints); - - // Panel pour le mot - JPanel wordPanel = new JPanel(new GridBagLayout()); - GridBagConstraints wordConstraints = new GridBagConstraints(); - wordConstraints.anchor = GridBagConstraints.CENTER; - wordConstraints.fill = GridBagConstraints.NONE; - wordPanel.add(wordLabel, wordConstraints); - - // Ajout des panels dans topPanel - GridBagConstraints leftConstraints = new GridBagConstraints(); - leftConstraints.gridx = 0; - leftConstraints.weightx = 0.5; - leftConstraints.weighty = 1.0; - leftConstraints.fill = GridBagConstraints.BOTH; - topPanel.add(livesPanel, leftConstraints); - - GridBagConstraints rightConstraints = new GridBagConstraints(); - rightConstraints.gridx = 1; - rightConstraints.weightx = 0.5; - rightConstraints.weighty = 1.0; - rightConstraints.fill = GridBagConstraints.BOTH; - topPanel.add(wordPanel, rightConstraints); - - return topPanel; - } - - /** - * Crée le panneau inférieur avec : - * - Le label des lettres incorrectes - * - Le champ de saisie pour entrer une lettre - * - Le bouton "Restart" en bas à droite - * @return JPanel configuré pour la partie inférieure - */ - private JPanel createBottomPanel() { - JPanel bottomPanel = new JPanel(); - bottomPanel.setLayout(new BoxLayout(bottomPanel, BoxLayout.Y_AXIS)); - - // Label des lettres incorrectes - incorrectLettersLabel.setAlignmentX(Component.CENTER_ALIGNMENT); - bottomPanel.add(incorrectLettersLabel); + // Lettres incorrectes + gbc.gridy = 1; + rightPanel.add(incorrectLettersLabel, gbc); // Champ de saisie - JLabel promptLabel = new JLabel("Enter a letter:"); - promptLabel.setFont(new Font("Arial", Font.PLAIN, 16)); - promptLabel.setAlignmentX(Component.CENTER_ALIGNMENT); - - JPanel inputRow = new JPanel(new FlowLayout(FlowLayout.CENTER, 5, 5)); - inputRow.add(promptLabel); + gbc.gridy = 2; + JPanel inputRow = new JPanel(); + inputRow.add(new JLabel("Enter a letter:")); inputRow.add(letterInputField); - inputRow.setAlignmentX(Component.CENTER_ALIGNMENT); + rightPanel.add(inputRow, gbc); - bottomPanel.add(Box.createVerticalStrut(10)); - bottomPanel.add(inputRow); - - // Bouton "Restart" en bas à droite + // Bouton de redémarrage + gbc.gridy = 3; JButton restartButton = new JButton("Restart"); restartButton.addActionListener(new PlayButtonListener(gameFrame)); - JPanel buttonPanel = new JPanel(new FlowLayout(FlowLayout.RIGHT)); - buttonPanel.add(restartButton); + rightPanel.add(restartButton, gbc); - bottomPanel.add(Box.createVerticalStrut(10)); - bottomPanel.add(buttonPanel); - - return bottomPanel; + mainPanel.add(rightPanel, BorderLayout.CENTER); + gameFrame.add(mainPanel); } // ==================== Gestion du jeu ==================== /** * Gère la saisie d'une lettre par le joueur. - * Vérifie la validité de la lettre, met à jour l'affichage et termine le jeu si nécessaire. + *+ * Vérifie la validité de la lettre, met à jour le jeu, l'affichage + * et teste si la partie est terminée. + *
*/ private void handleGuess() { String inputText = letterInputField.getText(); @@ -187,17 +139,17 @@ public class Action { char guessedLetter = inputText.charAt(0); String message = game.guessLetter(guessedLetter); + updateUI(); if (game.isGameOver()) endGame(message); } /** - * Vérifie si la saisie de l'utilisateur est valide : - * - Une seule lettre - * - Caractère alphabétique - * @param inputText texte saisi par l'utilisateur - * @return true si la saisie est valide, false sinon + * Vérifie que la saisie de l'utilisateur est une seule lettre valide. + * + * @param inputText texte saisi dans le champ de saisie + * @return {@code true} si la saisie est valide, {@code false} sinon */ private boolean isValidInput(String inputText) { if (inputText.length() != 1 || !Character.isLetter(inputText.charAt(0))) { @@ -208,24 +160,33 @@ public class Action { } /** - * Met à jour l'affichage des labels : - * - Mot caché - * - Lettres incorrectes - * - Nombre de vies restantes + * Met à jour les éléments de l'interface graphique : + *+ * Cette classe hérite de {@link JComponent} et redéfinit la méthode + * {@link #paintComponent(Graphics)} pour afficher le pendu selon le nombre + * de vies restantes. Elle affiche également un message de victoire ou de défaite. + *
+ * + * @author + * @version 1.0 + */ class Affiche extends JComponent { - private int step = 0; + + /** Nombre de vies restantes (entre 0 et 8). */ + private int lives = 8; + + /** Indique si le joueur a gagné. */ private boolean youWin = false; - public void setStep(int step) { - this.step = step; + /** + * Définit le nombre de vies restantes et redessine le composant. + * + * @param lives nombre de vies restantes + */ + public void setLives(int lives) { + this.lives = lives; repaint(); } + /** + * Définit si le joueur a gagné et redessine le composant. + * + * @param value {@code true} si le joueur a gagné, sinon {@code false} + */ public void setYouWin(boolean value) { this.youWin = value; repaint(); } + /** + * Redessine le pendu en fonction du nombre de vies restantes. + *