PanelRappel représente l’affichage graphique
+ * d’un rappel dans l’application Papillon.
+ * + * Chaque panneau contient le titre, un aperçu du contenu, ainsi qu’une + * couleur correspondant au thème du rappel. + * L’utilisateur peut interagir avec ce panneau (sélection, clic droit, etc.). + *
+ * + * @version 1.0 + * @author Seri-khane YOLOU, Aylane SEHL, Jenson VAL + */ public class PanelRappel extends JPanel implements ActionListener, MouseListener { + + /** Indique si le rappel est actuellement sélectionné. */ private boolean estSelectionne = false; + /** Label affichant le titre du rappel. */ private JLabel lbtitre; + + /** Label affichant un aperçu du contenu du rappel. */ private JLabel lbcontenu; + + /** Référence vers le rappel associé à ce panneau. */ private Rappel r; + /** Menu contextuel (clic droit). */ private JPopupMenu menu; + + /** Élément du menu permettant d’ouvrir le rappel. */ private JMenuItem itemOuvrir; + + /** Référence à la fenêtre principale. */ private Main main; + /** Liste des couleurs disponibles pour les thèmes. */ private static CouleurList couleur = new CouleurList(); + /** + * Constructeur du panneau associé à un rappel et à la fenêtre principale. + * + * @param r le rappel à afficher + * @param main la fenêtre principale + */ public PanelRappel(Rappel r, Main main) { super(new BorderLayout(2, 0)); this.main = main; createPanel(r); } + /** + * Constructeur du panneau associé à un rappel sans référence à la fenêtre principale. + * + * @param r le rappel à afficher + */ public PanelRappel(Rappel r) { super(new BorderLayout(2, 0)); createPanel(r); } + /** + * Initialise et configure le panneau pour afficher les informations du rappel. + * + * @param r le rappel à afficher + */ public void createPanel(Rappel r){ this.r = r; - // --- Titre et contenu raccourci --- + // Titre et contenu raccourci lbtitre = new JLabel("[" + r.getRang() + "] " + r.getTitre()); lbcontenu = new JLabel( "" + (r.getContenu().length() > 40 ? r.getContenu().substring(0, 40) + "..." : r.getContenu()) + "" ); - // --- Apparence de base --- + // - Apparence de base this.setPreferredSize(new Dimension(70, 50)); this.setBackground(couleur.couleurDe(r.getTheme())); this.setBorder(BorderFactory.createLineBorder(Color.LIGHT_GRAY, 2)); @@ -44,44 +87,69 @@ public class PanelRappel extends JPanel implements ActionListener, MouseListener GridBagConstraints c = new GridBagConstraints(); c.anchor = GridBagConstraints.NORTHWEST; - // --- Position du titre --- + // - Position du titre c.gridx = 0; c.gridy = 0; c.weightx = 1; c.fill = GridBagConstraints.NONE; add(lbtitre, c); - // --- Position du contenu --- + // -Position du contenu c.gridx = 0; c.gridy = 1; c.weightx = 1; c.fill = GridBagConstraints.NONE; add(lbcontenu, c); - // --- Menu contextuel (clic droit) --- + // - Menu contextuel (clic droit) menu = new JPopupMenu(); itemOuvrir = new JMenuItem("Ouvrir"); itemOuvrir.addActionListener(this); menu.add(itemOuvrir); - // --- Activation des clics --- + // - Activation des clics addMouseListener(this); } - // === GETTERS === + // GETTERS + + + /** + * Indique si le panneau est actuellement sélectionné. + * + * @return true si le panneau est sélectionné, false sinon + */ public boolean getSelection() { return estSelectionne; } + /** + * Renvoie l’identifiant du rappel affiché. + * + * @return l’identifiant unique du rappel + */ public int getId() { return r.getId(); } + /** + * Renvoie le rappel associé à ce panneau. + * + * @return le rappel affiché dans ce panneau + */ public Rappel getRappel() { return r; } - // === ACTIONS === + + /** + * Gère les actions déclenchées par les éléments du menu contextuel. + *+ * Si l’utilisateur clique sur "Ouvrir", la fenêtre détaillée du rappel est affichée. + *
+ * + * @param e l’événement d’action déclenché + */ @Override public void actionPerformed(ActionEvent e) { Object src = e.getSource(); @@ -92,7 +160,15 @@ public class PanelRappel extends JPanel implements ActionListener, MouseListener } } - // === GESTION DES CLICS SOURIS === + /** + * Gère les clics de souris sur le panneau. + *+ * Un clic gauche sélectionne/désélectionne le panneau, + * tandis qu’un clic droit affiche le menu contextuel. + *
+ * + * @param e l’événement de souris détecté + */ @Override public void mousePressed(MouseEvent e) { if (e.isPopupTrigger()) { @@ -104,6 +180,15 @@ public class PanelRappel extends JPanel implements ActionListener, MouseListener } } + + /** + * Gère la libération du clic de souris. + *+ * Si le clic est un clic droit, le menu contextuel s’affiche. + *
+ * + * @param e l’événement de souris + */ @Override public void mouseReleased(MouseEvent e) { if (e.isPopupTrigger()) { @@ -111,6 +196,15 @@ public class PanelRappel extends JPanel implements ActionListener, MouseListener } } + + /** + * Gère les clics simples ou doubles sur le panneau. + *+ * Un double clic gauche ouvre la fenêtre de rappel complète. + *
+ * + * @param e l’événement de souris + */ @Override public void mouseClicked(MouseEvent e) { // === Double clic pour ouvrir la vue complète === @@ -120,17 +214,35 @@ public class PanelRappel extends JPanel implements ActionListener, MouseListener } } + /** + * Change l’apparence du panneau lorsque la souris entre dans sa zone. + * + * @param e l’événement de souris + */ @Override public void mouseEntered(MouseEvent e) { setBorder(BorderFactory.createLineBorder(Color.BLACK, 1)); } + /** + * Restaure la bordure du panneau lorsque la souris quitte sa zone. + * + * @param e l’événement de souris + */ @Override public void mouseExited(MouseEvent e) { setBorder(BorderFactory.createLineBorder(Color.LIGHT_GRAY, 1)); } + /** + * Met à jour l’apparence du panneau en fonction de son état de sélection. + *+ * Si le panneau est sélectionné, son fond devient gris clair + * et une bordure noire est appliquée. + * Sinon, la couleur de fond correspond au thème du rappel. + *
+ */ private void majApparence() { if (estSelectionne) { setBackground(Color.LIGHT_GRAY); diff --git a/src/fr/iutfbleau/papillon/Rappel.java b/src/fr/iutfbleau/papillon/Rappel.java index 46e6fb7..6b018ba 100644 --- a/src/fr/iutfbleau/papillon/Rappel.java +++ b/src/fr/iutfbleau/papillon/Rappel.java @@ -1,9 +1,11 @@ +package fr.iutfbleau.papillon; + /** * La classeRappel représente un rappel utilisateur,
* avec un titre, un contenu, un thème et un rang de priorité.
*
* @version 1.0
- * @author Seri-khane Yolou, Aylane SEHL, Jenson VAL
+ * @author Seri-khane YOLOU, Aylane SEHL, Jenson VAL
*/
public class Rappel {
diff --git a/src/fr/iutfbleau/papillon/Utilisateur.java b/src/fr/iutfbleau/papillon/Utilisateur.java
index 5e28f6f..86f1eca 100644
--- a/src/fr/iutfbleau/papillon/Utilisateur.java
+++ b/src/fr/iutfbleau/papillon/Utilisateur.java
@@ -49,4 +49,4 @@ public class Utilisateur {
public String toString() {
return "Utilisateur [id=" + id + ", cle=" + cle + "]";
}
-}
\ No newline at end of file
+}
diff --git a/src/fr/iutfbleau/papillon/UtilisateurBD.java b/src/fr/iutfbleau/papillon/UtilisateurBD.java
index aab4000..fbf621b 100644
--- a/src/fr/iutfbleau/papillon/UtilisateurBD.java
+++ b/src/fr/iutfbleau/papillon/UtilisateurBD.java
@@ -1,3 +1,5 @@
+package fr.iutfbleau.papillon;
+
import java.sql.*;
/**
@@ -7,7 +9,7 @@ import java.sql.*;
* et de lire un utilisateur complet via sa clé.
*
* @version 1.0
- * @author Junior
+ * @author Seri-khane YOLOU, Aylane SEHL, Jenson VAL
*/
public class UtilisateurBD {
diff --git a/src/fr/iutfbleau/papillon/logo.png b/src/fr/iutfbleau/papillon/logo.png
new file mode 100644
index 0000000..60280aa
Binary files /dev/null and b/src/fr/iutfbleau/papillon/logo.png differ