Pileus Git - ~andy/gtk/blob - gtk/gtktooltip.c

   1 /* gtktooltip.c
   2  *
   3  * Copyright (C) 2006-2007 Imendio AB
   4  * Contact: Kristian Rietveld <kris@imendio.com>
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Library General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Library General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Library General Public
  17  * License along with this library; if not, write to the
  18  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  19  * Boston, MA 02111-1307, USA.
  20  */
  21
  22 #include <config.h>
  23 #include "gtktooltip.h"
  24 #include "gtkintl.h"
  25 #include "gtkwindow.h"
  26 #include "gtkmain.h"
  27 #include "gtklabel.h"
  28 #include "gtkimage.h"
  29 #include "gtkhbox.h"
  30 #include "gtkalignment.h"
  31
  32 #include "gtkalias.h"
  33
  34 #include <string.h>
  35
  36
  37 #define GTK_TOOLTIP_CLASS(klass)         (G_TYPE_CHECK_CLASS_CAST ((klass), GTK_TYPE_TOOLTIP, GtkTooltipClass))
  38 #define GTK_IS_TOOLTIP_CLASS(klass)      (G_TYPE_CHECK_CLASS_TYPE ((klass), GTK_TYPE_TOOLTIP))
  39 #define GTK_TOOLTIP_GET_CLASS(obj)       (G_TYPE_INSTANCE_GET_CLASS ((obj), GTK_TYPE_TOOLTIP, GtkTooltipClass))
  40
  41 typedef struct _GtkTooltipClass   GtkTooltipClass;
  42
  43 struct _GtkTooltip
  44 {
  45   GObject parent_instance;
  46
  47   GtkWidget *window;
  48   GtkWidget *alignment;
  49   GtkWidget *box;
  50   GtkWidget *image;
  51   GtkWidget *label;
  52   GtkWidget *custom_widget;
  53
  54   GtkWindow *current_window;
  55   GtkWidget *keyboard_widget;
  56
  57   GtkWidget *tooltip_widget;
  58   GdkWindow *toplevel_window;
  59
  60   gdouble last_x;
  61   gdouble last_y;
  62   GdkWindow *last_window;
  63
  64   guint timeout_id;
  65   guint browse_mode_timeout_id;
  66
  67   GdkRectangle tip_area;
  68
  69   guint browse_mode_enabled : 1;
  70   guint keyboard_mode_enabled : 1;
  71   guint tip_area_set : 1;
  72 };
  73
  74 struct _GtkTooltipClass
  75 {
  76   GObjectClass parent_class;
  77 };
  78
  79 #define GTK_TOOLTIP_VISIBLE(tooltip) ((tooltip)->current_window && GTK_WIDGET_VISIBLE ((tooltip)->current_window))
  80
  81
  82 static void       gtk_tooltip_class_init           (GtkTooltipClass *klass);
  83 static void       gtk_tooltip_init                 (GtkTooltip      *tooltip);
  84 static void       gtk_tooltip_finalize             (GObject         *object);
  85
  86 static gboolean   gtk_tooltip_paint_window         (GtkTooltip      *tooltip);
  87 static void       gtk_tooltip_window_hide          (GtkWidget       *widget,
  88                                                     gpointer         user_data);
  89 static void       gtk_tooltip_display_closed       (GdkDisplay      *display,
  90                                                     gboolean         was_error,
  91                                                     GtkTooltip      *tooltip);
  92
  93
  94 G_DEFINE_TYPE (GtkTooltip, gtk_tooltip, G_TYPE_OBJECT);
  95
  96 static void
  97 gtk_tooltip_class_init (GtkTooltipClass *klass)
  98 {
  99   GObjectClass *object_class;
 100
 101   object_class = G_OBJECT_CLASS (klass);
 102
 103   object_class->finalize = gtk_tooltip_finalize;
 104 }
 105
 106 static void
 107 gtk_tooltip_init (GtkTooltip *tooltip)
 108 {
 109   tooltip->timeout_id = 0;
 110   tooltip->browse_mode_timeout_id = 0;
 111
 112   tooltip->browse_mode_enabled = FALSE;
 113   tooltip->keyboard_mode_enabled = FALSE;
 114
 115   tooltip->current_window = NULL;
 116   tooltip->keyboard_widget = NULL;
 117
 118   tooltip->tooltip_widget = NULL;
 119   tooltip->toplevel_window = NULL;
 120
 121   tooltip->last_window = NULL;
 122
 123   tooltip->window = g_object_ref (gtk_window_new (GTK_WINDOW_POPUP));
 124   gtk_window_set_type_hint (GTK_WINDOW (tooltip->window),
 125                             GDK_WINDOW_TYPE_HINT_TOOLTIP);
 126   gtk_widget_set_app_paintable (tooltip->window, TRUE);
 127   gtk_window_set_resizable (GTK_WINDOW (tooltip->window), FALSE);
 128   gtk_widget_set_name (tooltip->window, "gtk-tooltip");
 129   g_signal_connect (tooltip->window, "hide",
 130                     G_CALLBACK (gtk_tooltip_window_hide), tooltip);
 131
 132   tooltip->alignment = gtk_alignment_new (0.5, 0.5, 1.0, 1.0);
 133   gtk_alignment_set_padding (GTK_ALIGNMENT (tooltip->alignment),
 134                              tooltip->window->style->ythickness,
 135                              tooltip->window->style->ythickness,
 136                              tooltip->window->style->xthickness,
 137                              tooltip->window->style->xthickness);
 138   gtk_container_add (GTK_CONTAINER (tooltip->window), tooltip->alignment);
 139   gtk_widget_show (tooltip->alignment);
 140
 141   g_signal_connect_swapped (tooltip->window, "expose_event",
 142                             G_CALLBACK (gtk_tooltip_paint_window), tooltip);
 143
 144   tooltip->box = gtk_hbox_new (FALSE, tooltip->window->style->xthickness);
 145   gtk_container_add (GTK_CONTAINER (tooltip->alignment), tooltip->box);
 146   gtk_widget_show (tooltip->box);
 147
 148   tooltip->image = gtk_image_new ();
 149   gtk_box_pack_start (GTK_BOX (tooltip->box), tooltip->image,
 150                       FALSE, FALSE, 0);
 151
 152   tooltip->label = gtk_label_new ("");
 153   gtk_box_pack_start (GTK_BOX (tooltip->box), tooltip->label,
 154                       FALSE, FALSE, 0);
 155
 156   tooltip->custom_widget = NULL;
 157 }
 158
 159 static void
 160 gtk_tooltip_finalize (GObject *object)
 161 {
 162   GtkTooltip *tooltip = GTK_TOOLTIP (object);
 163
 164   if (tooltip->timeout_id)
 165     {
 166       g_source_remove (tooltip->timeout_id);
 167       tooltip->timeout_id = 0;
 168     }
 169
 170   if (tooltip->browse_mode_timeout_id)
 171     {
 172       g_source_remove (tooltip->browse_mode_timeout_id);
 173       tooltip->browse_mode_timeout_id = 0;
 174     }
 175
 176   if (tooltip->window)
 177     {
 178       GdkDisplay *display;
 179
 180       display = gtk_widget_get_display (tooltip->window);
 181       g_signal_handlers_disconnect_by_func (display,
 182                                             gtk_tooltip_display_closed,
 183                                             tooltip);
 184       gtk_widget_destroy (tooltip->window);
 185     }
 186
 187   G_OBJECT_CLASS (gtk_tooltip_parent_class)->finalize (object);
 188 }
 189
 190 /* public API */
 191
 192 /**
 193  * gtk_tooltip_set_markup:
 194  * @tooltip: a #GtkTooltip
 195  * @markup: a markup string (see <link linkend="PangoMarkupFormat">Pango markup format</link>) or %NULL
 196  *
 197  * Sets the text of the tooltip to be @markup, which is marked up
 198  * with the <link
 199  * linkend="PangoMarkupFormat">Pango text markup language</link>.
 200  * If @markup is %NULL, the label will be hidden.
 201  *
 202  * Since: 2.12
 203  */
 204 void
 205 gtk_tooltip_set_markup (GtkTooltip  *tooltip,
 206                         const gchar *markup)
 207 {
 208   g_return_if_fail (GTK_IS_TOOLTIP (tooltip));
 209
 210   gtk_label_set_markup (GTK_LABEL (tooltip->label), markup);
 211
 212   if (markup)
 213     gtk_widget_show (tooltip->label);
 214   else
 215     gtk_widget_hide (tooltip->label);
 216 }
 217
 218 /**
 219  * gtk_tooltip_set_text:
 220  * @tooltip: a #GtkTooltip
 221  * @text: a text string or %NULL
 222  *
 223  * Sets the text of the tooltip to be @text. If @text is %NULL, the label
 224  * will be hidden. See also gtk_tooltip_set_markup().
 225  *
 226  * Since: 2.12
 227  */
 228 void
 229 gtk_tooltip_set_text (GtkTooltip  *tooltip,
 230                       const gchar *text)
 231 {
 232   g_return_if_fail (GTK_IS_TOOLTIP (tooltip));
 233
 234   gtk_label_set_text (GTK_LABEL (tooltip->label), text);
 235
 236   if (text)
 237     gtk_widget_show (tooltip->label);
 238   else
 239     gtk_widget_hide (tooltip->label);
 240 }
 241
 242 /**
 243  * gtk_tooltip_set_icon:
 244  * @tooltip: a #GtkTooltip
 245  * @pixbuf: a #GdkPixbuf, or %NULL
 246  *
 247  * Sets the icon of the tooltip (which is in front of the text) to be
 248  * @pixbuf.  If @pixbuf is %NULL, the image will be hidden.
 249  *
 250  * Since: 2.12
 251  */
 252 void
 253 gtk_tooltip_set_icon (GtkTooltip *tooltip,
 254                       GdkPixbuf  *pixbuf)
 255 {
 256   g_return_if_fail (GTK_IS_TOOLTIP (tooltip));
 257   if (pixbuf)
 258     g_return_if_fail (GDK_IS_PIXBUF (pixbuf));
 259
 260   gtk_image_set_from_pixbuf (GTK_IMAGE (tooltip->image), pixbuf);
 261
 262   if (pixbuf)
 263     gtk_widget_show (tooltip->image);
 264   else
 265     gtk_widget_hide (tooltip->image);
 266 }
 267
 268 /**
 269  * gtk_tooltip_set_icon_from_stock:
 270  * @tooltip: a #GtkTooltip
 271  * @stock_id: a stock icon name, or %NULL
 272  * @size: a stock icon size
 273  *
 274  * Sets the icon of the tooltip (which is in front of the text) to be
 275  * the stock item indicated by @stock_id with the size indicated
 276  * by @size.  If @stock_id is %NULL, the image will be hidden.
 277  *
 278  * Since: 2.12
 279  */
 280 void
 281 gtk_tooltip_set_icon_from_stock (GtkTooltip  *tooltip,
 282                                  const gchar *stock_id,
 283                                  GtkIconSize  size)
 284 {
 285   g_return_if_fail (GTK_IS_TOOLTIP (tooltip));
 286
 287   gtk_image_set_from_stock (GTK_IMAGE (tooltip->image), stock_id, size);
 288
 289   if (stock_id)
 290     gtk_widget_show (tooltip->image);
 291   else
 292     gtk_widget_hide (tooltip->image);
 293 }
 294
 295 /**
 296  * gtk_tooltip_set_custom:
 297  * @tooltip: a #GtkTooltip
 298  * @custom_widget: a #GtkWidget
 299  *
 300  * Replaces the widget packed into the tooltip with @custom_widget.
 301  * By default a box with a #GtkImage and #GtkLabel is embedded in
 302  * the tooltip, which can be configured using gtk_tooltip_set_markup()
 303  * and gtk_tooltip_set_icon().
 304  *
 305  * Since: 2.12
 306  */
 307 void
 308 gtk_tooltip_set_custom (GtkTooltip *tooltip,
 309                         GtkWidget  *custom_widget)
 310 {
 311   g_return_if_fail (GTK_IS_TOOLTIP (tooltip));
 312   if (custom_widget)
 313     g_return_if_fail (GTK_IS_WIDGET (custom_widget));
 314
 315   if (tooltip->custom_widget)
 316     {
 317       gtk_container_remove (GTK_CONTAINER (tooltip->box),
 318                             tooltip->custom_widget);
 319       g_object_unref (tooltip->custom_widget);
 320     }
 321
 322   if (custom_widget)
 323     {
 324       tooltip->custom_widget = g_object_ref (custom_widget);
 325
 326       gtk_container_add (GTK_CONTAINER (tooltip->box), custom_widget);
 327       gtk_widget_show (custom_widget);
 328     }
 329   else
 330     tooltip->custom_widget = NULL;
 331 }
 332
 333 /**
 334  * gtk_tooltip_set_tip_area:
 335  * @tooltip: a #GtkTooltip
 336  * @rect: a #GdkRectangle
 337  *
 338  * Sets the area of the widget, where the contents of this tooltip apply,
 339  * to be @rect (in widget coordinates).  This is especially useful for
 340  * properly setting tooltips on #GtkTreeView rows and cells, #GtkIconViews,
 341  * etc.
 342  *
 343  * For setting tooltips on #GtkTreeView, please refer to the convenience
 344  * functions for this: gtk_tree_view_set_tooltip_row() and
 345  * gtk_tree_view_set_tooltip_cell().
 346  *
 347  * Since: 2.12
 348  */
 349 void
 350 gtk_tooltip_set_tip_area (GtkTooltip   *tooltip,
 351                           GdkRectangle *rect)
 352 {
 353   g_return_if_fail (GTK_IS_TOOLTIP (tooltip));
 354
 355   if (!rect)
 356     tooltip->tip_area_set = FALSE;
 357   else
 358     {
 359       tooltip->tip_area_set = TRUE;
 360       tooltip->tip_area = *rect;
 361     }
 362 }
 363
 364 /**
 365  * gtk_tooltip_trigger_tooltip_query:
 366  * @display: a #GdkDisplay
 367  *
 368  * Triggers a new tooltip query on @display, in order to update the current
 369  * visible tooltip, or to show/hide the current tooltip.  This function is
 370  * useful to call when, for example, the state of the widget changed by a
 371  * key press.
 372  *
 373  * Since: 2.12
 374  */
 375 void
 376 gtk_tooltip_trigger_tooltip_query (GdkDisplay *display)
 377 {
 378   gint x, y;
 379   GdkWindow *window;
 380   GdkEvent event;
 381
 382   /* Trigger logic as if the mouse moved */
 383   window = gdk_display_get_window_at_pointer (display, &x, &y);
 384   if (!window)
 385     return;
 386
 387   event.type = GDK_MOTION_NOTIFY;
 388   event.motion.window = window;
 389   event.motion.x = x;
 390   event.motion.y = y;
 391   event.motion.is_hint = FALSE;
 392
 393   _gtk_tooltip_handle_event (&event);
 394 }
 395
 396 /* private functions */
 397
 398 static void
 399 gtk_tooltip_reset (GtkTooltip *tooltip)
 400 {
 401   gtk_tooltip_set_markup (tooltip, NULL);
 402   gtk_tooltip_set_icon (tooltip, NULL);
 403   gtk_tooltip_set_custom (tooltip, NULL);
 404   gtk_tooltip_set_tip_area (tooltip, NULL);
 405 }
 406
 407 static gboolean
 408 gtk_tooltip_paint_window (GtkTooltip *tooltip)
 409 {
 410   gtk_paint_flat_box (tooltip->window->style,
 411                       tooltip->window->window,
 412                       GTK_STATE_NORMAL,
 413                       GTK_SHADOW_OUT,
 414                       NULL,
 415                       tooltip->window,
 416                       "tooltip",
 417                       0, 0,
 418                       tooltip->window->allocation.width,
 419                       tooltip->window->allocation.height);
 420
 421   return FALSE;
 422 }
 423
 424 static void
 425 gtk_tooltip_window_hide (GtkWidget *widget,
 426                          gpointer   user_data)
 427 {
 428   GtkTooltip *tooltip = GTK_TOOLTIP (user_data);
 429
 430   if (tooltip->custom_widget)
 431     gtk_tooltip_set_custom (tooltip, NULL);
 432 }
 433
 434 /* event handling, etc */
 435
 436 struct ChildLocation
 437 {
 438   GtkWidget *child;
 439   GtkWidget *container;
 440
 441   gint x;
 442   gint y;
 443 };
 444
 445 static void
 446 child_location_foreach (GtkWidget *child,
 447                         gpointer   data)
 448 {
 449   gint x, y;
 450   struct ChildLocation *child_loc = data;
 451
 452   /* Ignore invisible widgets */
 453   if (!GTK_WIDGET_DRAWABLE (child))
 454     return;
 455
 456   if (!child_loc->child &&
 457       gtk_widget_translate_coordinates (child_loc->container, child,
 458                                         child_loc->x, child_loc->y,
 459                                         &x, &y))
 460     {
 461       if (x >= 0 && x < child->allocation.width
 462           && y >= 0 && y < child->allocation.height)
 463         {
 464           if (GTK_IS_CONTAINER (child))
 465             {
 466               struct ChildLocation tmp = { NULL, NULL, 0, 0 };
 467
 468               tmp.x = x;
 469               tmp.y = y;
 470               tmp.container = child;
 471
 472               gtk_container_forall (GTK_CONTAINER (child),
 473                                     child_location_foreach, &tmp);
 474
 475               if (tmp.child)
 476                 child_loc->child = tmp.child;
 477               else
 478                 child_loc->child = child;
 479             }
 480           else
 481             child_loc->child = child;
 482         }
 483     }
 484 }
 485
 486 static void
 487 window_to_alloc (GtkWidget *dest_widget,
 488                  gint       src_x,
 489                  gint       src_y,
 490                  gint      *dest_x,
 491                  gint      *dest_y)
 492 {
 493   /* Translate from window relative to allocation relative */
 494   if (!GTK_WIDGET_NO_WINDOW (dest_widget) && dest_widget->parent)
 495     {
 496       gint wx, wy;
 497       gdk_window_get_position (dest_widget->window, &wx, &wy);
 498
 499       src_x += wx - dest_widget->allocation.x;
 500       src_y += wy - dest_widget->allocation.y;
 501     }
 502   else
 503     {
 504       src_x -= dest_widget->allocation.x;
 505       src_y -= dest_widget->allocation.y;
 506     }
 507
 508   if (dest_x)
 509     *dest_x = src_x;
 510   if (dest_y)
 511     *dest_y = src_y;
 512 }
 513
 514 static GtkWidget *
 515 find_widget_under_pointer (GdkWindow *window,
 516                            gint      *x,
 517                            gint      *y)
 518 {
 519   GtkWidget *event_widget;
 520   struct ChildLocation child_loc = { NULL, NULL, 0, 0 };
 521
 522   gdk_window_get_user_data (window, (void **)&event_widget);
 523
 524   if (!event_widget)
 525     return NULL;
 526
 527   child_loc.x = *x;
 528   child_loc.y = *y;
 529
 530   while (window && window != event_widget->window)
 531     {
 532       gint px, py;
 533
 534       gdk_window_get_position (window, &px, &py);
 535       child_loc.x += px;
 536       child_loc.y += py;
 537
 538       window = gdk_window_get_parent (window);
 539     }
 540
 541   if (GTK_WIDGET_NO_WINDOW (event_widget))
 542     {
 543       child_loc.x += event_widget->allocation.x;
 544       child_loc.y += event_widget->allocation.y;
 545     }
 546
 547   /* Failing to find widget->window can happen for e.g. a detached handle box;
 548    * chaining ::query-tooltip up to its parent probably makes little sense,
 549    * and users better implement tooltips on handle_box->child.
 550    * so we simply ignore the event for tooltips here.
 551    */
 552   if (!window)
 553     return NULL;
 554
 555   if (GTK_IS_CONTAINER (event_widget))
 556     {
 557       window_to_alloc (event_widget,
 558                        child_loc.x, child_loc.y,
 559                        &child_loc.x, &child_loc.y);
 560
 561       child_loc.container = event_widget;
 562       child_loc.child = NULL;
 563
 564       gtk_container_forall (GTK_CONTAINER (event_widget),
 565                             child_location_foreach, &child_loc);
 566
 567       if (child_loc.child)
 568         event_widget = child_loc.child;
 569       else if (child_loc.container)
 570         event_widget = child_loc.container;
 571     }
 572
 573   if (x)
 574     *x = child_loc.x;
 575   if (y)
 576     *y = child_loc.y;
 577
 578   return event_widget;
 579 }
 580
 581 static GtkWidget *
 582 find_topmost_widget_coords_from_event (GdkEvent *event,
 583                                        gint     *x,
 584                                        gint     *y)
 585 {
 586   gint tx, ty;
 587   gdouble dx, dy;
 588   GtkWidget *tmp;
 589
 590   gdk_event_get_coords (event, &dx, &dy);
 591   tx = dx;
 592   ty = dy;
 593
 594   tmp = find_widget_under_pointer (event->any.window, &tx, &ty);
 595
 596   if (x)
 597     *x = tx;
 598   if (y)
 599     *y = ty;
 600
 601   return tmp;
 602 }
 603
 604 static gint
 605 tooltip_browse_mode_expired (gpointer data)
 606 {
 607   GtkTooltip *tooltip;
 608
 609   tooltip = GTK_TOOLTIP (data);
 610
 611   tooltip->browse_mode_enabled = FALSE;
 612   tooltip->browse_mode_timeout_id = 0;
 613
 614   /* destroy tooltip */
 615   g_object_set_data (G_OBJECT (gtk_widget_get_display (tooltip->window)),
 616                      "gdk-display-current-tooltip", NULL);
 617
 618   return FALSE;
 619 }
 620
 621 static void
 622 gtk_tooltip_display_closed (GdkDisplay *display,
 623                             gboolean    was_error,
 624                             GtkTooltip *tooltip)
 625 {
 626   g_object_set (display, "gdk-display-current-tooltip", NULL);
 627 }
 628
 629 static gboolean
 630 gtk_tooltip_run_requery (GtkWidget  **widget,
 631                          GtkTooltip  *tooltip,
 632                          gint        *x,
 633                          gint        *y)
 634 {
 635   gboolean has_tooltip = FALSE;
 636   gboolean return_value = FALSE;
 637
 638   gtk_tooltip_reset (tooltip);
 639
 640   do
 641     {
 642       g_object_get (*widget,
 643                     "has-tooltip", &has_tooltip,
 644                     NULL);
 645
 646       if (has_tooltip)
 647         g_signal_emit_by_name (*widget,
 648                                "query-tooltip",
 649                                *x, *y,
 650                                tooltip->keyboard_mode_enabled,
 651                                tooltip,
 652                                &return_value);
 653
 654       if (!return_value)
 655         {
 656           GtkWidget *parent = (*widget)->parent;
 657
 658           if (parent)
 659             gtk_widget_translate_coordinates (*widget, parent, *x, *y, x, y);
 660
 661           *widget = parent;
 662         }
 663       else
 664         break;
 665     }
 666   while (*widget);
 667
 668   return return_value;
 669 }
 670
 671 static void
 672 gtk_tooltip_position (GtkTooltip *tooltip,
 673                       GdkDisplay *display,
 674                       GtkWidget  *new_tooltip_widget)
 675 {
 676   gint x, y;
 677   GdkScreen *screen;
 678
 679   tooltip->tooltip_widget = new_tooltip_widget;
 680
 681   /* Position the tooltip */
 682   /* FIXME: should we swap this when RTL is enabled? */
 683   if (tooltip->keyboard_mode_enabled)
 684     {
 685       gdk_window_get_origin (new_tooltip_widget->window, &x, &y);
 686       if (GTK_WIDGET_NO_WINDOW (new_tooltip_widget))
 687         {
 688           x += new_tooltip_widget->allocation.x;
 689           y += new_tooltip_widget->allocation.y;
 690         }
 691
 692       /* For keyboard mode we position the tooltip below the widget,
 693        * right of the center of the widget.
 694        */
 695       x += new_tooltip_widget->allocation.width / 2;
 696       y += new_tooltip_widget->allocation.height + 4;
 697     }
 698   else
 699     {
 700       guint cursor_size;
 701
 702       x = tooltip->last_x;
 703       y = tooltip->last_y;
 704
 705       /* For mouse mode, we position the tooltip right of the cursor,
 706        * a little below the cursor's center.
 707        */
 708       cursor_size = gdk_display_get_default_cursor_size (display);
 709       x += cursor_size / 2;
 710       y += cursor_size / 2;
 711     }
 712
 713   screen = gtk_widget_get_screen (new_tooltip_widget);
 714
 715   /* Show it */
 716   if (tooltip->current_window)
 717     {
 718       gint monitor_num;
 719       GdkRectangle monitor;
 720       GtkRequisition requisition;
 721
 722       gtk_widget_size_request (GTK_WIDGET (tooltip->current_window),
 723                                &requisition);
 724
 725       monitor_num = gdk_screen_get_monitor_at_point (screen, x, y);
 726       gdk_screen_get_monitor_geometry (screen, monitor_num, &monitor);
 727
 728       if (x + requisition.width > monitor.x + monitor.width)
 729         x -= x - (monitor.x + monitor.width) + requisition.width;
 730       else if (x < monitor.x)
 731         x = monitor.x;
 732
 733       if (y + requisition.height > monitor.y + monitor.height)
 734         y -= y - (monitor.y + monitor.height) + requisition.height;
 735
 736       gtk_window_move (GTK_WINDOW (tooltip->current_window), x, y);
 737       gtk_widget_show (GTK_WIDGET (tooltip->current_window));
 738     }
 739 }
 740
 741 static void
 742 gtk_tooltip_show_tooltip (GdkDisplay *display)
 743 {
 744   gint x, y;
 745   GdkScreen *screen;
 746
 747   GdkWindow *window;
 748   GtkWidget *tooltip_widget;
 749   GtkWidget *pointer_widget;
 750   GtkTooltip *tooltip;
 751   gboolean has_tooltip;
 752   gboolean return_value = FALSE;
 753
 754   tooltip = g_object_get_data (G_OBJECT (display),
 755                                "gdk-display-current-tooltip");
 756
 757   if (tooltip->keyboard_mode_enabled)
 758     {
 759       pointer_widget = tooltip_widget = tooltip->keyboard_widget;
 760     }
 761   else
 762     {
 763       window = tooltip->last_window;
 764
 765       if (!GDK_IS_WINDOW (window))
 766         return;
 767
 768       gdk_window_get_origin (window, &x, &y);
 769       x = tooltip->last_x - x;
 770       y = tooltip->last_y - y;
 771
 772       pointer_widget = tooltip_widget = find_widget_under_pointer (window,
 773                                                                    &x, &y);
 774     }
 775
 776   if (!tooltip_widget)
 777     return;
 778
 779   g_object_get (tooltip_widget, "has-tooltip", &has_tooltip, NULL);
 780
 781   g_assert (tooltip != NULL);
 782
 783   return_value = gtk_tooltip_run_requery (&tooltip_widget, tooltip, &x, &y);
 784   if (!return_value)
 785     return;
 786
 787   if (!tooltip->current_window)
 788     {
 789       if (gtk_widget_get_tooltip_window (tooltip_widget))
 790         tooltip->current_window = gtk_widget_get_tooltip_window (tooltip_widget);
 791       else
 792         tooltip->current_window = GTK_WINDOW (GTK_TOOLTIP (tooltip)->window);
 793     }
 794
 795   screen = gtk_widget_get_screen (tooltip_widget);
 796
 797   /* FIXME: should use tooltip->current_window iso tooltip->window */
 798   if (screen != gtk_widget_get_screen (tooltip->window))
 799     {
 800       g_signal_handlers_disconnect_by_func (display,
 801                                             gtk_tooltip_display_closed,
 802                                             tooltip);
 803
 804       gtk_window_set_screen (GTK_WINDOW (tooltip->window), screen);
 805
 806       g_signal_connect (display, "closed",
 807                         G_CALLBACK (gtk_tooltip_display_closed), tooltip);
 808     }
 809
 810   gtk_tooltip_position (tooltip, display, tooltip_widget);
 811
 812   /* Now a tooltip is visible again on the display, make sure browse
 813    * mode is enabled.
 814    */
 815   tooltip->browse_mode_enabled = TRUE;
 816   if (tooltip->browse_mode_timeout_id)
 817     {
 818       g_source_remove (tooltip->browse_mode_timeout_id);
 819       tooltip->browse_mode_timeout_id = 0;
 820     }
 821 }
 822
 823 static void
 824 gtk_tooltip_hide_tooltip (GtkTooltip *tooltip)
 825 {
 826   if (!tooltip)
 827     return;
 828
 829   if (tooltip->timeout_id)
 830     {
 831       g_source_remove (tooltip->timeout_id);
 832       tooltip->timeout_id = 0;
 833     }
 834
 835   if (!GTK_TOOLTIP_VISIBLE (tooltip))
 836     return;
 837
 838   tooltip->tooltip_widget = NULL;
 839
 840   if (!tooltip->keyboard_mode_enabled)
 841     {
 842       guint timeout;
 843       GtkSettings *settings;
 844
 845       settings = gtk_widget_get_settings (GTK_WIDGET (tooltip->window));
 846
 847       g_object_get (settings,
 848                     "gtk-tooltip-browse-mode-timeout", &timeout,
 849                     NULL);
 850
 851       /* The tooltip is gone, after (by default, should be configurable) 500ms
 852        * we want to turn off browse mode
 853        */
 854       if (!tooltip->browse_mode_timeout_id)
 855         tooltip->browse_mode_timeout_id =
 856           gdk_threads_add_timeout_full (0, timeout,
 857                                         tooltip_browse_mode_expired,
 858                                         g_object_ref (tooltip),
 859                                         g_object_unref);
 860     }
 861   else
 862     {
 863       if (tooltip->browse_mode_timeout_id)
 864         {
 865           g_source_remove (tooltip->browse_mode_timeout_id);
 866           tooltip->browse_mode_timeout_id = 0;
 867         }
 868     }
 869
 870   if (tooltip->current_window)
 871     {
 872       gtk_widget_hide (GTK_WIDGET (tooltip->current_window));
 873       tooltip->current_window = NULL;
 874     }
 875 }
 876
 877 static gint
 878 tooltip_popup_timeout (gpointer data)
 879 {
 880   GdkDisplay *display;
 881   GtkTooltip *tooltip;
 882
 883   display = GDK_DISPLAY_OBJECT (data);
 884
 885   gtk_tooltip_show_tooltip (display);
 886
 887   tooltip = g_object_get_data (G_OBJECT (display),
 888                                "gdk-display-current-tooltip");
 889   tooltip->timeout_id = 0;
 890
 891   return FALSE;
 892 }
 893
 894 static void
 895 gtk_tooltip_start_delay (GdkDisplay *display)
 896 {
 897   guint timeout;
 898   GtkTooltip *tooltip;
 899   GtkSettings *settings;
 900
 901   tooltip = g_object_get_data (G_OBJECT (display),
 902                                "gdk-display-current-tooltip");
 903
 904   if (tooltip && GTK_TOOLTIP_VISIBLE (tooltip))
 905     return;
 906
 907   if (tooltip->timeout_id)
 908     g_source_remove (tooltip->timeout_id);
 909
 910   settings = gtk_widget_get_settings (GTK_WIDGET (tooltip->window));
 911
 912   if (tooltip->browse_mode_enabled)
 913     g_object_get (settings, "gtk-tooltip-browse-timeout", &timeout, NULL);
 914   else
 915     g_object_get (settings, "gtk-tooltip-timeout", &timeout, NULL);
 916
 917   tooltip->timeout_id = gdk_threads_add_timeout_full (0, timeout,
 918                                                       tooltip_popup_timeout,
 919                                                       g_object_ref (display),
 920                                                       g_object_unref);
 921 }
 922
 923 void
 924 _gtk_tooltip_focus_in (GtkWidget *widget)
 925 {
 926   gint x, y;
 927   gboolean return_value = FALSE;
 928   GdkDisplay *display;
 929   GtkTooltip *tooltip;
 930
 931   /* Get current tooltip for this display */
 932   display = gtk_widget_get_display (widget);
 933   tooltip = g_object_get_data (G_OBJECT (display),
 934                                "gdk-display-current-tooltip");
 935
 936   /* Check if keyboard mode is enabled at this moment */
 937   if (!tooltip || !tooltip->keyboard_mode_enabled)
 938     return;
 939
 940   if (tooltip->keyboard_widget)
 941     g_object_unref (tooltip->keyboard_widget);
 942
 943   tooltip->keyboard_widget = g_object_ref (widget);
 944
 945   gdk_window_get_pointer (widget->window, &x, &y, NULL);
 946
 947   return_value = gtk_tooltip_run_requery (&widget, tooltip, &x, &y);
 948   if (!return_value)
 949     {
 950       gtk_tooltip_hide_tooltip (tooltip);
 951       return;
 952     }
 953
 954   if (!tooltip->current_window)
 955     {
 956       if (gtk_widget_get_tooltip_window (widget))
 957         tooltip->current_window = gtk_widget_get_tooltip_window (widget);
 958       else
 959         tooltip->current_window = GTK_WINDOW (GTK_TOOLTIP (tooltip)->window);
 960     }
 961
 962   gtk_tooltip_show_tooltip (display);
 963 }
 964
 965 void
 966 _gtk_tooltip_focus_out (GtkWidget *widget)
 967 {
 968   GdkDisplay *display;
 969   GtkTooltip *tooltip;
 970
 971   /* Get current tooltip for this display */
 972   display = gtk_widget_get_display (widget);
 973   tooltip = g_object_get_data (G_OBJECT (display),
 974                                "gdk-display-current-tooltip");
 975
 976   if (!tooltip || !tooltip->keyboard_mode_enabled)
 977     return;
 978
 979   if (tooltip->keyboard_widget)
 980     {
 981       g_object_unref (tooltip->keyboard_widget);
 982       tooltip->keyboard_widget = NULL;
 983     }
 984
 985   gtk_tooltip_hide_tooltip (tooltip);
 986 }
 987
 988 void
 989 _gtk_tooltip_toggle_keyboard_mode (GtkWidget *widget)
 990 {
 991   GdkDisplay *display;
 992   GtkTooltip *tooltip;
 993
 994   display = gtk_widget_get_display (widget);
 995   tooltip = g_object_get_data (G_OBJECT (display),
 996                                "gdk-display-current-tooltip");
 997
 998   if (!tooltip)
 999     {
1000       tooltip = g_object_new (GTK_TYPE_TOOLTIP, NULL);
1001       g_object_set_data_full (G_OBJECT (display),
1002                               "gdk-display-current-tooltip",
1003                               tooltip, g_object_unref);
1004     }
1005
1006   tooltip->keyboard_mode_enabled ^= 1;
1007
1008   if (tooltip->keyboard_mode_enabled)
1009     {
1010       tooltip->keyboard_widget = g_object_ref (widget);
1011       _gtk_tooltip_focus_in (widget);
1012     }
1013   else
1014     {
1015       if (tooltip->keyboard_widget)
1016         {
1017           g_object_unref (tooltip->keyboard_widget);
1018           tooltip->keyboard_widget = NULL;
1019         }
1020
1021       gtk_tooltip_hide_tooltip (tooltip);
1022     }
1023 }
1024
1025 void
1026 _gtk_tooltip_hide (GtkWidget *widget)
1027 {
1028   GtkWidget *toplevel;
1029   GdkDisplay *display;
1030   GtkTooltip *tooltip;
1031
1032   display = gtk_widget_get_display (widget);
1033   tooltip = g_object_get_data (G_OBJECT (display),
1034                                "gdk-display-current-tooltip");
1035
1036   if (!tooltip || !GTK_TOOLTIP_VISIBLE (tooltip) || !tooltip->tooltip_widget)
1037     return;
1038
1039   toplevel = gtk_widget_get_toplevel (widget);
1040
1041   if (widget == tooltip->tooltip_widget
1042       || toplevel->window == tooltip->toplevel_window)
1043     gtk_tooltip_hide_tooltip (tooltip);
1044 }
1045
1046 void
1047 _gtk_tooltip_handle_event (GdkEvent *event)
1048 {
1049   gint x, y;
1050   gboolean return_value = FALSE;
1051   GtkWidget *has_tooltip_widget = NULL;
1052   GdkDisplay *display;
1053   GtkTooltip *current_tooltip;
1054
1055   has_tooltip_widget = find_topmost_widget_coords_from_event (event, &x, &y);
1056   display = gdk_drawable_get_display (event->any.window);
1057   current_tooltip = g_object_get_data (G_OBJECT (display),
1058                                        "gdk-display-current-tooltip");
1059
1060   if (current_tooltip)
1061     {
1062       current_tooltip->last_window = event->any.window;
1063       gdk_event_get_root_coords (event,
1064                                 &current_tooltip->last_x,
1065                                 &current_tooltip->last_y);
1066     }
1067
1068   if (current_tooltip && current_tooltip->keyboard_mode_enabled)
1069     {
1070       has_tooltip_widget = current_tooltip->keyboard_widget;
1071       if (!has_tooltip_widget)
1072         return;
1073
1074       return_value = gtk_tooltip_run_requery (&has_tooltip_widget,
1075                                               current_tooltip,
1076                                               &x, &y);
1077
1078       if (!return_value)
1079         gtk_tooltip_hide_tooltip (current_tooltip);
1080       else
1081         gtk_tooltip_start_delay (display);
1082
1083       return;
1084     }
1085
1086   /* Always poll for a next motion event */
1087   gdk_event_request_motions (&event->motion);
1088
1089   /* Hide the tooltip when there's no new tooltip widget */
1090   if (!has_tooltip_widget)
1091     {
1092       if (current_tooltip && GTK_TOOLTIP_VISIBLE (current_tooltip))
1093         gtk_tooltip_hide_tooltip (current_tooltip);
1094
1095       return;
1096     }
1097
1098   switch (event->type)
1099     {
1100       case GDK_BUTTON_PRESS:
1101       case GDK_2BUTTON_PRESS:
1102       case GDK_3BUTTON_PRESS:
1103       case GDK_KEY_PRESS:
1104       case GDK_DRAG_ENTER:
1105       case GDK_GRAB_BROKEN:
1106         gtk_tooltip_hide_tooltip (current_tooltip);
1107         break;
1108
1109       case GDK_MOTION_NOTIFY:
1110       case GDK_ENTER_NOTIFY:
1111       case GDK_LEAVE_NOTIFY:
1112       case GDK_SCROLL:
1113         if (current_tooltip)
1114           {
1115             gboolean tip_area_set;
1116             GdkRectangle tip_area;
1117             gboolean hide_tooltip;
1118
1119             tip_area_set = current_tooltip->tip_area_set;
1120             tip_area = current_tooltip->tip_area;
1121
1122             return_value = gtk_tooltip_run_requery (&has_tooltip_widget,
1123                                                     current_tooltip,
1124                                                     &x, &y);
1125
1126             /* Requested to be hidden? */
1127             hide_tooltip = !return_value;
1128
1129             /* Is the pointer above another widget now? */
1130             if (GTK_TOOLTIP_VISIBLE (current_tooltip))
1131               hide_tooltip |= has_tooltip_widget != current_tooltip->tooltip_widget;
1132
1133             /* Did the pointer move out of the previous "context area"? */
1134             if (tip_area_set)
1135               hide_tooltip |= (x <= tip_area.x
1136                                || x >= tip_area.x + tip_area.width
1137                                || y <= tip_area.y
1138                                || y >= tip_area.y + tip_area.height);
1139
1140             if (hide_tooltip)
1141               gtk_tooltip_hide_tooltip (current_tooltip);
1142             else
1143               gtk_tooltip_start_delay (display);
1144           }
1145         else
1146           {
1147             /* Need a new tooltip for this display */
1148             current_tooltip = g_object_new (GTK_TYPE_TOOLTIP, NULL);
1149             g_object_set_data_full (G_OBJECT (display),
1150                                     "gdk-display-current-tooltip",
1151                                     current_tooltip, g_object_unref);
1152
1153             current_tooltip->last_window = event->any.window;
1154             gdk_event_get_root_coords (event,
1155                                        &current_tooltip->last_x,
1156                                        &current_tooltip->last_y);
1157
1158             gtk_tooltip_start_delay (display);
1159           }
1160         break;
1161
1162       default:
1163         break;
1164     }
1165 }
1166
1167
1168 #define __GTK_TOOLTIP_C__
1169 #include "gtkaliasdef.c"