1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * GtkQueryTips: Query onscreen widgets for their tooltips
5 * Copyright (C) 1998 Tim Janik
7 * This library is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Library General Public
9 * License as published by the Free Software Foundation; either
10 * version 2 of the License, or (at your option) any later version.
12 * This library is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Library General Public License for more details.
17 * You should have received a copy of the GNU Library General Public
18 * License along with this library; if not, write to the
19 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20 * Boston, MA 02111-1307, USA.
24 * Modified by the GTK+ Team and others 1997-1999. See the AUTHORS
25 * file for a list of people on the GTK+ Team. See the ChangeLog
26 * files for a list of changes. These files are distributed with
27 * GTK+ at ftp://ftp.gtk.org/pub/gtk/.
30 #include "gtktipsquery.h"
31 #include "gtksignal.h"
32 #include "gtktooltips.h"
38 /* --- arguments --- */
53 SIGNAL_WIDGET_ENTERED,
54 SIGNAL_WIDGET_SELECTED,
58 /* --- prototypes --- */
59 static void gtk_tips_query_class_init (GtkTipsQueryClass *class);
60 static void gtk_tips_query_init (GtkTipsQuery *tips_query);
61 static void gtk_tips_query_destroy (GtkObject *object);
62 static gint gtk_tips_query_event (GtkWidget *widget,
64 static void gtk_tips_query_set_arg (GtkObject *object,
67 static void gtk_tips_query_get_arg (GtkObject *object,
70 static void gtk_tips_query_real_start_query (GtkTipsQuery *tips_query);
71 static void gtk_tips_query_real_stop_query (GtkTipsQuery *tips_query);
72 static void gtk_tips_query_widget_entered (GtkTipsQuery *tips_query,
74 const gchar *tip_text,
75 const gchar *tip_private);
78 /* --- variables --- */
79 static GtkLabelClass *parent_class = NULL;
80 static guint tips_query_signals[SIGNAL_LAST] = { 0 };
83 /* --- functions --- */
85 gtk_tips_query_get_type (void)
87 static guint tips_query_type = 0;
91 static const GtkTypeInfo tips_query_info =
94 sizeof (GtkTipsQuery),
95 sizeof (GtkTipsQueryClass),
96 (GtkClassInitFunc) gtk_tips_query_class_init,
97 (GtkObjectInitFunc) gtk_tips_query_init,
98 /* reserved_1 */ NULL,
99 /* reserved_2 */ NULL,
100 (GtkClassInitFunc) NULL,
103 tips_query_type = gtk_type_unique (gtk_label_get_type (), &tips_query_info);
106 return tips_query_type;
110 gtk_tips_query_class_init (GtkTipsQueryClass *class)
112 GtkObjectClass *object_class;
113 GtkWidgetClass *widget_class;
115 object_class = (GtkObjectClass*) class;
116 widget_class = (GtkWidgetClass*) class;
118 parent_class = gtk_type_class (gtk_label_get_type ());
120 gtk_object_add_arg_type ("GtkTipsQuery::emit_always", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_EMIT_ALWAYS);
121 gtk_object_add_arg_type ("GtkTipsQuery::caller", GTK_TYPE_WIDGET, GTK_ARG_READWRITE, ARG_CALLER);
122 gtk_object_add_arg_type ("GtkTipsQuery::label_inactive", GTK_TYPE_STRING, GTK_ARG_READWRITE, ARG_LABEL_INACTIVE);
123 gtk_object_add_arg_type ("GtkTipsQuery::label_no_tip", GTK_TYPE_STRING, GTK_ARG_READWRITE, ARG_LABEL_NO_TIP);
125 tips_query_signals[SIGNAL_START_QUERY] =
126 gtk_signal_new ("start_query",
129 GTK_SIGNAL_OFFSET (GtkTipsQueryClass, start_query),
130 gtk_marshal_NONE__NONE,
132 tips_query_signals[SIGNAL_STOP_QUERY] =
133 gtk_signal_new ("stop_query",
136 GTK_SIGNAL_OFFSET (GtkTipsQueryClass, stop_query),
137 gtk_marshal_NONE__NONE,
139 tips_query_signals[SIGNAL_WIDGET_ENTERED] =
140 gtk_signal_new ("widget_entered",
143 GTK_SIGNAL_OFFSET (GtkTipsQueryClass, widget_entered),
144 gtk_marshal_NONE__POINTER_STRING_STRING,
149 tips_query_signals[SIGNAL_WIDGET_SELECTED] =
150 gtk_signal_new ("widget_selected",
153 GTK_SIGNAL_OFFSET (GtkTipsQueryClass, widget_selected),
154 gtk_marshal_BOOL__POINTER_STRING_STRING_POINTER,
160 gtk_object_class_add_signals (object_class, tips_query_signals, SIGNAL_LAST);
162 object_class->set_arg = gtk_tips_query_set_arg;
163 object_class->get_arg = gtk_tips_query_get_arg;
164 object_class->destroy = gtk_tips_query_destroy;
166 widget_class->event = gtk_tips_query_event;
168 class->start_query = gtk_tips_query_real_start_query;
169 class->stop_query = gtk_tips_query_real_stop_query;
170 class->widget_entered = gtk_tips_query_widget_entered;
171 class->widget_selected = NULL;
175 gtk_tips_query_init (GtkTipsQuery *tips_query)
177 tips_query->emit_always = FALSE;
178 tips_query->in_query = FALSE;
179 tips_query->label_inactive = g_strdup ("");
180 tips_query->label_no_tip = g_strdup (_("--- No Tip ---"));
181 tips_query->caller = NULL;
182 tips_query->last_crossed = NULL;
183 tips_query->query_cursor = NULL;
185 gtk_label_set_text (GTK_LABEL (tips_query), tips_query->label_inactive);
189 gtk_tips_query_set_arg (GtkObject *object,
193 GtkTipsQuery *tips_query;
195 tips_query = GTK_TIPS_QUERY (object);
199 case ARG_EMIT_ALWAYS:
200 tips_query->emit_always = (GTK_VALUE_BOOL (*arg) != FALSE);
203 gtk_tips_query_set_caller (tips_query, GTK_WIDGET (GTK_VALUE_OBJECT (*arg)));
205 case ARG_LABEL_INACTIVE:
206 gtk_tips_query_set_labels (tips_query, GTK_VALUE_STRING (*arg), tips_query->label_no_tip);
208 case ARG_LABEL_NO_TIP:
209 gtk_tips_query_set_labels (tips_query, tips_query->label_inactive, GTK_VALUE_STRING (*arg));
217 gtk_tips_query_get_arg (GtkObject *object,
221 GtkTipsQuery *tips_query;
223 tips_query = GTK_TIPS_QUERY (object);
227 case ARG_EMIT_ALWAYS:
228 GTK_VALUE_BOOL (*arg) = tips_query->emit_always;
231 GTK_VALUE_OBJECT (*arg) = (GtkObject*) tips_query->caller;
233 case ARG_LABEL_INACTIVE:
234 GTK_VALUE_STRING (*arg) = g_strdup (tips_query->label_inactive);
236 case ARG_LABEL_NO_TIP:
237 GTK_VALUE_STRING (*arg) = g_strdup (tips_query->label_no_tip);
240 arg->type = GTK_TYPE_INVALID;
246 gtk_tips_query_destroy (GtkObject *object)
248 GtkTipsQuery *tips_query;
250 g_return_if_fail (object != NULL);
251 g_return_if_fail (GTK_IS_TIPS_QUERY (object));
253 tips_query = GTK_TIPS_QUERY (object);
255 if (tips_query->in_query)
256 gtk_tips_query_stop_query (tips_query);
258 gtk_tips_query_set_caller (tips_query, NULL);
260 if (GTK_OBJECT_CLASS (parent_class)->destroy)
261 (* GTK_OBJECT_CLASS (parent_class)->destroy) (object);
265 gtk_tips_query_new (void)
267 GtkTipsQuery *tips_query;
269 tips_query = gtk_type_new (gtk_tips_query_get_type ());
271 return GTK_WIDGET (tips_query);
275 gtk_tips_query_set_labels (GtkTipsQuery *tips_query,
276 const gchar *label_inactive,
277 const gchar *label_no_tip)
281 g_return_if_fail (tips_query != NULL);
282 g_return_if_fail (GTK_IS_TIPS_QUERY (tips_query));
283 g_return_if_fail (label_inactive != NULL);
284 g_return_if_fail (label_no_tip != NULL);
286 old = tips_query->label_inactive;
287 tips_query->label_inactive = g_strdup (label_inactive);
289 old = tips_query->label_no_tip;
290 tips_query->label_no_tip = g_strdup (label_no_tip);
295 gtk_tips_query_set_caller (GtkTipsQuery *tips_query,
298 g_return_if_fail (tips_query != NULL);
299 g_return_if_fail (GTK_IS_TIPS_QUERY (tips_query));
300 g_return_if_fail (tips_query->in_query == FALSE);
302 g_return_if_fail (GTK_IS_WIDGET (caller));
305 gtk_widget_ref (caller);
307 if (tips_query->caller)
308 gtk_widget_unref (tips_query->caller);
310 tips_query->caller = caller;
314 gtk_tips_query_start_query (GtkTipsQuery *tips_query)
316 g_return_if_fail (tips_query != NULL);
317 g_return_if_fail (GTK_IS_TIPS_QUERY (tips_query));
318 g_return_if_fail (tips_query->in_query == FALSE);
319 g_return_if_fail (GTK_WIDGET_REALIZED (tips_query));
321 tips_query->in_query = TRUE;
322 gtk_signal_emit (GTK_OBJECT (tips_query), tips_query_signals[SIGNAL_START_QUERY]);
326 gtk_tips_query_stop_query (GtkTipsQuery *tips_query)
328 g_return_if_fail (tips_query != NULL);
329 g_return_if_fail (GTK_IS_TIPS_QUERY (tips_query));
330 g_return_if_fail (tips_query->in_query == TRUE);
332 gtk_signal_emit (GTK_OBJECT (tips_query), tips_query_signals[SIGNAL_STOP_QUERY]);
333 tips_query->in_query = FALSE;
337 gtk_tips_query_real_start_query (GtkTipsQuery *tips_query)
341 g_return_if_fail (tips_query != NULL);
342 g_return_if_fail (GTK_IS_TIPS_QUERY (tips_query));
344 tips_query->query_cursor = gdk_cursor_new (GDK_QUESTION_ARROW);
345 failure = gdk_pointer_grab (GTK_WIDGET (tips_query)->window,
347 GDK_BUTTON_PRESS_MASK | GDK_BUTTON_RELEASE_MASK |
348 GDK_ENTER_NOTIFY_MASK | GDK_LEAVE_NOTIFY_MASK,
350 tips_query->query_cursor,
354 gdk_cursor_destroy (tips_query->query_cursor);
355 tips_query->query_cursor = NULL;
357 gtk_grab_add (GTK_WIDGET (tips_query));
361 gtk_tips_query_real_stop_query (GtkTipsQuery *tips_query)
363 g_return_if_fail (tips_query != NULL);
364 g_return_if_fail (GTK_IS_TIPS_QUERY (tips_query));
366 gtk_grab_remove (GTK_WIDGET (tips_query));
367 if (tips_query->query_cursor)
369 gdk_pointer_ungrab (GDK_CURRENT_TIME);
370 gdk_cursor_destroy (tips_query->query_cursor);
371 tips_query->query_cursor = NULL;
373 if (tips_query->last_crossed)
375 gtk_widget_unref (tips_query->last_crossed);
376 tips_query->last_crossed = NULL;
379 gtk_label_set_text (GTK_LABEL (tips_query), tips_query->label_inactive);
383 gtk_tips_query_widget_entered (GtkTipsQuery *tips_query,
385 const gchar *tip_text,
386 const gchar *tip_private)
388 g_return_if_fail (tips_query != NULL);
389 g_return_if_fail (GTK_IS_TIPS_QUERY (tips_query));
392 tip_text = tips_query->label_no_tip;
394 if (!g_str_equal (GTK_LABEL (tips_query)->label, (gchar*) tip_text))
395 gtk_label_set_text (GTK_LABEL (tips_query), tip_text);
399 gtk_tips_query_emit_widget_entered (GtkTipsQuery *tips_query,
402 GtkTooltipsData *tdata;
404 if (widget == (GtkWidget*) tips_query)
408 tdata = gtk_tooltips_data_get (widget);
412 if (!widget && tips_query->last_crossed)
414 gtk_signal_emit (GTK_OBJECT (tips_query),
415 tips_query_signals[SIGNAL_WIDGET_ENTERED],
419 gtk_widget_unref (tips_query->last_crossed);
420 tips_query->last_crossed = NULL;
422 else if (widget && widget != tips_query->last_crossed)
424 gtk_widget_ref (widget);
425 if (tdata || tips_query->emit_always)
426 gtk_signal_emit (GTK_OBJECT (tips_query),
427 tips_query_signals[SIGNAL_WIDGET_ENTERED],
429 tdata ? tdata->tip_text : NULL,
430 tdata ? tdata->tip_private : NULL);
431 if (tips_query->last_crossed)
432 gtk_widget_unref (tips_query->last_crossed);
433 tips_query->last_crossed = widget;
438 gtk_tips_query_event (GtkWidget *widget,
441 GtkTipsQuery *tips_query;
442 GtkWidget *event_widget;
443 gboolean event_handled;
445 g_return_val_if_fail (widget != NULL, FALSE);
446 g_return_val_if_fail (GTK_IS_TIPS_QUERY (widget), FALSE);
448 tips_query = GTK_TIPS_QUERY (widget);
449 if (!tips_query->in_query)
451 if (GTK_WIDGET_CLASS (parent_class)->event)
452 return GTK_WIDGET_CLASS (parent_class)->event (widget, event);
457 event_widget = gtk_get_event_widget (event);
459 event_handled = FALSE;
462 GdkWindow *pointer_window;
464 case GDK_LEAVE_NOTIFY:
466 pointer_window = gdk_window_get_pointer (event_widget->window, NULL, NULL, NULL);
468 pointer_window = NULL;
471 gdk_window_get_user_data (pointer_window, (gpointer*) &event_widget);
472 gtk_tips_query_emit_widget_entered (tips_query, event_widget);
473 event_handled = TRUE;
476 case GDK_ENTER_NOTIFY:
477 gtk_tips_query_emit_widget_entered (tips_query, event_widget);
478 event_handled = TRUE;
481 case GDK_BUTTON_PRESS:
482 case GDK_BUTTON_RELEASE:
485 if (event_widget == (GtkWidget*) tips_query ||
486 event_widget == tips_query->caller)
487 gtk_tips_query_stop_query (tips_query);
491 GtkTooltipsData *tdata;
494 tdata = gtk_tooltips_data_get (event_widget);
495 if (tdata || tips_query->emit_always)
496 gtk_signal_emit (GTK_OBJECT (tips_query),
497 tips_query_signals[SIGNAL_WIDGET_SELECTED],
499 tdata ? tdata->tip_text : NULL,
500 tdata ? tdata->tip_private : NULL,
505 gtk_tips_query_stop_query (tips_query);
508 event_handled = TRUE;
515 return event_handled;