1 /* GTK - The GIMP Toolkit
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the Free
16 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 #include "gtkcontainer.h"
23 #include "gtkselection.h"
24 #include "gtksignal.h"
25 #include "gtkwidget.h"
26 #include "gtkwindow.h"
27 #include "gtkprivate.h"
32 #define WIDGET_CLASS(w) GTK_WIDGET_CLASS (GTK_OBJECT (w)->klass)
68 PROPERTY_NOTIFY_EVENT,
69 SELECTION_CLEAR_EVENT,
70 SELECTION_REQUEST_EVENT,
71 SELECTION_NOTIFY_EVENT,
80 DROP_DATA_AVAILABLE_EVENT,
107 typedef void (*GtkWidgetSignal1) (GtkObject *object,
110 typedef gint (*GtkWidgetSignal2) (GtkObject *object,
115 typedef void (*GtkWidgetSignal3) (GtkObject *object,
118 typedef gint (*GtkWidgetSignal4) (GtkObject *object,
121 typedef void (*GtkWidgetSignal5) (GtkObject *object,
124 typedef void (*GtkWidgetSignal6) (GtkObject *object,
127 typedef void (*GtkWidgetSignal7) (GtkObject *object,
131 typedef struct _GtkStateData GtkStateData;
136 gint parent_sensitive;
140 static void gtk_widget_marshal_signal_1 (GtkObject *object,
144 static void gtk_widget_marshal_signal_2 (GtkObject *object,
148 static void gtk_widget_marshal_signal_3 (GtkObject *object,
152 static void gtk_widget_marshal_signal_4 (GtkObject *object,
156 static void gtk_widget_marshal_signal_5 (GtkObject *object,
160 static void gtk_widget_marshal_signal_6 (GtkObject *object,
164 static void gtk_widget_marshal_signal_7 (GtkObject *object,
169 static void gtk_widget_class_init (GtkWidgetClass *klass);
170 static void gtk_widget_init (GtkWidget *widget);
171 static void gtk_widget_set_arg (GtkWidget *widget,
174 static void gtk_widget_get_arg (GtkWidget *widget,
177 static void gtk_widget_shutdown (GtkObject *object);
178 static void gtk_widget_real_destroy (GtkObject *object);
179 static void gtk_widget_finalize (GtkObject *object);
180 static void gtk_widget_real_show (GtkWidget *widget);
181 static void gtk_widget_real_hide (GtkWidget *widget);
182 static void gtk_widget_real_map (GtkWidget *widget);
183 static void gtk_widget_real_unmap (GtkWidget *widget);
184 static void gtk_widget_real_realize (GtkWidget *widget);
185 static void gtk_widget_real_unrealize (GtkWidget *widget);
186 static void gtk_widget_real_draw (GtkWidget *widget,
188 static gint gtk_widget_real_queue_draw (GtkWidget *widget);
189 static void gtk_widget_real_size_allocate (GtkWidget *widget,
190 GtkAllocation *allocation);
191 static void gtk_widget_style_set (GtkWidget *widget,
192 GtkStyle *previous_style);
194 static GdkColormap* gtk_widget_peek_colormap (void);
195 static GdkVisual* gtk_widget_peek_visual (void);
196 static GtkStyle* gtk_widget_peek_style (void);
198 static void gtk_widget_reparent_container_child (GtkWidget *widget,
199 gpointer client_data);
200 static void gtk_widget_propagate_state (GtkWidget *widget,
202 static void gtk_widget_draw_children_recurse (GtkWidget *widget,
203 gpointer client_data);
204 static void gtk_widget_set_style_internal (GtkWidget *widget,
206 gboolean initial_emission);
207 static void gtk_widget_set_style_recurse (GtkWidget *widget,
208 gpointer client_data);
210 extern GtkArg* gtk_object_collect_args (guint *nargs,
214 static GtkWidgetAuxInfo* gtk_widget_aux_info_new (void);
215 static void gtk_widget_aux_info_destroy (GtkWidgetAuxInfo *aux_info);
217 static GtkObjectClass *parent_class = NULL;
218 static guint widget_signals[LAST_SIGNAL] = { 0 };
220 static GMemChunk *aux_info_mem_chunk = NULL;
222 static GdkColormap *default_colormap = NULL;
223 static GdkVisual *default_visual = NULL;
224 static GtkStyle *default_style = NULL;
226 static GSList *colormap_stack = NULL;
227 static GSList *visual_stack = NULL;
228 static GSList *style_stack = NULL;
230 static GSList *gtk_widget_redraw_queue = NULL;
231 static GSList *gtk_widget_resize_queue = NULL;
233 static const gchar *aux_info_key = "gtk-aux-info";
234 static guint aux_info_key_id = 0;
235 static const gchar *event_key = "gtk-event-mask";
236 static guint event_key_id = 0;
237 static const gchar *extension_event_key = "gtk-extension-event-mode";
238 static guint extension_event_key_id = 0;
239 static const gchar *parent_window_key = "gtk-parent-window";
240 static guint parent_window_key_id = 0;
241 static const gchar *saved_default_style_key = "gtk-saved-default-style";
242 static guint saved_default_style_key_id = 0;
243 static const gchar *shape_info_key = "gtk-shape-info";
244 static const gchar *colormap_key = "gtk-colormap";
245 static const gchar *visual_key = "gtk-visual";
249 /*****************************************
250 * gtk_widget_get_type:
255 *****************************************/
258 gtk_widget_get_type ()
260 static guint widget_type = 0;
264 GtkTypeInfo widget_info =
268 sizeof (GtkWidgetClass),
269 (GtkClassInitFunc) gtk_widget_class_init,
270 (GtkObjectInitFunc) gtk_widget_init,
271 (GtkArgSetFunc) gtk_widget_set_arg,
272 (GtkArgGetFunc) gtk_widget_get_arg,
275 widget_type = gtk_type_unique (gtk_object_get_type (), &widget_info);
281 /*****************************************
282 * gtk_widget_class_init:
287 *****************************************/
290 gtk_widget_class_init (GtkWidgetClass *klass)
292 GtkObjectClass *object_class;
294 object_class = (GtkObjectClass*) klass;
296 parent_class = gtk_type_class (gtk_object_get_type ());
298 gtk_object_add_arg_type ("GtkWidget::name", GTK_TYPE_STRING, GTK_ARG_READWRITE, ARG_NAME);
299 gtk_object_add_arg_type ("GtkWidget::parent", GTK_TYPE_CONTAINER, GTK_ARG_READWRITE, ARG_PARENT);
300 gtk_object_add_arg_type ("GtkWidget::x", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_X);
301 gtk_object_add_arg_type ("GtkWidget::y", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_Y);
302 gtk_object_add_arg_type ("GtkWidget::width", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_WIDTH);
303 gtk_object_add_arg_type ("GtkWidget::height", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_HEIGHT);
304 gtk_object_add_arg_type ("GtkWidget::visible", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_VISIBLE);
305 gtk_object_add_arg_type ("GtkWidget::sensitive", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_SENSITIVE);
306 gtk_object_add_arg_type ("GtkWidget::can_focus", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_CAN_FOCUS);
307 gtk_object_add_arg_type ("GtkWidget::has_focus", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_HAS_FOCUS);
308 gtk_object_add_arg_type ("GtkWidget::can_default", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_CAN_DEFAULT);
309 gtk_object_add_arg_type ("GtkWidget::has_default", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_HAS_DEFAULT);
310 gtk_object_add_arg_type ("GtkWidget::style", GTK_TYPE_STYLE, GTK_ARG_READWRITE, ARG_STYLE);
311 gtk_object_add_arg_type ("GtkWidget::events", GTK_TYPE_GDK_EVENT_MASK, GTK_ARG_READWRITE, ARG_EVENTS);
312 gtk_object_add_arg_type ("GtkWidget::extension_events", GTK_TYPE_GDK_EVENT_MASK, GTK_ARG_READWRITE, ARG_EXTENSION_EVENTS);
314 widget_signals[SHOW] =
315 gtk_signal_new ("show",
318 GTK_SIGNAL_OFFSET (GtkWidgetClass, show),
319 gtk_signal_default_marshaller,
321 widget_signals[HIDE] =
322 gtk_signal_new ("hide",
325 GTK_SIGNAL_OFFSET (GtkWidgetClass, hide),
326 gtk_signal_default_marshaller,
328 widget_signals[MAP] =
329 gtk_signal_new ("map",
332 GTK_SIGNAL_OFFSET (GtkWidgetClass, map),
333 gtk_signal_default_marshaller,
335 widget_signals[UNMAP] =
336 gtk_signal_new ("unmap",
339 GTK_SIGNAL_OFFSET (GtkWidgetClass, unmap),
340 gtk_signal_default_marshaller,
342 widget_signals[REALIZE] =
343 gtk_signal_new ("realize",
346 GTK_SIGNAL_OFFSET (GtkWidgetClass, realize),
347 gtk_signal_default_marshaller,
349 widget_signals[UNREALIZE] =
350 gtk_signal_new ("unrealize",
353 GTK_SIGNAL_OFFSET (GtkWidgetClass, unrealize),
354 gtk_signal_default_marshaller,
356 widget_signals[DRAW] =
357 gtk_signal_new ("draw",
360 GTK_SIGNAL_OFFSET (GtkWidgetClass, draw),
361 gtk_widget_marshal_signal_1,
364 widget_signals[DRAW_FOCUS] =
365 gtk_signal_new ("draw_focus",
368 GTK_SIGNAL_OFFSET (GtkWidgetClass, draw_focus),
369 gtk_signal_default_marshaller,
371 widget_signals[DRAW_DEFAULT] =
372 gtk_signal_new ("draw_default",
375 GTK_SIGNAL_OFFSET (GtkWidgetClass, draw_default),
376 gtk_signal_default_marshaller,
378 widget_signals[SIZE_REQUEST] =
379 gtk_signal_new ("size_request",
382 GTK_SIGNAL_OFFSET (GtkWidgetClass, size_request),
383 gtk_widget_marshal_signal_1,
386 widget_signals[SIZE_ALLOCATE] =
387 gtk_signal_new ("size_allocate",
390 GTK_SIGNAL_OFFSET (GtkWidgetClass, size_allocate),
391 gtk_widget_marshal_signal_1,
394 widget_signals[STATE_CHANGED] =
395 gtk_signal_new ("state_changed",
398 GTK_SIGNAL_OFFSET (GtkWidgetClass, state_changed),
399 gtk_widget_marshal_signal_5,
402 widget_signals[PARENT_SET] =
403 gtk_signal_new ("parent_set",
406 GTK_SIGNAL_OFFSET (GtkWidgetClass, parent_set),
407 gtk_widget_marshal_signal_6,
410 widget_signals[STYLE_SET] =
411 gtk_signal_new ("style_set",
414 GTK_SIGNAL_OFFSET (GtkWidgetClass, style_set),
415 gtk_widget_marshal_signal_7,
418 widget_signals[INSTALL_ACCELERATOR] =
419 gtk_signal_new ("install_accelerator",
422 GTK_SIGNAL_OFFSET (GtkWidgetClass, install_accelerator),
423 gtk_widget_marshal_signal_2,
428 widget_signals[REMOVE_ACCELERATOR] =
429 gtk_signal_new ("remove_accelerator",
432 GTK_SIGNAL_OFFSET (GtkWidgetClass, remove_accelerator),
433 gtk_widget_marshal_signal_3,
436 widget_signals[EVENT] =
437 gtk_signal_new ("event",
440 GTK_SIGNAL_OFFSET (GtkWidgetClass, event),
441 gtk_widget_marshal_signal_4,
444 widget_signals[BUTTON_PRESS_EVENT] =
445 gtk_signal_new ("button_press_event",
448 GTK_SIGNAL_OFFSET (GtkWidgetClass, button_press_event),
449 gtk_widget_marshal_signal_4,
452 widget_signals[BUTTON_RELEASE_EVENT] =
453 gtk_signal_new ("button_release_event",
456 GTK_SIGNAL_OFFSET (GtkWidgetClass, button_release_event),
457 gtk_widget_marshal_signal_4,
460 widget_signals[MOTION_NOTIFY_EVENT] =
461 gtk_signal_new ("motion_notify_event",
464 GTK_SIGNAL_OFFSET (GtkWidgetClass, motion_notify_event),
465 gtk_widget_marshal_signal_4,
468 widget_signals[DELETE_EVENT] =
469 gtk_signal_new ("delete_event",
472 GTK_SIGNAL_OFFSET (GtkWidgetClass, delete_event),
473 gtk_widget_marshal_signal_4,
476 widget_signals[DESTROY_EVENT] =
477 gtk_signal_new ("destroy_event",
480 GTK_SIGNAL_OFFSET (GtkWidgetClass, destroy_event),
481 gtk_widget_marshal_signal_4,
484 widget_signals[EXPOSE_EVENT] =
485 gtk_signal_new ("expose_event",
488 GTK_SIGNAL_OFFSET (GtkWidgetClass, expose_event),
489 gtk_widget_marshal_signal_4,
492 widget_signals[KEY_PRESS_EVENT] =
493 gtk_signal_new ("key_press_event",
496 GTK_SIGNAL_OFFSET (GtkWidgetClass, key_press_event),
497 gtk_widget_marshal_signal_4,
500 widget_signals[KEY_RELEASE_EVENT] =
501 gtk_signal_new ("key_release_event",
504 GTK_SIGNAL_OFFSET (GtkWidgetClass, key_release_event),
505 gtk_widget_marshal_signal_4,
508 widget_signals[ENTER_NOTIFY_EVENT] =
509 gtk_signal_new ("enter_notify_event",
512 GTK_SIGNAL_OFFSET (GtkWidgetClass, enter_notify_event),
513 gtk_widget_marshal_signal_4,
516 widget_signals[LEAVE_NOTIFY_EVENT] =
517 gtk_signal_new ("leave_notify_event",
520 GTK_SIGNAL_OFFSET (GtkWidgetClass, leave_notify_event),
521 gtk_widget_marshal_signal_4,
524 widget_signals[CONFIGURE_EVENT] =
525 gtk_signal_new ("configure_event",
528 GTK_SIGNAL_OFFSET (GtkWidgetClass, configure_event),
529 gtk_widget_marshal_signal_4,
532 widget_signals[FOCUS_IN_EVENT] =
533 gtk_signal_new ("focus_in_event",
536 GTK_SIGNAL_OFFSET (GtkWidgetClass, focus_in_event),
537 gtk_widget_marshal_signal_4,
540 widget_signals[FOCUS_OUT_EVENT] =
541 gtk_signal_new ("focus_out_event",
544 GTK_SIGNAL_OFFSET (GtkWidgetClass, focus_out_event),
545 gtk_widget_marshal_signal_4,
548 widget_signals[MAP_EVENT] =
549 gtk_signal_new ("map_event",
552 GTK_SIGNAL_OFFSET (GtkWidgetClass, map_event),
553 gtk_widget_marshal_signal_4,
556 widget_signals[UNMAP_EVENT] =
557 gtk_signal_new ("unmap_event",
560 GTK_SIGNAL_OFFSET (GtkWidgetClass, unmap_event),
561 gtk_widget_marshal_signal_4,
564 widget_signals[PROPERTY_NOTIFY_EVENT] =
565 gtk_signal_new ("property_notify_event",
568 GTK_SIGNAL_OFFSET (GtkWidgetClass, property_notify_event),
569 gtk_widget_marshal_signal_4,
572 widget_signals[SELECTION_CLEAR_EVENT] =
573 gtk_signal_new ("selection_clear_event",
576 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_clear_event),
577 gtk_widget_marshal_signal_4,
580 widget_signals[SELECTION_REQUEST_EVENT] =
581 gtk_signal_new ("selection_request_event",
584 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_request_event),
585 gtk_widget_marshal_signal_4,
588 widget_signals[SELECTION_NOTIFY_EVENT] =
589 gtk_signal_new ("selection_notify_event",
592 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_notify_event),
593 gtk_widget_marshal_signal_4,
596 widget_signals[SELECTION_RECEIVED] =
597 gtk_signal_new ("selection_received",
600 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_received),
601 gtk_widget_marshal_signal_1,
604 widget_signals[PROXIMITY_IN_EVENT] =
605 gtk_signal_new ("proximity_in_event",
608 GTK_SIGNAL_OFFSET (GtkWidgetClass, proximity_in_event),
609 gtk_widget_marshal_signal_4,
612 widget_signals[PROXIMITY_OUT_EVENT] =
613 gtk_signal_new ("proximity_out_event",
616 GTK_SIGNAL_OFFSET (GtkWidgetClass, proximity_out_event),
617 gtk_widget_marshal_signal_4,
620 widget_signals[DRAG_BEGIN_EVENT] =
621 gtk_signal_new ("drag_begin_event",
624 GTK_SIGNAL_OFFSET (GtkWidgetClass, drag_begin_event),
625 gtk_widget_marshal_signal_4,
628 widget_signals[DRAG_REQUEST_EVENT] =
629 gtk_signal_new ("drag_request_event",
632 GTK_SIGNAL_OFFSET (GtkWidgetClass, drag_request_event),
633 gtk_widget_marshal_signal_4,
636 widget_signals[DRAG_END_EVENT] =
637 gtk_signal_new ("drag_end_event",
640 GTK_SIGNAL_OFFSET (GtkWidgetClass, drag_end_event),
641 gtk_widget_marshal_signal_4,
644 widget_signals[DROP_ENTER_EVENT] =
645 gtk_signal_new ("drop_enter_event",
648 GTK_SIGNAL_OFFSET (GtkWidgetClass, drop_enter_event),
649 gtk_widget_marshal_signal_4,
652 widget_signals[DROP_LEAVE_EVENT] =
653 gtk_signal_new ("drop_leave_event",
656 GTK_SIGNAL_OFFSET (GtkWidgetClass, drop_leave_event),
657 gtk_widget_marshal_signal_4,
660 widget_signals[DROP_DATA_AVAILABLE_EVENT] =
661 gtk_signal_new ("drop_data_available_event",
664 GTK_SIGNAL_OFFSET (GtkWidgetClass,
665 drop_data_available_event),
666 gtk_widget_marshal_signal_4,
669 widget_signals[OTHER_EVENT] =
670 gtk_signal_new ("other_event",
673 GTK_SIGNAL_OFFSET (GtkWidgetClass, other_event),
674 gtk_widget_marshal_signal_4,
677 widget_signals[CLIENT_EVENT] =
678 gtk_signal_new ("client_event",
681 GTK_SIGNAL_OFFSET (GtkWidgetClass, client_event),
682 gtk_widget_marshal_signal_4,
685 widget_signals[NO_EXPOSE_EVENT] =
686 gtk_signal_new ("no_expose_event",
689 GTK_SIGNAL_OFFSET (GtkWidgetClass, no_expose_event),
690 gtk_widget_marshal_signal_4,
694 gtk_object_class_add_signals (object_class, widget_signals, LAST_SIGNAL);
696 object_class->shutdown = gtk_widget_shutdown;
697 object_class->destroy = gtk_widget_real_destroy;
698 object_class->finalize = gtk_widget_finalize;
700 klass->activate_signal = 0;
701 klass->show = gtk_widget_real_show;
702 klass->hide = gtk_widget_real_hide;
703 klass->show_all = gtk_widget_real_show;
704 klass->hide_all = gtk_widget_real_hide;
705 klass->map = gtk_widget_real_map;
706 klass->unmap = gtk_widget_real_unmap;
707 klass->realize = gtk_widget_real_realize;
708 klass->unrealize = gtk_widget_real_unrealize;
709 klass->draw = gtk_widget_real_draw;
710 klass->draw_focus = NULL;
711 klass->size_request = NULL;
712 klass->size_allocate = gtk_widget_real_size_allocate;
713 klass->state_changed = NULL;
714 klass->parent_set = NULL;
715 klass->style_set = gtk_widget_style_set;
716 klass->install_accelerator = NULL;
717 klass->remove_accelerator = NULL;
719 klass->button_press_event = NULL;
720 klass->button_release_event = NULL;
721 klass->motion_notify_event = NULL;
722 klass->delete_event = NULL;
723 klass->destroy_event = NULL;
724 klass->expose_event = NULL;
725 klass->key_press_event = NULL;
726 klass->key_release_event = NULL;
727 klass->enter_notify_event = NULL;
728 klass->leave_notify_event = NULL;
729 klass->configure_event = NULL;
730 klass->focus_in_event = NULL;
731 klass->focus_out_event = NULL;
732 klass->map_event = NULL;
733 klass->unmap_event = NULL;
734 klass->property_notify_event = gtk_selection_property_notify;
735 klass->selection_clear_event = gtk_selection_clear;
736 klass->selection_request_event = gtk_selection_request;
737 klass->selection_notify_event = gtk_selection_notify;
738 klass->selection_received = NULL;
739 klass->proximity_in_event = NULL;
740 klass->proximity_out_event = NULL;
741 klass->drag_begin_event = NULL;
742 klass->drag_request_event = NULL;
743 klass->drop_enter_event = NULL;
744 klass->drop_leave_event = NULL;
745 klass->drop_data_available_event = NULL;
746 klass->other_event = NULL;
747 klass->no_expose_event = NULL;
750 /*****************************************
751 * gtk_widget_set_arg:
756 *****************************************/
759 gtk_widget_set_arg (GtkWidget *widget,
766 gtk_widget_set_name (widget, GTK_VALUE_STRING (*arg));
769 gtk_container_add (GTK_CONTAINER (GTK_VALUE_OBJECT (*arg)), widget);
772 gtk_widget_set_uposition (widget, GTK_VALUE_INT (*arg), -2);
775 gtk_widget_set_uposition (widget, -2, GTK_VALUE_INT (*arg));
778 gtk_widget_set_usize (widget, GTK_VALUE_INT (*arg), -1);
781 gtk_widget_set_usize (widget, -1, GTK_VALUE_INT (*arg));
784 if (GTK_VALUE_BOOL(*arg))
785 gtk_widget_show (widget);
787 gtk_widget_hide (widget);
790 gtk_widget_set_sensitive (widget, GTK_VALUE_BOOL (*arg));
793 if (GTK_VALUE_BOOL (*arg))
794 GTK_WIDGET_SET_FLAGS (widget, GTK_CAN_FOCUS);
796 GTK_WIDGET_UNSET_FLAGS (widget, GTK_CAN_FOCUS);
799 if (GTK_VALUE_BOOL (*arg))
800 gtk_widget_grab_focus (widget);
802 case ARG_CAN_DEFAULT:
803 if (GTK_VALUE_BOOL (*arg))
804 GTK_WIDGET_SET_FLAGS (widget, GTK_CAN_DEFAULT);
806 GTK_WIDGET_UNSET_FLAGS (widget, GTK_CAN_DEFAULT);
808 case ARG_HAS_DEFAULT:
809 if (GTK_VALUE_BOOL (*arg))
810 gtk_widget_grab_default (widget);
813 gtk_widget_set_style (widget, (GtkStyle*) GTK_VALUE_BOXED (*arg));
816 gtk_widget_set_events (widget, GTK_VALUE_FLAGS (*arg));
818 case ARG_EXTENSION_EVENTS:
819 gtk_widget_set_extension_events (widget, GTK_VALUE_FLAGS (*arg));
822 arg->type = GTK_TYPE_INVALID;
827 /*****************************************
828 * gtk_widget_get_arg:
833 *****************************************/
836 gtk_widget_get_arg (GtkWidget *widget,
840 GtkWidgetAuxInfo *aux_info;
842 GdkExtensionMode *modep;
848 GTK_VALUE_STRING (*arg) = g_strdup (widget->name);
850 GTK_VALUE_STRING (*arg) = g_strdup ("");
853 GTK_VALUE_OBJECT (*arg) = (GtkObject*) widget->parent;
856 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
858 GTK_VALUE_INT (*arg) = -2;
860 GTK_VALUE_INT (*arg) = aux_info->x;
863 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
865 GTK_VALUE_INT (*arg) = -2;
867 GTK_VALUE_INT (*arg) = aux_info->y;
870 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
872 GTK_VALUE_INT (*arg) = -2;
874 GTK_VALUE_INT (*arg) = aux_info->width;
877 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
879 GTK_VALUE_INT (*arg) = -2;
881 GTK_VALUE_INT (*arg) = aux_info->height;
884 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_VISIBLE (widget) != FALSE);
887 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_SENSITIVE (widget) != FALSE);
890 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_CAN_FOCUS (widget) != FALSE);
893 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_HAS_FOCUS (widget) != FALSE);
895 case ARG_CAN_DEFAULT:
896 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_CAN_DEFAULT (widget) != FALSE);
898 case ARG_HAS_DEFAULT:
899 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_HAS_DEFAULT (widget) != FALSE);
902 GTK_VALUE_BOXED (*arg) = (gpointer) gtk_widget_get_style (widget);
905 eventp = gtk_object_get_data_by_id (GTK_OBJECT (widget), event_key_id);
907 GTK_VALUE_FLAGS (*arg) = 0;
909 GTK_VALUE_FLAGS (*arg) = *eventp;
911 case ARG_EXTENSION_EVENTS:
912 modep = gtk_object_get_data_by_id (GTK_OBJECT (widget), extension_event_key_id);
914 GTK_VALUE_FLAGS (*arg) = 0;
916 GTK_VALUE_FLAGS (*arg) = *modep;
919 arg->type = GTK_TYPE_INVALID;
924 /*****************************************
930 *****************************************/
933 gtk_widget_init (GtkWidget *widget)
935 GdkColormap *colormap;
938 GTK_PRIVATE_FLAGS (widget) = 0;
939 widget->state = GTK_STATE_NORMAL;
940 widget->saved_state = GTK_STATE_NORMAL;
942 widget->requisition.width = 0;
943 widget->requisition.height = 0;
944 widget->allocation.x = -1;
945 widget->allocation.y = -1;
946 widget->allocation.width = 1;
947 widget->allocation.height = 1;
948 widget->window = NULL;
949 widget->parent = NULL;
951 GTK_WIDGET_SET_FLAGS (widget, GTK_SENSITIVE | GTK_PARENT_SENSITIVE);
953 widget->style = gtk_widget_peek_style ();
954 gtk_style_ref (widget->style);
956 colormap = gtk_widget_peek_colormap ();
957 visual = gtk_widget_peek_visual ();
959 /* XXX - should we ref the colormap and visual, too? */
961 if (colormap != gtk_widget_get_default_colormap ())
963 /* gdk_colormap_ref (colormap); */
964 gtk_object_set_data (GTK_OBJECT (widget), colormap_key, colormap);
967 if (visual != gtk_widget_get_default_visual ())
969 /* gdk_visual_ref (visual); */
970 gtk_object_set_data (GTK_OBJECT (widget), visual_key, visual);
974 /*****************************************
980 *****************************************/
983 gtk_widget_new (guint type,
992 g_return_val_if_fail (gtk_type_is_a (type, gtk_widget_get_type ()), NULL);
994 obj = gtk_type_new (type);
996 va_start (args1, type);
997 va_start (args2, type);
999 args = gtk_object_collect_args (&nargs, args1, args2);
1000 gtk_object_setv (obj, nargs, args);
1006 return GTK_WIDGET (obj);
1009 /*****************************************
1015 *****************************************/
1018 gtk_widget_newv (guint type,
1022 g_return_val_if_fail (gtk_type_is_a (type, gtk_widget_get_type ()), NULL);
1024 return GTK_WIDGET (gtk_object_newv (type, nargs, args));
1027 /*****************************************
1033 *****************************************/
1036 gtk_widget_get (GtkWidget *widget,
1039 g_return_if_fail (widget != NULL);
1040 g_return_if_fail (arg != NULL);
1042 gtk_object_getv (GTK_OBJECT (widget), 1, arg);
1045 /*****************************************
1051 *****************************************/
1054 gtk_widget_getv (GtkWidget *widget,
1058 gtk_object_getv (GTK_OBJECT (widget), nargs, args);
1061 /*****************************************
1067 *****************************************/
1070 gtk_widget_set (GtkWidget *widget,
1078 g_return_if_fail (widget != NULL);
1080 va_start (args1, widget);
1081 va_start (args2, widget);
1083 args = gtk_object_collect_args (&nargs, args1, args2);
1084 gtk_object_setv (GTK_OBJECT (widget), nargs, args);
1091 /*****************************************
1097 *****************************************/
1100 gtk_widget_setv (GtkWidget *widget,
1104 gtk_object_setv (GTK_OBJECT (widget), nargs, args);
1107 /*****************************************
1108 * gtk_widget_unparent:
1109 * do any cleanup necessary necessary
1110 * for setting parent = NULL.
1115 *****************************************/
1118 gtk_widget_unparent (GtkWidget *widget)
1120 GtkWidget *toplevel;
1122 GtkWidget *old_parent;
1124 g_return_if_fail (widget != NULL);
1125 if (widget->parent == NULL)
1128 /* keep this function in sync with gtk_menu_detach()
1131 toplevel = gtk_widget_get_toplevel (widget);
1132 if (GTK_IS_WINDOW (toplevel))
1134 child = GTK_WINDOW (toplevel)->focus_widget;
1136 while (child && child != widget)
1137 child = child->parent;
1139 if (child == widget)
1140 gtk_window_set_focus (GTK_WINDOW (toplevel), NULL);
1143 if (GTK_WIDGET_RESIZE_NEEDED (widget))
1145 GTK_CONTAINER (toplevel)->resize_widgets =
1146 g_slist_remove (GTK_CONTAINER (toplevel)->resize_widgets, widget);
1147 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_NEEDED);
1150 /* Reset the width and height here, to force reallocation if we
1151 * get added back to a new parent. This won't work if our new
1152 * allocation is smaller than 1x1 and we actually want a size of 1x1...
1153 * (would 0x0 be OK here?)
1155 widget->allocation.width = 1;
1156 widget->allocation.height = 1;
1158 if (widget->window &&
1159 GTK_WIDGET_NO_WINDOW (widget) &&
1160 GTK_WIDGET_DRAWABLE (widget))
1161 gdk_window_clear_area (widget->window,
1162 widget->allocation.x,
1163 widget->allocation.y,
1164 widget->allocation.width,
1165 widget->allocation.height);
1167 if (GTK_WIDGET_REALIZED (widget) && !GTK_WIDGET_IN_REPARENT (widget))
1168 gtk_widget_unrealize (widget);
1170 old_parent = widget->parent;
1171 widget->parent = NULL;
1172 gtk_widget_set_parent_window (widget, NULL);
1173 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[PARENT_SET], old_parent);
1175 gtk_widget_unref (widget);
1178 /*****************************************
1179 * gtk_widget_destroy:
1184 *****************************************/
1187 gtk_widget_destroy (GtkWidget *widget)
1189 g_return_if_fail (widget != NULL);
1190 g_return_if_fail (GTK_IS_WIDGET (widget));
1192 gtk_object_destroy (GTK_OBJECT (widget));
1195 /*****************************************
1196 * gtk_widget_destroyed:
1197 * Utility function: sets widget_pointer
1198 * to NULL when widget is destroyed.
1203 *****************************************/
1206 gtk_widget_destroyed (GtkWidget *widget,
1207 GtkWidget **widget_pointer)
1209 /* Don't make any assumptions about the
1211 * Even check widget_pointer.
1214 *widget_pointer = NULL;
1217 /*****************************************
1223 *****************************************/
1226 gtk_widget_show (GtkWidget *widget)
1228 g_return_if_fail (widget != NULL);
1230 if (!GTK_WIDGET_VISIBLE (widget))
1231 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[SHOW]);
1234 /*****************************************
1240 *****************************************/
1243 gtk_widget_hide (GtkWidget *widget)
1245 g_return_if_fail (widget != NULL);
1246 g_return_if_fail (GTK_IS_WIDGET (widget));
1248 if (GTK_WIDGET_VISIBLE (widget))
1249 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[HIDE]);
1253 gtk_widget_hide_on_delete (GtkWidget *widget)
1255 g_return_val_if_fail (widget != NULL, FALSE);
1256 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
1258 gtk_widget_hide (widget);
1263 /*****************************************
1264 * gtk_widget_show_all:
1266 * Shows the widget and all children.
1268 * Container classes overwrite
1269 * show_all and hide_all to call
1270 * show_all (hide_all) on both themselves
1271 * and on their child widgets.
1276 *****************************************/
1279 gtk_widget_show_all (GtkWidget *widget)
1281 GtkWidgetClass *widget_class;
1283 g_return_if_fail (widget != NULL);
1285 /* show_all shouldn't be invoked through a signal,
1286 because in this case it would be quite slow - there would
1287 be a show and show_all signal emitted for every child widget.
1289 widget_class = GTK_WIDGET_CLASS(GTK_OBJECT(widget)->klass);
1290 widget_class->show_all (widget);
1293 /*****************************************
1294 * gtk_widget_hide_all:
1296 * Hides the widget and all children.
1297 * See gtk_widget_show_all.
1302 *****************************************/
1305 gtk_widget_hide_all (GtkWidget *widget)
1307 g_return_if_fail (widget != NULL);
1308 g_assert (widget->parent);
1310 if (GTK_WIDGET_RESIZE_NEEDED (widget))
1312 GtkWidget *toplevel;
1314 toplevel = gtk_widget_get_toplevel (widget);
1315 GTK_CONTAINER (toplevel)->resize_widgets =
1316 g_slist_remove (GTK_CONTAINER (toplevel)->resize_widgets, widget);
1317 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_NEEDED);
1320 GTK_WIDGET_CLASS (GTK_OBJECT (widget)->klass)->hide_all (widget);
1323 /*****************************************
1329 *****************************************/
1332 gtk_widget_map (GtkWidget *widget)
1334 g_return_if_fail (widget != NULL);
1336 if (!GTK_WIDGET_MAPPED (widget))
1338 if (!GTK_WIDGET_REALIZED (widget))
1339 gtk_widget_realize (widget);
1341 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[MAP]);
1345 /*****************************************
1351 *****************************************/
1354 gtk_widget_unmap (GtkWidget *widget)
1356 g_return_if_fail (widget != NULL);
1358 if (GTK_WIDGET_MAPPED (widget))
1359 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[UNMAP]);
1362 /*****************************************
1363 * gtk_widget_realize:
1368 *****************************************/
1371 gtk_widget_realize (GtkWidget *widget)
1374 GdkExtensionMode mode;
1375 GtkWidgetShapeInfo *shape_info;
1377 g_return_if_fail (widget != NULL);
1379 if (!GTK_WIDGET_REALIZED (widget))
1382 if (GTK_IS_CONTAINER (widget) && !GTK_WIDGET_NO_WINDOW (widget))
1383 g_print ("%s\n", gtk_type_name (GTK_WIDGET_TYPE (widget)));
1386 if (widget->parent && !GTK_WIDGET_REALIZED (widget->parent))
1387 gtk_widget_realize (widget->parent);
1389 gtk_widget_ensure_style (widget);
1391 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[REALIZE]);
1393 if (GTK_WIDGET_HAS_SHAPE_MASK (widget))
1395 shape_info = gtk_object_get_data (GTK_OBJECT (widget),
1397 gdk_window_shape_combine_mask (widget->window,
1398 shape_info->shape_mask,
1399 shape_info->offset_x,
1400 shape_info->offset_y);
1403 if (!GTK_WIDGET_NO_WINDOW (widget))
1405 mode = gtk_widget_get_extension_events (widget);
1406 if (mode != GDK_EXTENSION_EVENTS_NONE)
1408 events = gtk_widget_get_events (widget);
1409 gdk_input_set_extension_events (widget->window, events, mode);
1416 /*****************************************
1417 * gtk_widget_unrealize:
1422 *****************************************/
1425 gtk_widget_unrealize (GtkWidget *widget)
1427 g_return_if_fail (widget != NULL);
1429 if (GTK_WIDGET_REDRAW_PENDING (widget))
1431 gtk_widget_redraw_queue = g_slist_remove (gtk_widget_redraw_queue, widget);
1432 GTK_PRIVATE_UNSET_FLAG (widget, GTK_REDRAW_PENDING);
1435 if (GTK_WIDGET_HAS_SHAPE_MASK (widget))
1436 gtk_widget_shape_combine_mask (widget, NULL, -1, -1);
1438 if (GTK_WIDGET_REALIZED (widget))
1440 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[UNREALIZE]);
1441 GTK_WIDGET_UNSET_FLAGS (widget, GTK_REALIZED | GTK_MAPPED);
1445 /*****************************************
1446 * gtk_widget_queue_draw:
1451 *****************************************/
1454 gtk_widget_idle_draw (void *data)
1458 node = gtk_widget_redraw_queue;
1459 gtk_widget_redraw_queue = NULL;
1462 gtk_widget_real_queue_draw ((GtkWidget*) node->data);
1466 return gtk_widget_redraw_queue != NULL;
1470 gtk_widget_queue_draw (GtkWidget *widget)
1474 g_return_if_fail (widget != NULL);
1476 if (GTK_WIDGET_DRAWABLE (widget))
1478 /* We queue the redraw if:
1479 * a) the widget is not already queued for redraw and
1480 * b) non of the widgets ancestors are queued for redraw.
1485 if (GTK_WIDGET_REDRAW_PENDING (parent))
1487 parent = parent->parent;
1490 GTK_PRIVATE_SET_FLAG (widget, GTK_REDRAW_PENDING);
1491 if (gtk_widget_redraw_queue == NULL)
1492 gtk_idle_add_priority (GTK_PRIORITY_INTERNAL,
1493 (GtkFunction) gtk_widget_idle_draw, NULL);
1495 gtk_widget_redraw_queue = g_slist_prepend (gtk_widget_redraw_queue, widget);
1499 /*****************************************
1500 * gtk_widget_queue_resize:
1505 *****************************************/
1508 gtk_widget_idle_sizer (void *data)
1510 GSList *slist, *free_slist;
1512 free_slist = gtk_widget_resize_queue;
1513 gtk_widget_resize_queue = NULL;
1515 for (slist = free_slist; slist; slist = slist->next)
1519 widget = slist->data;
1521 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_PENDING);
1522 if (gtk_container_need_resize (GTK_CONTAINER (widget)))
1523 gtk_widget_queue_resize (widget);
1525 g_slist_free (free_slist);
1527 return gtk_widget_resize_queue != NULL;
1531 gtk_widget_queue_resize (GtkWidget *widget)
1533 GtkWidget *toplevel;
1535 g_return_if_fail (widget != NULL);
1537 toplevel = gtk_widget_get_toplevel (widget);
1538 if (GTK_WIDGET_TOPLEVEL (toplevel))
1540 if (GTK_WIDGET_VISIBLE (toplevel))
1542 if (!GTK_CONTAINER_RESIZE_PENDING (toplevel))
1544 GTK_PRIVATE_SET_FLAG (toplevel, GTK_RESIZE_PENDING);
1545 if (gtk_widget_resize_queue == NULL)
1546 gtk_idle_add_priority (GTK_PRIORITY_INTERNAL,
1547 (GtkFunction) gtk_widget_idle_sizer, NULL);
1548 gtk_widget_resize_queue = g_slist_prepend (gtk_widget_resize_queue, toplevel);
1551 if (!GTK_WIDGET_RESIZE_NEEDED (widget))
1553 GTK_PRIVATE_SET_FLAG (widget, GTK_RESIZE_NEEDED);
1554 GTK_CONTAINER (toplevel)->resize_widgets =
1555 g_slist_prepend (GTK_CONTAINER (toplevel)->resize_widgets, widget);
1558 g_assert (g_slist_find (GTK_CONTAINER (toplevel)->resize_widgets, widget)); /* paranoid */
1561 gtk_container_need_resize (GTK_CONTAINER (toplevel));
1565 /*****************************************
1571 *****************************************/
1574 gtk_widget_draw (GtkWidget *widget,
1577 GdkRectangle temp_area;
1579 g_return_if_fail (widget != NULL);
1581 if (GTK_WIDGET_REDRAW_PENDING (widget))
1583 gtk_widget_redraw_queue = g_slist_remove (gtk_widget_redraw_queue, widget);
1584 GTK_PRIVATE_UNSET_FLAG (widget, GTK_REDRAW_PENDING);
1587 if (GTK_WIDGET_DRAWABLE (widget))
1591 if (GTK_WIDGET_NO_WINDOW (widget))
1593 temp_area.x = widget->allocation.x;
1594 temp_area.y = widget->allocation.y;
1602 temp_area.width = widget->allocation.width;
1603 temp_area.height = widget->allocation.height;
1607 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[DRAW], area);
1611 /*****************************************
1612 * gtk_widget_draw_focus:
1617 *****************************************/
1620 gtk_widget_draw_focus (GtkWidget *widget)
1622 g_return_if_fail (widget != NULL);
1624 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[DRAW_FOCUS]);
1627 /*****************************************
1628 * gtk_widget_draw_default:
1633 *****************************************/
1636 gtk_widget_draw_default (GtkWidget *widget)
1638 g_return_if_fail (widget != NULL);
1640 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[DRAW_DEFAULT]);
1643 /*****************************************
1644 * gtk_widget_draw_children:
1649 *****************************************/
1652 gtk_widget_draw_children (GtkWidget *widget)
1654 g_return_if_fail (widget != NULL);
1656 if (GTK_IS_CONTAINER (widget))
1657 gtk_container_foreach (GTK_CONTAINER (widget),
1658 gtk_widget_draw_children_recurse,
1662 /*****************************************
1663 * gtk_widget_size_request:
1668 *****************************************/
1671 gtk_widget_size_request (GtkWidget *widget,
1672 GtkRequisition *requisition)
1674 GtkWidgetAuxInfo *aux_info;
1676 g_return_if_fail (widget != NULL);
1678 gtk_widget_ref (widget);
1679 gtk_widget_ensure_style (widget);
1680 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[SIZE_REQUEST],
1682 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
1685 if (aux_info->width > 0)
1686 requisition->width = aux_info->width;
1687 if (aux_info->height > 0)
1688 requisition->height = aux_info->height;
1690 gtk_widget_unref (widget);
1693 /*****************************************
1694 * gtk_widget_size_allocate:
1699 *****************************************/
1702 gtk_widget_size_allocate (GtkWidget *widget,
1703 GtkAllocation *allocation)
1705 GtkWidgetAuxInfo *aux_info;
1706 GtkAllocation real_allocation;
1708 g_return_if_fail (widget != NULL);
1710 real_allocation = *allocation;
1711 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
1715 if (aux_info->x != -1)
1716 real_allocation.x = aux_info->x;
1717 if (aux_info->y != -1)
1718 real_allocation.y = aux_info->y;
1721 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[SIZE_ALLOCATE], &real_allocation);
1724 /*****************************************
1725 * gtk_widget_install_accelerator:
1730 *****************************************/
1733 gtk_widget_install_accelerator (GtkWidget *widget,
1734 GtkAcceleratorTable *table,
1735 const gchar *signal_name,
1741 g_return_if_fail (widget != NULL);
1743 gtk_widget_ref (widget);
1745 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[INSTALL_ACCELERATOR],
1746 signal_name, key, modifiers, &return_val);
1748 gtk_accelerator_table_install (table,
1749 GTK_OBJECT (widget),
1753 gtk_widget_unref (widget);
1756 /*****************************************
1757 * gtk_widget_remove_accelerator:
1762 *****************************************/
1765 gtk_widget_remove_accelerator (GtkWidget *widget,
1766 GtkAcceleratorTable *table,
1767 const gchar *signal_name)
1769 g_return_if_fail (widget != NULL);
1771 gtk_widget_ref (widget);
1772 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[REMOVE_ACCELERATOR],
1774 gtk_accelerator_table_remove (table, GTK_OBJECT (widget), signal_name);
1775 gtk_widget_unref (widget);
1778 /*****************************************
1784 *****************************************/
1787 gtk_widget_event (GtkWidget *widget,
1793 g_return_val_if_fail (widget != NULL, TRUE);
1795 gtk_widget_ref (widget);
1797 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[EVENT], event,
1799 if (return_val || GTK_OBJECT_DESTROYED (widget))
1801 gtk_widget_unref (widget);
1805 switch (event->type)
1810 case GDK_BUTTON_PRESS:
1811 case GDK_2BUTTON_PRESS:
1812 case GDK_3BUTTON_PRESS:
1813 signal_num = BUTTON_PRESS_EVENT;
1815 case GDK_BUTTON_RELEASE:
1816 signal_num = BUTTON_RELEASE_EVENT;
1818 case GDK_MOTION_NOTIFY:
1819 signal_num = MOTION_NOTIFY_EVENT;
1822 signal_num = DELETE_EVENT;
1825 signal_num = DESTROY_EVENT;
1828 signal_num = KEY_PRESS_EVENT;
1830 case GDK_KEY_RELEASE:
1831 signal_num = KEY_RELEASE_EVENT;
1833 case GDK_ENTER_NOTIFY:
1834 signal_num = ENTER_NOTIFY_EVENT;
1836 case GDK_LEAVE_NOTIFY:
1837 signal_num = LEAVE_NOTIFY_EVENT;
1839 case GDK_FOCUS_CHANGE:
1840 if (event->focus_change.in)
1841 signal_num = FOCUS_IN_EVENT;
1843 signal_num = FOCUS_OUT_EVENT;
1846 signal_num = CONFIGURE_EVENT;
1849 signal_num = MAP_EVENT;
1852 signal_num = UNMAP_EVENT;
1854 case GDK_PROPERTY_NOTIFY:
1855 signal_num = PROPERTY_NOTIFY_EVENT;
1857 case GDK_SELECTION_CLEAR:
1858 signal_num = SELECTION_CLEAR_EVENT;
1860 case GDK_SELECTION_REQUEST:
1861 signal_num = SELECTION_REQUEST_EVENT;
1863 case GDK_SELECTION_NOTIFY:
1864 signal_num = SELECTION_NOTIFY_EVENT;
1866 case GDK_PROXIMITY_IN:
1867 signal_num = PROXIMITY_IN_EVENT;
1869 case GDK_PROXIMITY_OUT:
1870 signal_num = PROXIMITY_OUT_EVENT;
1872 case GDK_DRAG_BEGIN:
1873 signal_num = DRAG_BEGIN_EVENT;
1875 case GDK_DRAG_REQUEST:
1876 signal_num = DRAG_REQUEST_EVENT;
1878 case GDK_DROP_ENTER:
1879 signal_num = DROP_ENTER_EVENT;
1881 case GDK_DROP_LEAVE:
1882 signal_num = DROP_LEAVE_EVENT;
1884 case GDK_DROP_DATA_AVAIL:
1885 signal_num = DROP_DATA_AVAILABLE_EVENT;
1887 case GDK_OTHER_EVENT:
1888 signal_num = OTHER_EVENT;
1891 signal_num = NO_EXPOSE_EVENT;
1893 case GDK_CLIENT_EVENT:
1894 signal_num = CLIENT_EVENT;
1897 /* there is no sense in providing a widget with bogus expose events
1899 if (!event->any.window)
1901 gtk_widget_unref (widget);
1904 signal_num = EXPOSE_EVENT;
1907 g_warning ("could not determine signal number for event: %d", event->type);
1908 gtk_widget_unref (widget);
1912 if (signal_num != -1)
1913 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[signal_num], event, &return_val);
1915 return_val |= GTK_OBJECT_DESTROYED (widget);
1917 gtk_widget_unref (widget);
1922 /*****************************************
1923 * gtk_widget_activate:
1928 *****************************************/
1931 gtk_widget_activate (GtkWidget *widget)
1933 g_return_if_fail (widget != NULL);
1934 g_return_if_fail (GTK_IS_WIDGET (widget));
1936 if (WIDGET_CLASS (widget)->activate_signal)
1937 gtk_signal_emit (GTK_OBJECT (widget), WIDGET_CLASS (widget)->activate_signal);
1940 /*****************************************
1941 * gtk_widget_reparent_container_child:
1942 * assistent function to gtk_widget_reparent
1947 *****************************************/
1950 gtk_widget_reparent_container_child(GtkWidget *widget,
1951 gpointer client_data)
1953 g_return_if_fail (widget != NULL);
1954 g_return_if_fail (client_data != NULL);
1956 if (GTK_WIDGET_NO_WINDOW (widget))
1959 gdk_window_unref (widget->window);
1960 widget->window = (GdkWindow*) client_data;
1962 gdk_window_ref (widget->window);
1964 if (GTK_IS_CONTAINER (widget))
1965 gtk_container_foreach (GTK_CONTAINER (widget),
1966 gtk_widget_reparent_container_child,
1970 gdk_window_reparent (widget->window,
1971 (GdkWindow*) client_data, 0, 0);
1974 /*****************************************
1975 * gtk_widget_reparent:
1980 *****************************************/
1983 gtk_widget_reparent (GtkWidget *widget,
1984 GtkWidget *new_parent)
1986 g_return_if_fail (widget != NULL);
1987 g_return_if_fail (GTK_IS_WIDGET (widget));
1988 g_return_if_fail (new_parent != NULL);
1989 g_return_if_fail (GTK_IS_CONTAINER (new_parent));
1990 g_return_if_fail (widget->parent != NULL);
1992 if (widget->parent != new_parent)
1994 /* First try to see if we can get away without unrealizing
1995 * the widget as we reparent it. if so we set a flag so
1996 * that gtk_widget_unparent doesn't unrealize widget
1998 if (GTK_WIDGET_REALIZED (widget) && GTK_WIDGET_REALIZED (new_parent))
1999 GTK_PRIVATE_SET_FLAG (widget, GTK_IN_REPARENT);
2001 gtk_widget_ref (widget);
2002 gtk_container_remove (GTK_CONTAINER (widget->parent), widget);
2003 gtk_container_add (GTK_CONTAINER (new_parent), widget);
2004 gtk_widget_unref (widget);
2006 if (GTK_WIDGET_IN_REPARENT (widget))
2008 GTK_PRIVATE_UNSET_FLAG (widget, GTK_IN_REPARENT);
2010 /* OK, now fix up the widget's window. (And that for any
2011 * children, if the widget is NO_WINDOW and a container)
2013 if (GTK_WIDGET_NO_WINDOW (widget))
2015 if (GTK_IS_CONTAINER (widget))
2016 gtk_container_foreach (GTK_CONTAINER (widget),
2017 gtk_widget_reparent_container_child,
2018 gtk_widget_get_parent_window (widget));
2021 GdkWindow *parent_window;
2023 parent_window = gtk_widget_get_parent_window (widget);
2024 if (parent_window != widget->window)
2027 gdk_window_unref (widget->window);
2028 widget->window = parent_window;
2030 gdk_window_ref (widget->window);
2035 gdk_window_reparent (widget->window, gtk_widget_get_parent_window (widget), 0, 0);
2040 /*****************************************
2046 *****************************************/
2049 gtk_widget_popup (GtkWidget *widget,
2053 g_return_if_fail (widget != NULL);
2055 if (!GTK_WIDGET_VISIBLE (widget))
2057 if (!GTK_WIDGET_REALIZED (widget))
2058 gtk_widget_realize (widget);
2059 if (!GTK_WIDGET_NO_WINDOW (widget))
2060 gdk_window_move (widget->window, x, y);
2061 gtk_widget_show (widget);
2065 /*****************************************
2066 * gtk_widget_intersect:
2071 *****************************************/
2074 gtk_widget_intersect (GtkWidget *widget,
2076 GdkRectangle *intersection)
2082 g_return_val_if_fail (widget != NULL, FALSE);
2083 g_return_val_if_fail (area != NULL, FALSE);
2086 dest = intersection;
2090 return_val = gdk_rectangle_intersect ((GdkRectangle*) &widget->allocation, area, dest);
2092 if (return_val && intersection && !GTK_WIDGET_NO_WINDOW (widget))
2094 intersection->x -= widget->allocation.x;
2095 intersection->y -= widget->allocation.y;
2103 gtk_widget_basic (GtkWidget *widget)
2109 g_return_val_if_fail (widget != NULL, FALSE);
2111 if (!GTK_WIDGET_BASIC (widget))
2113 else if (GTK_IS_CONTAINER (widget))
2115 children = gtk_container_children (GTK_CONTAINER (widget));
2119 tmp_list = children;
2123 if (!gtk_widget_basic (GTK_WIDGET (tmp_list->data)))
2129 tmp_list = tmp_list->next;
2132 g_list_free (children);
2141 /*****************************************
2142 * gtk_widget_grab_focus:
2147 *****************************************/
2150 gtk_widget_grab_focus (GtkWidget *widget)
2154 GtkType window_type;
2156 g_return_if_fail (widget != NULL);
2158 window_type = gtk_window_get_type ();
2159 window = widget->parent;
2162 while (window && !gtk_type_is_a (GTK_WIDGET_TYPE (window), window_type))
2164 GTK_CONTAINER (window)->focus_child = child;
2166 window = window->parent;
2169 if (window && gtk_type_is_a (GTK_WIDGET_TYPE (window), window_type))
2171 GTK_CONTAINER (window)->focus_child = child;
2172 gtk_window_set_focus (GTK_WINDOW (window), widget);
2176 /*****************************************
2177 * gtk_widget_grab_default:
2182 *****************************************/
2185 gtk_widget_grab_default (GtkWidget *widget)
2188 GtkType window_type;
2190 g_return_if_fail (widget != NULL);
2191 g_return_if_fail (GTK_WIDGET_CAN_DEFAULT (widget));
2193 window_type = gtk_window_get_type ();
2194 window = widget->parent;
2196 while (window && !gtk_type_is_a (GTK_WIDGET_TYPE (window), window_type))
2197 window = window->parent;
2199 if (window && gtk_type_is_a (GTK_WIDGET_TYPE (window), window_type))
2200 gtk_window_set_default (GTK_WINDOW (window), widget);
2203 /*****************************************
2204 * gtk_widget_set_name:
2209 *****************************************/
2212 gtk_widget_set_name (GtkWidget *widget,
2215 g_return_if_fail (widget != NULL);
2218 g_free (widget->name);
2219 widget->name = g_strdup (name);
2221 if (!GTK_WIDGET_USER_STYLE (widget))
2222 gtk_widget_set_rc_style (widget);
2225 /*****************************************
2226 * gtk_widget_get_name:
2231 *****************************************/
2234 gtk_widget_get_name (GtkWidget *widget)
2236 g_return_val_if_fail (widget != NULL, NULL);
2239 return widget->name;
2240 return gtk_type_name (GTK_WIDGET_TYPE (widget));
2243 /*****************************************
2244 * gtk_widget_set_state:
2251 *****************************************/
2254 gtk_widget_set_state (GtkWidget *widget,
2257 g_return_if_fail (widget != NULL);
2259 if (state == GTK_WIDGET_STATE (widget))
2262 if (state == GTK_STATE_INSENSITIVE)
2263 gtk_widget_set_sensitive (widget, FALSE);
2267 GtkStateType old_state;
2271 data.parent_sensitive = GTK_WIDGET_IS_SENSITIVE (widget->parent);
2273 data.parent_sensitive = GTK_PARENT_SENSITIVE;
2275 old_state = GTK_WIDGET_STATE (widget);
2277 gtk_widget_propagate_state (widget, &data);
2278 if (old_state != GTK_WIDGET_STATE (widget))
2279 gtk_widget_queue_draw (widget);
2283 /*****************************************
2284 * gtk_widget_set_sensitive:
2288 * boolean value for sensitivity
2291 *****************************************/
2294 gtk_widget_set_sensitive (GtkWidget *widget,
2298 GtkStateType old_state;
2300 g_return_if_fail (widget != NULL);
2304 GTK_WIDGET_SET_FLAGS (widget, GTK_SENSITIVE);
2305 if (GTK_WIDGET_STATE (widget) == GTK_STATE_INSENSITIVE)
2306 data.state = GTK_WIDGET_SAVED_STATE (widget);
2308 data.state = GTK_WIDGET_STATE (widget);
2312 GTK_WIDGET_UNSET_FLAGS (widget, GTK_SENSITIVE);
2313 data.state = GTK_WIDGET_STATE (widget);
2317 data.parent_sensitive = GTK_WIDGET_IS_SENSITIVE (widget->parent);
2319 data.parent_sensitive = GTK_PARENT_SENSITIVE;
2321 old_state = GTK_WIDGET_STATE (widget);
2322 gtk_widget_propagate_state (widget, &data);
2323 if (old_state != GTK_WIDGET_STATE (widget))
2324 gtk_widget_queue_draw (widget);
2327 /*****************************************
2328 * gtk_widget_set_parent:
2333 *****************************************/
2336 gtk_widget_set_parent (GtkWidget *widget,
2341 g_return_if_fail (widget != NULL);
2342 g_return_if_fail (widget->parent == NULL);
2343 g_return_if_fail (!GTK_WIDGET_TOPLEVEL (widget));
2344 g_return_if_fail (parent != NULL);
2346 /* keep this function in sync with gtk_menu_attach_to_widget()
2349 gtk_widget_ref (widget);
2350 gtk_object_sink (GTK_OBJECT (widget));
2351 widget->parent = parent;
2353 if (GTK_WIDGET_STATE (parent) != GTK_STATE_NORMAL)
2354 data.state = GTK_WIDGET_STATE (parent);
2356 data.state = GTK_WIDGET_STATE (widget);
2357 data.parent_sensitive = GTK_WIDGET_IS_SENSITIVE (parent);
2359 gtk_widget_propagate_state (widget, &data);
2361 while (parent->parent != NULL)
2362 parent = parent->parent;
2364 gtk_widget_set_style_recurse (widget, NULL);
2366 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[PARENT_SET], NULL);
2369 /*****************************************
2371 * see docs/styles.txt
2372 *****************************************/
2374 gtk_widget_set_style (GtkWidget *widget,
2377 GtkStyle *default_style;
2378 gboolean initial_emission;
2380 g_return_if_fail (widget != NULL);
2381 g_return_if_fail (style != NULL);
2383 initial_emission = !GTK_WIDGET_RC_STYLE (widget) && !GTK_WIDGET_USER_STYLE (widget);
2385 GTK_WIDGET_UNSET_FLAGS (widget, GTK_RC_STYLE);
2386 GTK_PRIVATE_SET_FLAG (widget, GTK_USER_STYLE);
2388 default_style = gtk_object_get_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
2391 gtk_style_ref (widget->style);
2392 if (!saved_default_style_key_id)
2393 saved_default_style_key_id = gtk_object_data_force_id (saved_default_style_key);
2394 gtk_object_set_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id, widget->style);
2397 gtk_widget_set_style_internal (widget, style, initial_emission);
2401 gtk_widget_ensure_style (GtkWidget *widget)
2403 if (!GTK_WIDGET_USER_STYLE (widget) &&
2404 !GTK_WIDGET_RC_STYLE (widget))
2405 gtk_widget_set_rc_style (widget);
2409 gtk_widget_set_rc_style (GtkWidget *widget)
2411 GtkStyle *saved_style;
2412 GtkStyle *new_style;
2413 gboolean initial_emission;
2415 g_return_if_fail (widget != NULL);
2417 initial_emission = !GTK_WIDGET_RC_STYLE (widget) && !GTK_WIDGET_USER_STYLE (widget);
2419 GTK_PRIVATE_UNSET_FLAG (widget, GTK_USER_STYLE);
2420 GTK_WIDGET_SET_FLAGS (widget, GTK_RC_STYLE);
2422 saved_style = gtk_object_get_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
2423 new_style = gtk_rc_get_style (widget);
2428 gtk_style_ref (widget->style);
2429 if (!saved_default_style_key_id)
2430 saved_default_style_key_id = gtk_object_data_force_id (saved_default_style_key);
2431 gtk_object_set_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id, widget->style);
2433 gtk_widget_set_style_internal (widget, new_style, initial_emission);
2439 g_assert (initial_emission == FALSE); /* FIXME: remove this line */
2441 gtk_object_remove_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
2442 gtk_widget_set_style_internal (widget, saved_style, initial_emission);
2443 gtk_style_unref (saved_style);
2447 if (initial_emission)
2448 gtk_widget_set_style_internal (widget, widget->style, TRUE);
2454 gtk_widget_restore_default_style (GtkWidget *widget)
2456 GtkStyle *default_style;
2458 g_return_if_fail (widget != NULL);
2460 GTK_PRIVATE_UNSET_FLAG (widget, GTK_USER_STYLE);
2462 default_style = gtk_object_get_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
2465 gtk_object_remove_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
2466 gtk_widget_set_style_internal (widget, default_style, FALSE);
2467 gtk_style_unref (default_style);
2472 gtk_widget_get_style (GtkWidget *widget)
2474 g_return_val_if_fail (widget != NULL, NULL);
2476 return widget->style;
2480 gtk_widget_style_set (GtkWidget *widget,
2481 GtkStyle *previous_style)
2483 if (GTK_WIDGET_REALIZED (widget) &&
2484 !GTK_WIDGET_NO_WINDOW (widget))
2485 gtk_style_set_background (widget->style, widget->window, widget->state);
2489 gtk_widget_set_style_internal (GtkWidget *widget,
2491 gboolean initial_emission)
2493 g_return_if_fail (widget != NULL);
2494 g_return_if_fail (style != NULL);
2496 if (widget->style != style)
2498 GtkStyle *previous_style;
2500 if (GTK_WIDGET_REALIZED (widget))
2501 gtk_style_detach (widget->style);
2503 previous_style = widget->style;
2504 widget->style = style;
2505 gtk_style_ref (widget->style);
2507 if (GTK_WIDGET_REALIZED (widget))
2508 widget->style = gtk_style_attach (widget->style, widget->window);
2510 gtk_signal_emit (GTK_OBJECT (widget),
2511 widget_signals[STYLE_SET],
2512 initial_emission ? NULL : previous_style);
2513 gtk_style_unref (previous_style);
2515 if (widget->parent && !initial_emission)
2517 GtkRequisition old_requisition;
2519 old_requisition = widget->requisition;
2520 gtk_widget_size_request (widget, &widget->requisition);
2522 if ((old_requisition.width != widget->requisition.width) ||
2523 (old_requisition.height != widget->requisition.height))
2524 gtk_widget_queue_resize (widget);
2525 else if (GTK_WIDGET_DRAWABLE (widget))
2526 gtk_widget_queue_draw (widget);
2529 else if (initial_emission)
2531 gtk_signal_emit (GTK_OBJECT (widget),
2532 widget_signals[STYLE_SET],
2538 gtk_widget_set_style_recurse (GtkWidget *widget,
2539 gpointer client_data)
2541 if (GTK_WIDGET_RC_STYLE (widget))
2542 gtk_widget_set_rc_style (widget);
2544 if (GTK_IS_CONTAINER (widget))
2545 gtk_container_foreach (GTK_CONTAINER (widget),
2546 gtk_widget_set_style_recurse,
2551 gtk_widget_set_default_style (GtkStyle *style)
2553 if (style != default_style)
2556 gtk_style_unref (default_style);
2557 default_style = style;
2559 gtk_style_ref (default_style);
2564 gtk_widget_get_default_style ()
2568 default_style = gtk_style_new ();
2569 gtk_style_ref (default_style);
2572 return default_style;
2576 gtk_widget_push_style (GtkStyle *style)
2578 g_return_if_fail (style != NULL);
2580 gtk_style_ref (style);
2581 style_stack = g_slist_prepend (style_stack, style);
2585 gtk_widget_peek_style ()
2588 return (GtkStyle*) style_stack->data;
2590 return gtk_widget_get_default_style ();
2594 gtk_widget_pop_style ()
2601 style_stack = style_stack->next;
2602 gtk_style_unref ((GtkStyle*) tmp->data);
2603 g_slist_free_1 (tmp);
2607 /* Basically, send a message to all toplevel windows telling them
2608 * that a new _GTK_STYLE_COLORS property is available on the root
2612 gtk_widget_propagate_default_style (void)
2617 /* Set the property on the root window */
2618 gdk_property_change(GDK_ROOT_PARENT(),
2619 gdk_atom_intern("_GTK_DEFAULT_COLORS", FALSE),
2620 gdk_atom_intern("STRING", FALSE),
2622 GDK_PROP_MODE_REPLACE,
2623 (guchar *)gtk_widget_get_default_style(),
2624 GTK_STYLE_NUM_STYLECOLORS() * sizeof(GdkColor));
2626 for(i = 0; i < 5; i++)
2628 sev.data_format = 32;
2629 sev.message_type = gdk_atom_intern ("_GTK_STYLE_CHANGED", FALSE);
2630 gdk_event_send_clientmessage_toall ((GdkEvent *) &sev);
2633 /*************************************************************
2634 * gtk_widget_set_parent_window:
2635 * Set a non default parent window for widget
2642 *************************************************************/
2645 gtk_widget_set_parent_window (GtkWidget *widget,
2646 GdkWindow *parent_window)
2648 GdkWindow *old_parent_window;
2650 g_return_if_fail (widget != NULL);
2652 old_parent_window = gtk_object_get_data_by_id (GTK_OBJECT (widget),
2653 parent_window_key_id);
2655 if (parent_window != old_parent_window)
2657 if (!parent_window_key_id)
2658 parent_window_key_id = gtk_object_data_force_id (parent_window_key);
2659 gtk_object_set_data_by_id (GTK_OBJECT (widget), parent_window_key_id,
2661 if (old_parent_window)
2662 gdk_window_unref (old_parent_window);
2664 gdk_window_ref (parent_window);
2668 /*************************************************************
2669 * gtk_widget_get_parent_window:
2670 * Get widget's parent window
2677 *************************************************************/
2680 gtk_widget_get_parent_window (GtkWidget *widget)
2682 GdkWindow *parent_window;
2684 g_return_val_if_fail (widget != NULL, NULL);
2685 g_return_val_if_fail (GTK_IS_WIDGET (widget), NULL);
2686 g_return_val_if_fail (widget->parent != NULL, NULL);
2688 parent_window = gtk_object_get_data_by_id (GTK_OBJECT (widget),
2689 parent_window_key_id);
2691 return (parent_window != NULL) ? parent_window : widget->parent->window;
2694 /*****************************************
2695 * gtk_widget_set_uposition:
2700 *****************************************/
2703 gtk_widget_set_uposition (GtkWidget *widget,
2707 GtkWidgetAuxInfo *aux_info;
2709 g_return_if_fail (widget != NULL);
2711 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
2714 if (!aux_info_key_id)
2715 aux_info_key_id = gtk_object_data_force_id (aux_info_key);
2716 aux_info = gtk_widget_aux_info_new ();
2717 gtk_object_set_data_by_id (GTK_OBJECT (widget), aux_info_key_id, aux_info);
2725 if (GTK_WIDGET_REALIZED (widget) && GTK_IS_WINDOW (widget) &&
2726 (aux_info->x != -1) && (aux_info->y != -1))
2728 gdk_window_set_hints (widget->window, aux_info->x, aux_info->y, 0, 0, 0, 0, GDK_HINT_POS);
2729 gdk_window_move (widget->window, aux_info->x, aux_info->y);
2732 if (GTK_WIDGET_VISIBLE (widget) && widget->parent)
2733 gtk_widget_size_allocate (widget, &widget->allocation);
2736 /*****************************************
2737 * gtk_widget_set_usize:
2742 *****************************************/
2745 gtk_widget_set_usize (GtkWidget *widget,
2749 GtkWidgetAuxInfo *aux_info;
2751 g_return_if_fail (widget != NULL);
2753 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
2756 if (!aux_info_key_id)
2757 aux_info_key_id = gtk_object_data_force_id (aux_info_key);
2758 aux_info = gtk_widget_aux_info_new ();
2759 gtk_object_set_data_by_id (GTK_OBJECT (widget), aux_info_key_id, aux_info);
2763 aux_info->width = width;
2765 aux_info->height = height;
2767 if (GTK_WIDGET_VISIBLE (widget))
2768 gtk_widget_queue_resize (widget);
2771 /*****************************************
2772 * gtk_widget_set_events:
2777 *****************************************/
2780 gtk_widget_set_events (GtkWidget *widget,
2785 g_return_if_fail (widget != NULL);
2786 g_return_if_fail (!GTK_WIDGET_NO_WINDOW (widget));
2787 g_return_if_fail (!GTK_WIDGET_REALIZED (widget));
2789 eventp = gtk_object_get_data_by_id (GTK_OBJECT (widget), event_key_id);
2794 eventp = g_new (gint, 1);
2798 event_key_id = gtk_object_data_force_id (event_key);
2799 gtk_object_set_data_by_id (GTK_OBJECT (widget), event_key_id, eventp);
2804 gtk_object_remove_data_by_id (GTK_OBJECT (widget), event_key_id);
2808 /*****************************************
2809 * gtk_widget_set_extension_events:
2814 *****************************************/
2817 gtk_widget_set_extension_events (GtkWidget *widget,
2818 GdkExtensionMode mode)
2820 GdkExtensionMode *modep;
2822 g_return_if_fail (widget != NULL);
2824 modep = gtk_object_get_data_by_id (GTK_OBJECT (widget), extension_event_key_id);
2827 modep = g_new (GdkExtensionMode, 1);
2830 if (!extension_event_key_id)
2831 extension_event_key_id = gtk_object_data_force_id (extension_event_key);
2832 gtk_object_set_data_by_id (GTK_OBJECT (widget), extension_event_key_id, modep);
2836 /*****************************************
2837 * gtk_widget_get_toplevel:
2842 *****************************************/
2845 gtk_widget_get_toplevel (GtkWidget *widget)
2847 g_return_val_if_fail (widget != NULL, NULL);
2849 while (widget->parent)
2850 widget = widget->parent;
2855 /*****************************************
2856 * gtk_widget_get_ancestor:
2861 *****************************************/
2864 gtk_widget_get_ancestor (GtkWidget *widget,
2865 GtkType widget_type)
2867 g_return_val_if_fail (widget != NULL, NULL);
2869 while (widget && !gtk_type_is_a (GTK_WIDGET_TYPE (widget), widget_type))
2870 widget = widget->parent;
2872 if (!(widget && gtk_type_is_a (GTK_WIDGET_TYPE (widget), widget_type)))
2878 /*****************************************
2879 * gtk_widget_get_colormap:
2884 *****************************************/
2887 gtk_widget_get_colormap (GtkWidget *widget)
2889 GdkColormap *colormap;
2891 g_return_val_if_fail (widget != NULL, NULL);
2893 if (!widget->window)
2895 colormap = gtk_object_get_data (GTK_OBJECT (widget), colormap_key);
2898 return gtk_widget_get_default_colormap ();
2901 return gdk_window_get_colormap (widget->window);
2904 /*****************************************
2905 * gtk_widget_get_visual:
2910 *****************************************/
2913 gtk_widget_get_visual (GtkWidget *widget)
2917 g_return_val_if_fail (widget != NULL, NULL);
2919 if (!widget->window)
2921 visual = gtk_object_get_data (GTK_OBJECT (widget), visual_key);
2924 return gtk_widget_get_default_visual ();
2927 return gdk_window_get_visual (widget->window);
2930 /*****************************************
2931 * gtk_widget_get_events:
2936 *****************************************/
2939 gtk_widget_get_events (GtkWidget *widget)
2943 g_return_val_if_fail (widget != NULL, 0);
2945 events = gtk_object_get_data_by_id (GTK_OBJECT (widget), event_key_id);
2952 /*****************************************
2953 * gtk_widget_get_extension_events:
2958 *****************************************/
2961 gtk_widget_get_extension_events (GtkWidget *widget)
2963 GdkExtensionMode *mode;
2965 g_return_val_if_fail (widget != NULL, 0);
2967 mode = gtk_object_get_data_by_id (GTK_OBJECT (widget), extension_event_key_id);
2974 /*****************************************
2975 * gtk_widget_get_pointer:
2980 *****************************************/
2983 gtk_widget_get_pointer (GtkWidget *widget,
2987 g_return_if_fail (widget != NULL);
2994 if (GTK_WIDGET_REALIZED (widget))
2996 gdk_window_get_pointer (widget->window, x, y, NULL);
2998 if (GTK_WIDGET_NO_WINDOW (widget))
3001 *x -= widget->allocation.x;
3003 *y -= widget->allocation.y;
3008 /*****************************************
3009 * gtk_widget_is_ancestor:
3014 *****************************************/
3017 gtk_widget_is_ancestor (GtkWidget *widget,
3018 GtkWidget *ancestor)
3020 g_return_val_if_fail (widget != NULL, FALSE);
3021 g_return_val_if_fail (ancestor != NULL, FALSE);
3025 if (widget->parent == ancestor)
3027 widget = widget->parent;
3033 /*****************************************
3034 * gtk_widget_is_child:
3039 *****************************************/
3042 gtk_widget_is_child (GtkWidget *widget,
3045 g_return_val_if_fail (widget != NULL, FALSE);
3046 g_return_val_if_fail (child != NULL, FALSE);
3048 return (child->parent == widget);
3051 /*****************************************
3052 * gtk_widget_push_colormap:
3057 *****************************************/
3060 gtk_widget_push_colormap (GdkColormap *cmap)
3062 g_return_if_fail (cmap != NULL);
3064 colormap_stack = g_slist_prepend (colormap_stack, cmap);
3067 /*****************************************
3068 * gtk_widget_push_visual:
3073 *****************************************/
3076 gtk_widget_push_visual (GdkVisual *visual)
3078 g_return_if_fail (visual != NULL);
3080 visual_stack = g_slist_prepend (visual_stack, visual);
3083 /*****************************************
3084 * gtk_widget_pop_colormap:
3089 *****************************************/
3092 gtk_widget_pop_colormap ()
3098 tmp = colormap_stack;
3099 colormap_stack = colormap_stack->next;
3100 g_slist_free_1 (tmp);
3104 /*****************************************
3105 * gtk_widget_pop_visual:
3110 *****************************************/
3113 gtk_widget_pop_visual ()
3120 visual_stack = visual_stack->next;
3121 g_slist_free_1 (tmp);
3125 /*****************************************
3126 * gtk_widget_set_default_colormap:
3131 *****************************************/
3134 gtk_widget_set_default_colormap (GdkColormap *colormap)
3136 if (default_colormap != colormap)
3138 if (default_colormap)
3139 gdk_colormap_unref (default_colormap);
3140 default_colormap = colormap;
3141 if (default_colormap)
3142 gdk_colormap_ref (default_colormap);
3146 /*****************************************
3147 * gtk_widget_set_default_visual:
3152 *****************************************/
3155 gtk_widget_set_default_visual (GdkVisual *visual)
3157 default_visual = visual;
3160 /*****************************************
3161 * gtk_widget_get_default_colormap:
3166 *****************************************/
3169 gtk_widget_get_default_colormap ()
3171 if (!default_colormap)
3172 default_colormap = gdk_colormap_get_system ();
3174 return default_colormap;
3177 /*****************************************
3178 * gtk_widget_get_default_visual:
3183 *****************************************/
3186 gtk_widget_get_default_visual ()
3188 if (!default_visual)
3189 default_visual = gdk_visual_get_system ();
3191 return default_visual;
3194 /*****************************************
3195 * gtk_widget_marshal_signal_1:
3200 *****************************************/
3203 gtk_widget_marshal_signal_1 (GtkObject *object,
3208 GtkWidgetSignal1 rfunc;
3210 rfunc = (GtkWidgetSignal1) func;
3213 GTK_VALUE_POINTER (args[0]),
3217 /*****************************************
3218 * gtk_widget_marshal_signal_2:
3223 *****************************************/
3226 gtk_widget_marshal_signal_2 (GtkObject *object,
3231 GtkWidgetSignal2 rfunc;
3234 rfunc = (GtkWidgetSignal2) func;
3235 return_val = GTK_RETLOC_BOOL (args[3]);
3237 *return_val = (* rfunc) (object,
3238 GTK_VALUE_STRING (args[0]),
3239 GTK_VALUE_CHAR (args[1]),
3240 GTK_VALUE_INT (args[2]),
3244 /*****************************************
3245 * gtk_widget_marshal_signal_3:
3250 *****************************************/
3253 gtk_widget_marshal_signal_3 (GtkObject *object,
3258 GtkWidgetSignal3 rfunc;
3260 rfunc = (GtkWidgetSignal3) func;
3263 GTK_VALUE_STRING (args[0]),
3267 /*****************************************
3268 * gtk_widget_marshal_signal_4:
3273 *****************************************/
3276 gtk_widget_marshal_signal_4 (GtkObject *object,
3281 GtkWidgetSignal4 rfunc;
3284 rfunc = (GtkWidgetSignal4) func;
3285 return_val = GTK_RETLOC_BOOL (args[1]);
3287 *return_val = (* rfunc) (object,
3288 GTK_VALUE_BOXED (args[0]),
3292 /*****************************************
3293 * gtk_widget_marshal_signal_5:
3298 *****************************************/
3301 gtk_widget_marshal_signal_5 (GtkObject *object,
3306 GtkWidgetSignal5 rfunc;
3308 rfunc = (GtkWidgetSignal5) func;
3311 GTK_VALUE_UINT (args[0]),
3315 /*****************************************
3316 * gtk_widget_marshal_signal_6:
3321 *****************************************/
3324 gtk_widget_marshal_signal_6 (GtkObject *object,
3329 GtkWidgetSignal6 rfunc;
3331 rfunc = (GtkWidgetSignal6) func;
3334 GTK_VALUE_OBJECT (args[0]),
3338 /*****************************************
3339 * gtk_widget_marshal_signal_7:
3344 *****************************************/
3347 gtk_widget_marshal_signal_7 (GtkObject *object,
3352 GtkWidgetSignal7 rfunc;
3354 rfunc = (GtkWidgetSignal7) func;
3357 GTK_VALUE_BOXED (args[0]),
3362 gtk_widget_shutdown (GtkObject *object)
3366 /* gtk_object_destroy() will already hold a refcount on object
3368 widget = GTK_WIDGET (object);
3371 gtk_container_remove (GTK_CONTAINER (widget->parent), widget);
3373 GTK_WIDGET_UNSET_FLAGS (widget, GTK_VISIBLE);
3374 if (GTK_WIDGET_REALIZED (widget))
3375 gtk_widget_unrealize (widget);
3377 parent_class->shutdown (object);
3381 gtk_widget_real_destroy (GtkObject *object)
3384 GtkStyle *saved_style;
3386 /* gtk_object_destroy() will already hold a refcount on object
3388 widget = GTK_WIDGET (object);
3390 if (GTK_CONTAINER_RESIZE_PENDING (widget))
3392 gtk_widget_resize_queue = g_slist_remove (gtk_widget_resize_queue, widget);
3393 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_PENDING);
3396 gtk_grab_remove (widget);
3397 gtk_selection_remove_all (widget);
3399 saved_style = gtk_object_get_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
3402 gtk_style_unref (saved_style);
3403 gtk_object_remove_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
3406 gtk_style_unref (widget->style);
3407 widget->style = NULL;
3409 parent_class->destroy (object);
3413 gtk_widget_finalize (GtkObject *object)
3416 GtkWidgetAuxInfo *aux_info;
3418 GdkExtensionMode *mode;
3420 widget = GTK_WIDGET (object);
3423 g_free (widget->name);
3425 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
3427 gtk_widget_aux_info_destroy (aux_info);
3429 events = gtk_object_get_data_by_id (GTK_OBJECT (widget), event_key_id);
3433 mode = gtk_object_get_data_by_id (GTK_OBJECT (widget), extension_event_key_id);
3437 parent_class->finalize (object);
3440 /*****************************************
3441 * gtk_widget_real_show:
3446 *****************************************/
3449 gtk_widget_real_show (GtkWidget *widget)
3451 g_return_if_fail (widget != NULL);
3452 g_return_if_fail (GTK_IS_WIDGET (widget));
3454 if (!GTK_WIDGET_VISIBLE (widget))
3456 GTK_WIDGET_SET_FLAGS (widget, GTK_VISIBLE);
3460 gtk_widget_queue_resize (widget->parent);
3462 if (GTK_WIDGET_MAPPED (widget->parent))
3463 gtk_widget_map (widget);
3468 /*****************************************
3469 * gtk_widget_real_hide:
3474 *****************************************/
3477 gtk_widget_real_hide (GtkWidget *widget)
3479 g_return_if_fail (widget != NULL);
3480 g_return_if_fail (GTK_IS_WIDGET (widget));
3482 if (GTK_WIDGET_VISIBLE (widget))
3484 GTK_WIDGET_UNSET_FLAGS (widget, GTK_VISIBLE);
3486 if (GTK_WIDGET_MAPPED (widget))
3487 gtk_widget_unmap (widget);
3490 gtk_widget_queue_resize (widget);
3494 /*****************************************
3495 * gtk_widget_real_map:
3500 *****************************************/
3503 gtk_widget_real_map (GtkWidget *widget)
3505 g_return_if_fail (widget != NULL);
3506 g_return_if_fail (GTK_IS_WIDGET (widget));
3508 if (GTK_WIDGET_REALIZED (widget) && !GTK_WIDGET_MAPPED (widget))
3510 GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
3512 if (!GTK_WIDGET_NO_WINDOW (widget))
3513 gdk_window_show (widget->window);
3515 gtk_widget_queue_draw (widget);
3519 /*****************************************
3520 * gtk_widget_real_unmap:
3525 *****************************************/
3528 gtk_widget_real_unmap (GtkWidget *widget)
3530 g_return_if_fail (widget != NULL);
3531 g_return_if_fail (GTK_IS_WIDGET (widget));
3533 if (GTK_WIDGET_MAPPED (widget))
3535 GTK_WIDGET_UNSET_FLAGS (widget, GTK_MAPPED);
3537 if (GTK_WIDGET_NO_WINDOW (widget))
3538 gdk_window_clear_area (widget->window,
3539 widget->allocation.x,
3540 widget->allocation.y,
3541 widget->allocation.width,
3542 widget->allocation.height);
3544 gdk_window_hide (widget->window);
3548 /*****************************************
3549 * gtk_widget_real_realize:
3554 *****************************************/
3557 gtk_widget_real_realize (GtkWidget *widget)
3559 g_return_if_fail (widget != NULL);
3560 g_return_if_fail (GTK_IS_WIDGET (widget));
3561 g_return_if_fail (GTK_WIDGET_NO_WINDOW (widget));
3563 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
3566 widget->window = gtk_widget_get_parent_window (widget);
3567 gdk_window_ref (widget->window);
3569 widget->style = gtk_style_attach (widget->style, widget->window);
3572 /*****************************************
3573 * gtk_widget_real_unrealize:
3578 *****************************************/
3581 gtk_widget_real_unrealize (GtkWidget *widget)
3583 g_return_if_fail (widget != NULL);
3584 g_return_if_fail (GTK_IS_WIDGET (widget));
3586 if (GTK_WIDGET_NO_WINDOW (widget) && GTK_WIDGET_MAPPED (widget))
3587 gtk_widget_real_unmap (widget);
3589 GTK_WIDGET_UNSET_FLAGS (widget, GTK_REALIZED | GTK_MAPPED);
3591 /* printf ("unrealizing %s\n", gtk_type_name (GTK_OBJECT(widget)->klass->type));
3594 gtk_style_detach (widget->style);
3595 if (!GTK_WIDGET_NO_WINDOW (widget))
3597 gdk_window_set_user_data (widget->window, NULL);
3598 gdk_window_destroy (widget->window);
3602 gdk_window_unref (widget->window);
3605 /* Unrealize afterwards to improve visual effect */
3607 if (GTK_IS_CONTAINER (widget))
3608 gtk_container_foreach (GTK_CONTAINER (widget),
3609 (GtkCallback)gtk_widget_unrealize,
3612 widget->window = NULL;
3615 /*****************************************
3616 * gtk_widget_real_draw:
3621 *****************************************/
3624 gtk_widget_real_draw (GtkWidget *widget,
3627 GdkEventExpose event;
3629 g_return_if_fail (widget != NULL);
3630 g_return_if_fail (GTK_IS_WIDGET (widget));
3631 g_return_if_fail (area != NULL);
3633 if (GTK_WIDGET_DRAWABLE (widget))
3635 event.type = GDK_EXPOSE;
3636 event.send_event = TRUE;
3637 event.window = widget->window;
3641 gdk_window_ref (event.window);
3642 gtk_widget_event (widget, (GdkEvent*) &event);
3643 gdk_window_unref (event.window);
3647 /*****************************************
3648 * gtk_widget_real_queue_draw:
3653 *****************************************/
3656 gtk_widget_real_queue_draw (GtkWidget *widget)
3658 g_return_val_if_fail (widget != NULL, FALSE);
3659 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
3661 GTK_PRIVATE_UNSET_FLAG (widget, GTK_REDRAW_PENDING);
3662 gtk_widget_draw (widget, NULL);
3667 /*****************************************
3668 * gtk_widget_real_size_allocate:
3673 *****************************************/
3676 gtk_widget_real_size_allocate (GtkWidget *widget,
3677 GtkAllocation *allocation)
3679 g_return_if_fail (widget != NULL);
3680 g_return_if_fail (GTK_IS_WIDGET (widget));
3682 if (GTK_WIDGET_NO_WINDOW (widget) &&
3683 GTK_WIDGET_MAPPED (widget) &&
3684 ((widget->allocation.x != allocation->x) ||
3685 (widget->allocation.y != allocation->y) ||
3686 (widget->allocation.width != allocation->width) ||
3687 (widget->allocation.height != allocation->height)) &&
3688 (widget->allocation.width != 0) &&
3689 (widget->allocation.height != 0))
3690 gdk_window_clear_area (widget->window,
3691 widget->allocation.x,
3692 widget->allocation.y,
3693 widget->allocation.width,
3694 widget->allocation.height);
3696 widget->allocation = *allocation;
3698 if (GTK_WIDGET_REALIZED (widget) &&
3699 !GTK_WIDGET_NO_WINDOW (widget))
3700 gdk_window_move_resize (widget->window,
3701 allocation->x, allocation->y,
3702 allocation->width, allocation->height);
3705 /*****************************************
3706 * gtk_widget_peek_colormap:
3711 *****************************************/
3714 gtk_widget_peek_colormap ()
3717 return (GdkColormap*) colormap_stack->data;
3718 return gtk_widget_get_default_colormap ();
3721 /*****************************************
3722 * gtk_widget_peek_visual:
3727 *****************************************/
3730 gtk_widget_peek_visual ()
3733 return (GdkVisual*) visual_stack->data;
3734 return gtk_widget_get_default_visual ();
3737 /*************************************************************
3738 * gtk_widget_propagate_state:
3739 * Propagate a change in the widgets state down the tree
3743 * GtkStateData: state
3747 *************************************************************/
3750 gtk_widget_propagate_state (GtkWidget *widget,
3755 /* don't call this function with state=GTK_STATE_INSENSITIVE,
3756 * parent_sensitive=TRUE and a sensitive widget
3759 old_state = GTK_WIDGET_STATE (widget);
3761 if (data->parent_sensitive)
3763 GTK_WIDGET_SET_FLAGS (widget, GTK_PARENT_SENSITIVE);
3765 if (GTK_WIDGET_IS_SENSITIVE (widget))
3766 GTK_WIDGET_STATE (widget) = data->state;
3769 GTK_WIDGET_STATE (widget) = GTK_STATE_INSENSITIVE;
3770 if (data->state != GTK_STATE_INSENSITIVE)
3771 GTK_WIDGET_SAVED_STATE (widget) = data->state;
3776 GTK_WIDGET_UNSET_FLAGS (widget, GTK_PARENT_SENSITIVE);
3777 GTK_WIDGET_STATE (widget) = GTK_STATE_INSENSITIVE;
3778 if (data->state != GTK_STATE_INSENSITIVE)
3779 GTK_WIDGET_SAVED_STATE (widget) = data->state;
3782 if (GTK_WIDGET_HAS_FOCUS (widget) && !GTK_WIDGET_IS_SENSITIVE (widget))
3786 window = gtk_widget_get_ancestor (widget, gtk_window_get_type ());
3788 gtk_window_set_focus (GTK_WINDOW (window), NULL);
3791 if (old_state != GTK_WIDGET_STATE (widget))
3793 gtk_widget_ref (widget);
3794 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[STATE_CHANGED], old_state);
3796 if (GTK_IS_CONTAINER (widget))
3798 data->parent_sensitive = GTK_WIDGET_IS_SENSITIVE (widget);
3799 data->state = GTK_WIDGET_STATE (widget);
3800 gtk_container_foreach (GTK_CONTAINER (widget),
3801 (GtkCallback) gtk_widget_propagate_state,
3804 gtk_widget_unref (widget);
3808 /*****************************************
3809 * gtk_widget_draw_children_recurse:
3814 *****************************************/
3817 gtk_widget_draw_children_recurse (GtkWidget *widget,
3818 gpointer client_data)
3820 gtk_widget_draw (widget, NULL);
3821 gtk_widget_draw_children (widget);
3824 /*****************************************
3825 * gtk_widget_aux_info_new:
3830 *****************************************/
3832 static GtkWidgetAuxInfo*
3833 gtk_widget_aux_info_new ()
3835 GtkWidgetAuxInfo *aux_info;
3837 if (!aux_info_mem_chunk)
3838 aux_info_mem_chunk = g_mem_chunk_new ("widget aux info mem chunk",
3839 sizeof (GtkWidgetAuxInfo),
3840 1024, G_ALLOC_AND_FREE);
3842 aux_info = g_chunk_new (GtkWidgetAuxInfo, aux_info_mem_chunk);
3846 aux_info->width = 0;
3847 aux_info->height = 0;
3852 /*****************************************
3853 * gtk_widget_aux_info_destroy:
3858 *****************************************/
3861 gtk_widget_aux_info_destroy (GtkWidgetAuxInfo *aux_info)
3863 g_return_if_fail (aux_info != NULL);
3865 g_mem_chunk_free (aux_info_mem_chunk, aux_info);
3868 /*****************************************
3869 * gtk_widget_shape_combine_mask:
3870 * set a shape for this widgets' gdk window, this allows for
3871 * transparent windows etc., see gdk_window_shape_combine_mask
3872 * for more information
3877 *****************************************/
3879 gtk_widget_shape_combine_mask (GtkWidget *widget,
3880 GdkBitmap *shape_mask,
3884 GtkWidgetShapeInfo* shape_info;
3886 g_return_if_fail (widget != NULL);
3887 /* set_shape doesn't work on widgets without gdk window */
3888 g_return_if_fail (!GTK_WIDGET_NO_WINDOW (widget));
3892 GTK_PRIVATE_UNSET_FLAG (widget, GTK_HAS_SHAPE_MASK);
3895 gdk_window_shape_combine_mask (widget->window, NULL, 0, 0);
3897 shape_info = gtk_object_get_data (GTK_OBJECT (widget), shape_info_key);
3898 gtk_object_remove_data (GTK_OBJECT (widget), shape_info_key);
3899 g_free (shape_info);
3903 GTK_PRIVATE_SET_FLAG (widget, GTK_HAS_SHAPE_MASK);
3905 shape_info = gtk_object_get_data (GTK_OBJECT (widget), shape_info_key);
3908 shape_info = g_new (GtkWidgetShapeInfo, 1);
3909 gtk_object_set_data (GTK_OBJECT (widget), shape_info_key, shape_info);
3911 shape_info->shape_mask = shape_mask;
3912 shape_info->offset_x = offset_x;
3913 shape_info->offset_y = offset_y;
3915 /* set shape if widget has a gdk window allready.
3916 * otherwise the shape is scheduled to be set by gtk_widget_realize.
3919 gdk_window_shape_combine_mask (widget->window, shape_mask,
3920 offset_x, offset_y);
3924 /*****************************************
3925 * gtk_widget_dnd_drag_add:
3926 * when you get a DRAG_ENTER event, you can use this
3927 * to tell Gtk ofother widgets that are to be dragged as well
3932 *****************************************/
3934 gtk_widget_dnd_drag_add (GtkWidget *widget)
3938 /*****************************************
3939 * gtk_widget_dnd_drag_set:
3940 * these two functions enable drag and/or drop on a
3941 * widget and also let Gtk know what data types will be accepted
3942 * use MIME type naming,plus tacking "URL:" on the front for link
3949 *****************************************/
3951 gtk_widget_dnd_drag_set (GtkWidget *widget,
3953 gchar **type_accept_list,
3956 g_return_if_fail(widget != NULL);
3958 if (!widget->window)
3959 gtk_widget_realize (widget);
3961 g_return_if_fail (widget->window != NULL);
3962 gdk_window_dnd_drag_set (widget->window,
3968 /*****************************************
3969 * gtk_widget_dnd_drop_set:
3974 *****************************************/
3976 gtk_widget_dnd_drop_set (GtkWidget *widget,
3978 gchar **type_accept_list,
3980 guint8 is_destructive_operation)
3982 g_return_if_fail(widget != NULL);
3984 if (!widget->window)
3985 gtk_widget_realize (widget);
3987 g_return_if_fail (widget->window != NULL);
3988 gdk_window_dnd_drop_set (widget->window,
3992 is_destructive_operation);
3995 /*****************************************
3996 * gtk_widget_dnd_data_set:
4001 *****************************************/
4003 gtk_widget_dnd_data_set (GtkWidget *widget,
4006 gulong data_numbytes)
4008 g_return_if_fail (widget != NULL);
4009 g_return_if_fail (widget->window != NULL);
4011 gdk_window_dnd_data_set (widget->window, event, data, data_numbytes);
4015 #undef gtk_widget_ref
4016 #undef gtk_widget_unref
4020 gtk_widget_ref (GtkWidget *widget)
4022 volatile GtkObject *object;
4024 object = GTK_OBJECT (widget);
4025 gtk_object_ref (object);
4029 gtk_widget_unref (GtkWidget *widget)
4031 volatile GtkObject *object;
4033 object = GTK_OBJECT (widget);
4034 gtk_object_unref (object);