lib/ev-tooltip.c

   1 /* this file is part of evince, a gnome document viewer
   2  *
   3  *  Copyright (C) 2004 Red Hat, Inc.
   4  *
   5  *  Author:
   6  *    Marco Pesenti Gritti <marco@gnome.org>
   7  *
   8  * Evince is free software; you can redistribute it and/or modify it
   9  * under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * Evince is distributed in the hope that it will be useful, but
  14  * WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  16  * General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
  21  */
  22
  23 #ifdef HAVE_CONFIG_H
  24 #include "config.h"
  25 #endif
  26
  27 #include "ev-tooltip.h"
  28
  29 #include <gtk/gtklabel.h>
  30
  31 #define DEFAULT_DELAY 500
  32 #define STICKY_DELAY 0
  33 #define STICKY_REVERT_DELAY 1000
  34
  35 struct _EvTooltipPrivate {
  36         GtkWidget *label;
  37         GTimeVal last_deactivate;
  38         int timer_tag;
  39         gboolean active;
  40 };
  41
  42 G_DEFINE_TYPE (EvTooltip, ev_tooltip, GTK_TYPE_WINDOW)
  43
  44 #define EV_TOOLTIP_GET_PRIVATE(object) \
  45                 (G_TYPE_INSTANCE_GET_PRIVATE ((object), EV_TYPE_TOOLTIP, EvTooltipPrivate))
  46
  47 static gboolean
  48 ev_tooltip_expose_event (GtkWidget      *widget,
  49                          GdkEventExpose *event)
  50 {
  51         gtk_paint_flat_box (widget->style, widget->window,
  52                             GTK_STATE_NORMAL, GTK_SHADOW_OUT,
  53                             NULL, widget, "tooltip", 0, 0,
  54                             widget->allocation.width, widget->allocation.height);
  55
  56         return GTK_WIDGET_CLASS (ev_tooltip_parent_class)->expose_event (widget, event);
  57 }
  58
  59 static void
  60 ev_tooltip_dispose (GObject *object)
  61 {
  62         EvTooltip *tooltip = EV_TOOLTIP (object);
  63
  64         if (tooltip->priv->timer_tag) {
  65                 g_source_remove (tooltip->priv->timer_tag);
  66                 tooltip->priv->timer_tag = 0;
  67         }
  68 }
  69
  70 static void
  71 ev_tooltip_class_init (EvTooltipClass *class)
  72 {
  73         GObjectClass *g_object_class = G_OBJECT_CLASS (class);
  74         GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (class);
  75
  76         g_object_class->dispose = ev_tooltip_dispose;
  77         widget_class->expose_event = ev_tooltip_expose_event;
  78
  79         g_type_class_add_private (g_object_class, sizeof (EvTooltipPrivate));
  80 }
  81
  82 static void
  83 ev_tooltip_init (EvTooltip *tooltip)
  84 {
  85         GtkWidget *window = GTK_WIDGET (tooltip);
  86         GtkWidget *label;
  87
  88         tooltip->priv = EV_TOOLTIP_GET_PRIVATE (tooltip);
  89
  90         gtk_widget_set_app_paintable (GTK_WIDGET (tooltip), TRUE);
  91         gtk_window_set_resizable (GTK_WINDOW (tooltip), FALSE);
  92         gtk_widget_set_name (window, "gtk-tooltips");
  93
  94         label = gtk_label_new (NULL);
  95         gtk_label_set_line_wrap (GTK_LABEL (label), TRUE);
  96         gtk_container_add (GTK_CONTAINER (window), label);
  97         gtk_container_set_border_width (GTK_CONTAINER (window), 3);
  98         tooltip->priv->label = label;
  99
 100         gtk_widget_show (label);
 101 }
 102
 103 /* Public functions */
 104
 105 GtkWidget *
 106 ev_tooltip_new (GtkWidget *parent)
 107 {
 108         GtkWidget *tooltip;
 109         GtkWidget *toplevel;
 110
 111         tooltip = g_object_new (EV_TYPE_TOOLTIP, NULL);
 112
 113         GTK_WINDOW (tooltip)->type = GTK_WINDOW_POPUP;
 114         EV_TOOLTIP (tooltip)->parent = parent;
 115
 116         toplevel = gtk_widget_get_toplevel (parent);
 117         gtk_window_set_transient_for (GTK_WINDOW (tooltip), GTK_WINDOW (toplevel));
 118
 119         return tooltip;
 120 }
 121
 122 void
 123 ev_tooltip_set_text (EvTooltip *tooltip, const char *text)
 124 {
 125         gtk_label_set_text (GTK_LABEL (tooltip->priv->label), text);
 126 }
 127
 128 void
 129 ev_tooltip_set_position (EvTooltip *tooltip, int x, int y)
 130 {
 131         int root_x = 0, root_y = 0;
 132
 133         if (tooltip->parent != NULL) {
 134                 gdk_window_get_origin (tooltip->parent->window, &root_x, &root_y);
 135         }
 136
 137         gtk_window_move (GTK_WINDOW (tooltip), x + root_x, y + root_y);
 138 }
 139
 140 static gboolean
 141 ev_tooltip_recently_shown (EvTooltip *tooltip)
 142 {
 143         GTimeVal now;
 144         glong msec;
 145
 146         g_get_current_time (&now);
 147
 148         msec = (now.tv_sec  - tooltip->priv->last_deactivate.tv_sec) * 1000 +
 149                (now.tv_usec - tooltip->priv->last_deactivate.tv_usec) / 1000;
 150
 151         return (msec < STICKY_REVERT_DELAY);
 152 }
 153
 154 static gint
 155 ev_tooltip_timeout (gpointer data)
 156 {
 157         GtkWidget *tooltip = GTK_WIDGET (data);
 158
 159         gtk_widget_show (tooltip);
 160
 161         return FALSE;
 162 }
 163
 164 void
 165 ev_tooltip_activate (EvTooltip *tooltip)
 166 {
 167         int delay;
 168
 169         if (tooltip->priv->active) {
 170                 return;
 171         } else {
 172                 tooltip->priv->active = TRUE;
 173         }
 174
 175         if (ev_tooltip_recently_shown (tooltip)) {
 176                 delay = STICKY_DELAY;
 177         } else {
 178                 delay = DEFAULT_DELAY;
 179         }
 180
 181         tooltip->priv->timer_tag = g_timeout_add (delay, ev_tooltip_timeout,
 182                                                   (gpointer)tooltip);
 183 }
 184
 185 void
 186 ev_tooltip_deactivate (EvTooltip *tooltip)
 187 {
 188         if (!tooltip->priv->active) {
 189                 return;
 190         } else {
 191                 tooltip->priv->active = FALSE;
 192         }
 193
 194         if (tooltip->priv->timer_tag) {
 195                 g_source_remove (tooltip->priv->timer_tag);
 196                 tooltip->priv->timer_tag = 0;
 197         }
 198
 199         gtk_widget_hide (GTK_WIDGET (tooltip));
 200
 201         g_get_current_time (&tooltip->priv->last_deactivate);
 202 }