src/gtk/icon_legend.c

   1 /*
   2  * This file Copyright (C) 2005 Paul Mangan <claws@thewildbeast.co.uk>
   3  * and the Sylpheed-Claws team
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License
  16  * along with this program; if not, write to the Free Software
  17  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18  */
  19
  20 #ifdef HAVE_CONFIG_H
  21 #  include "config.h"
  22 #endif
  23
  24 #include "defs.h"
  25
  26 #include <glib.h>
  27 #include <glib/gi18n.h>
  28 #include <gtk/gtk.h>
  29 #include <gdk/gdkkeysyms.h>
  30 #include <gtk/gtkwidget.h>
  31 #include <gtk/gtkwindow.h>
  32 #include <gtk/gtksignal.h>
  33 #include <gtk/gtkvbox.h>
  34 #include <gtk/gtkhbox.h>
  35 #include <gtk/gtklabel.h>
  36
  37 #include "gtkutils.h"
  38 #include "stock_pixmap.h"
  39 #include "prefs_gtk.h"
  40
  41 #define ICONS 17
  42
  43 StockPixmap legend_icons[ICONS] = {
  44         STOCK_PIXMAP_NEW,
  45         STOCK_PIXMAP_UNREAD,
  46         STOCK_PIXMAP_REPLIED,
  47         STOCK_PIXMAP_FORWARDED,
  48         STOCK_PIXMAP_IGNORETHREAD,
  49         STOCK_PIXMAP_SPAM,
  50         STOCK_PIXMAP_CLIP,
  51         STOCK_PIXMAP_GPG_SIGNED,
  52         STOCK_PIXMAP_KEY,
  53         STOCK_PIXMAP_CLIP_GPG_SIGNED,
  54         STOCK_PIXMAP_CLIP_KEY,
  55         STOCK_PIXMAP_MARK,
  56         STOCK_PIXMAP_DELETED,
  57         STOCK_PIXMAP_LOCKED,
  58         STOCK_PIXMAP_DIR_OPEN,
  59         STOCK_PIXMAP_DIR_OPEN_HRM,
  60         STOCK_PIXMAP_DIR_OPEN_MARK,
  61 };
  62
  63 static gchar *legend_icon_desc[] = {
  64 /* status column */
  65         N_("New message"),
  66         N_("Unread message"),
  67         N_("Message has been replied to"),
  68         N_("Message has been forwarded"),
  69         N_("Message is in an ignored thread"),
  70         N_("Message is spam"),
  71 /* attachment column */
  72         N_("Message has attachment(s)"),
  73         N_("Digitally signed message"),
  74         N_("Encrypted message"),
  75         N_("Message is signed and has attachment(s)"),
  76         N_("Message is encrypted and has attachment(s)"),
  77 /* mark column */
  78         N_("Marked message"),
  79         N_("Message is marked for deletion"),
  80 /* locked column */
  81         N_("Locked message"),
  82 /* others */
  83         N_("Folder (normal, opened)"),
  84         N_("Folder with read messages hidden"),
  85         N_("Folder contains marked messages"),
  86 };
  87
  88 static struct LegendDialog {
  89         GtkWidget *window;
  90 } legend;
  91
  92 static void legend_create(void);
  93 static gboolean key_pressed(GtkWidget *widget, GdkEventKey *event);
  94 static void legend_close(void);
  95
  96 void legend_show(void)
  97 {
  98         if (!legend.window)
  99                 legend_create();
 100         else
 101                 gtk_window_present(GTK_WINDOW(legend.window));
 102 }
 103
 104 static void legend_create(void)
 105 {
 106         GtkWidget *window;
 107         GtkWidget *vbox;
 108         GtkWidget *confirm_area;
 109         GtkWidget *close_button;
 110         GtkWidget *hbox;
 111         GtkWidget *label;
 112         GtkWidget *icon_label;
 113         GtkWidget *desc_label;
 114         gint i;
 115
 116         window = gtk_window_new(GTK_WINDOW_TOPLEVEL);
 117         gtk_window_set_title(GTK_WINDOW(window), _("Icon Legend"));
 118         gtk_container_set_border_width(GTK_CONTAINER(window), 8);
 119         gtk_window_set_resizable(GTK_WINDOW(window), FALSE);
 120         gtk_widget_set_size_request(window, -1, -1);
 121         g_signal_connect(G_OBJECT(window), "delete_event",
 122                          G_CALLBACK(legend_close), NULL);
 123         g_signal_connect(G_OBJECT(window), "key_press_event",
 124                          G_CALLBACK(key_pressed), NULL);
 125         gtk_widget_realize(window);
 126
 127         vbox = gtk_vbox_new(FALSE, 8);
 128         gtk_container_add(GTK_CONTAINER(window), vbox);
 129         gtk_container_set_border_width(GTK_CONTAINER(vbox), 2);
 130
 131         hbox = gtk_hbox_new(FALSE, 8);
 132         gtk_widget_show(hbox);
 133         gtk_box_pack_start(GTK_BOX(vbox), hbox, FALSE, FALSE, 0);
 134
 135         label = gtk_label_new(_("<span weight=\"bold\">The following icons "
 136                                 "are used to show the status of messages and "
 137                                 "folders:</span>"));
 138         gtk_label_set_use_markup(GTK_LABEL(label), TRUE);
 139         gtk_label_set_line_wrap(GTK_LABEL(label), TRUE);
 140         gtk_widget_show(label);
 141         gtk_box_pack_start(GTK_BOX(hbox), label, FALSE, FALSE, 0);
 142
 143         for (i = 0; i < ICONS; ++i) {
 144                 icon_label = stock_pixmap_widget(window, legend_icons[i]);
 145                 desc_label = gtk_label_new(gettext(legend_icon_desc[i]));
 146                 gtk_label_set_line_wrap(GTK_LABEL(desc_label), TRUE);
 147
 148                 hbox = gtk_hbox_new(FALSE, 4);
 149                 gtk_widget_show(hbox);
 150                 gtk_box_pack_start(GTK_BOX(vbox), hbox, FALSE, FALSE, 0);
 151                 gtk_box_pack_start(GTK_BOX(hbox), icon_label, FALSE, FALSE, 0);
 152                 gtk_box_pack_start(GTK_BOX(hbox), desc_label, FALSE, FALSE, 0);
 153         }
 154
 155         gtkut_stock_button_set_create(&confirm_area, &close_button, GTK_STOCK_CLOSE,
 156                                       NULL, NULL, NULL, NULL);
 157         gtk_box_pack_end(GTK_BOX(vbox), confirm_area, FALSE, FALSE, 4);
 158         gtk_widget_grab_default(close_button);
 159         g_signal_connect_closure
 160                 (G_OBJECT(close_button), "clicked",
 161                  g_cclosure_new_swap(G_CALLBACK(legend_close),
 162                                      window, NULL), FALSE);
 163
 164         gtk_widget_show_all(window);
 165
 166         legend.window = window;
 167 }
 168
 169 static gboolean key_pressed(GtkWidget *widget, GdkEventKey *event)
 170 {
 171         if (event && event->keyval == GDK_Escape) {
 172                 legend_close();
 173         }
 174         return FALSE;
 175 }
 176
 177 static void legend_close(void)
 178 {
 179         gtk_widget_destroy(legend.window);
 180         legend.window = NULL;
 181 }