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,
79 DROP_DATA_AVAILABLE_EVENT,
106 typedef void (*GtkWidgetSignal1) (GtkObject *object,
109 typedef gint (*GtkWidgetSignal2) (GtkObject *object,
114 typedef void (*GtkWidgetSignal3) (GtkObject *object,
117 typedef gint (*GtkWidgetSignal4) (GtkObject *object,
120 typedef void (*GtkWidgetSignal5) (GtkObject *object,
123 typedef void (*GtkWidgetSignal6) (GtkObject *object,
126 typedef void (*GtkWidgetSignal7) (GtkObject *object,
130 typedef struct _GtkStateData GtkStateData;
135 gint parent_sensitive;
139 static void gtk_widget_marshal_signal_1 (GtkObject *object,
143 static void gtk_widget_marshal_signal_2 (GtkObject *object,
147 static void gtk_widget_marshal_signal_3 (GtkObject *object,
151 static void gtk_widget_marshal_signal_4 (GtkObject *object,
155 static void gtk_widget_marshal_signal_5 (GtkObject *object,
159 static void gtk_widget_marshal_signal_6 (GtkObject *object,
163 static void gtk_widget_marshal_signal_7 (GtkObject *object,
168 static void gtk_widget_class_init (GtkWidgetClass *klass);
169 static void gtk_widget_init (GtkWidget *widget);
170 static void gtk_widget_set_arg (GtkWidget *widget,
173 static void gtk_widget_get_arg (GtkWidget *widget,
176 static void gtk_widget_real_destroy (GtkObject *object);
177 static void gtk_widget_real_finalize (GtkObject *object);
178 static void gtk_widget_real_show (GtkWidget *widget);
179 static void gtk_widget_real_hide (GtkWidget *widget);
180 static void gtk_widget_real_map (GtkWidget *widget);
181 static void gtk_widget_real_unmap (GtkWidget *widget);
182 static void gtk_widget_real_realize (GtkWidget *widget);
183 static void gtk_widget_real_unrealize (GtkWidget *widget);
184 static void gtk_widget_real_draw (GtkWidget *widget,
186 static gint gtk_widget_real_queue_draw (GtkWidget *widget);
187 static void gtk_widget_real_size_allocate (GtkWidget *widget,
188 GtkAllocation *allocation);
189 static void gtk_widget_style_set (GtkWidget *widget,
190 GtkStyle *previous_style);
192 static GdkColormap* gtk_widget_peek_colormap (void);
193 static GdkVisual* gtk_widget_peek_visual (void);
194 static GtkStyle* gtk_widget_peek_style (void);
196 static void gtk_widget_reparent_container_child (GtkWidget *widget,
197 gpointer client_data);
198 static void gtk_widget_propagate_state (GtkWidget *widget,
200 static void gtk_widget_draw_children_recurse (GtkWidget *widget,
201 gpointer client_data);
202 static void gtk_widget_set_style_internal (GtkWidget *widget,
204 static void gtk_widget_set_style_recurse (GtkWidget *widget,
205 gpointer client_data);
207 extern GtkArg* gtk_object_collect_args (guint *nargs,
211 static GtkWidgetAuxInfo* gtk_widget_aux_info_new (void);
212 static void gtk_widget_aux_info_destroy (GtkWidgetAuxInfo *aux_info);
214 static GtkObjectClass *parent_class = NULL;
215 static gint widget_signals[LAST_SIGNAL] = { 0 };
217 static GMemChunk *aux_info_mem_chunk = NULL;
219 static GdkColormap *default_colormap = NULL;
220 static GdkVisual *default_visual = NULL;
221 static GtkStyle *default_style = NULL;
223 static GSList *colormap_stack = NULL;
224 static GSList *visual_stack = NULL;
225 static GSList *style_stack = NULL;
227 static GSList *gtk_widget_redraw_queue = NULL;
228 static GSList *gtk_widget_resize_queue = NULL;
230 static const gchar *aux_info_key = "gtk-aux-info";
231 static const gchar *colormap_key = "gtk-colormap";
232 static const gchar *visual_key = "gtk-visual";
233 static const gchar *event_key = "gtk-event-mask";
234 static const gchar *extension_event_key = "gtk-extension-event-mode";
235 static const gchar *parent_window_key = "gtk-parent-window";
236 static const gchar *shape_info_key = "gtk-shape-info";
237 static const gchar *saved_default_style = "gtk-saved-default-style";
241 /*****************************************
242 * gtk_widget_get_type:
247 *****************************************/
250 gtk_widget_get_type ()
252 static guint widget_type = 0;
256 GtkTypeInfo widget_info =
260 sizeof (GtkWidgetClass),
261 (GtkClassInitFunc) gtk_widget_class_init,
262 (GtkObjectInitFunc) gtk_widget_init,
263 (GtkArgSetFunc) gtk_widget_set_arg,
264 (GtkArgGetFunc) gtk_widget_get_arg,
267 widget_type = gtk_type_unique (gtk_object_get_type (), &widget_info);
273 /*****************************************
274 * gtk_widget_class_init:
279 *****************************************/
282 gtk_widget_class_init (GtkWidgetClass *klass)
284 GtkObjectClass *object_class;
286 object_class = (GtkObjectClass*) klass;
288 parent_class = gtk_type_class (gtk_object_get_type ());
290 gtk_object_add_arg_type ("GtkWidget::x", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_X);
291 gtk_object_add_arg_type ("GtkWidget::y", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_Y);
292 gtk_object_add_arg_type ("GtkWidget::width", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_WIDTH);
293 gtk_object_add_arg_type ("GtkWidget::height", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_HEIGHT);
294 gtk_object_add_arg_type ("GtkWidget::visible", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_VISIBLE);
295 gtk_object_add_arg_type ("GtkWidget::sensitive", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_SENSITIVE);
296 gtk_object_add_arg_type ("GtkWidget::can_focus", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_CAN_FOCUS);
297 gtk_object_add_arg_type ("GtkWidget::has_focus", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_HAS_FOCUS);
298 gtk_object_add_arg_type ("GtkWidget::can_default", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_CAN_DEFAULT);
299 gtk_object_add_arg_type ("GtkWidget::has_default", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_HAS_DEFAULT);
300 gtk_object_add_arg_type ("GtkWidget::events", GTK_TYPE_GDK_EVENT_MASK, GTK_ARG_READWRITE, ARG_EVENTS);
301 gtk_object_add_arg_type ("GtkWidget::extension_events", GTK_TYPE_GDK_EVENT_MASK, GTK_ARG_READWRITE, ARG_EXTENSION_EVENTS);
302 gtk_object_add_arg_type ("GtkWidget::name", GTK_TYPE_STRING, GTK_ARG_READWRITE, ARG_NAME);
303 gtk_object_add_arg_type ("GtkWidget::style", GTK_TYPE_STYLE, GTK_ARG_READWRITE, ARG_STYLE);
304 gtk_object_add_arg_type ("GtkWidget::parent", GTK_TYPE_CONTAINER, GTK_ARG_READWRITE, ARG_PARENT);
306 widget_signals[SHOW] =
307 gtk_signal_new ("show",
310 GTK_SIGNAL_OFFSET (GtkWidgetClass, show),
311 gtk_signal_default_marshaller,
313 widget_signals[HIDE] =
314 gtk_signal_new ("hide",
317 GTK_SIGNAL_OFFSET (GtkWidgetClass, hide),
318 gtk_signal_default_marshaller,
320 widget_signals[MAP] =
321 gtk_signal_new ("map",
324 GTK_SIGNAL_OFFSET (GtkWidgetClass, map),
325 gtk_signal_default_marshaller,
327 widget_signals[UNMAP] =
328 gtk_signal_new ("unmap",
331 GTK_SIGNAL_OFFSET (GtkWidgetClass, unmap),
332 gtk_signal_default_marshaller,
334 widget_signals[REALIZE] =
335 gtk_signal_new ("realize",
338 GTK_SIGNAL_OFFSET (GtkWidgetClass, realize),
339 gtk_signal_default_marshaller,
341 widget_signals[UNREALIZE] =
342 gtk_signal_new ("unrealize",
345 GTK_SIGNAL_OFFSET (GtkWidgetClass, unrealize),
346 gtk_signal_default_marshaller,
348 widget_signals[DRAW] =
349 gtk_signal_new ("draw",
352 GTK_SIGNAL_OFFSET (GtkWidgetClass, draw),
353 gtk_widget_marshal_signal_1,
356 widget_signals[DRAW_FOCUS] =
357 gtk_signal_new ("draw_focus",
360 GTK_SIGNAL_OFFSET (GtkWidgetClass, draw_focus),
361 gtk_signal_default_marshaller,
363 widget_signals[DRAW_DEFAULT] =
364 gtk_signal_new ("draw_default",
367 GTK_SIGNAL_OFFSET (GtkWidgetClass, draw_default),
368 gtk_signal_default_marshaller,
370 widget_signals[SIZE_REQUEST] =
371 gtk_signal_new ("size_request",
374 GTK_SIGNAL_OFFSET (GtkWidgetClass, size_request),
375 gtk_widget_marshal_signal_1,
378 widget_signals[SIZE_ALLOCATE] =
379 gtk_signal_new ("size_allocate",
382 GTK_SIGNAL_OFFSET (GtkWidgetClass, size_allocate),
383 gtk_widget_marshal_signal_1,
386 widget_signals[STATE_CHANGED] =
387 gtk_signal_new ("state_changed",
390 GTK_SIGNAL_OFFSET (GtkWidgetClass, state_changed),
391 gtk_widget_marshal_signal_5,
394 widget_signals[PARENT_SET] =
395 gtk_signal_new ("parent_set",
398 GTK_SIGNAL_OFFSET (GtkWidgetClass, parent_set),
399 gtk_widget_marshal_signal_6,
402 widget_signals[STYLE_SET] =
403 gtk_signal_new ("style_set",
406 GTK_SIGNAL_OFFSET (GtkWidgetClass, style_set),
407 gtk_widget_marshal_signal_7,
410 widget_signals[INSTALL_ACCELERATOR] =
411 gtk_signal_new ("install_accelerator",
414 GTK_SIGNAL_OFFSET (GtkWidgetClass, install_accelerator),
415 gtk_widget_marshal_signal_2,
420 widget_signals[REMOVE_ACCELERATOR] =
421 gtk_signal_new ("remove_accelerator",
424 GTK_SIGNAL_OFFSET (GtkWidgetClass, remove_accelerator),
425 gtk_widget_marshal_signal_3,
428 widget_signals[EVENT] =
429 gtk_signal_new ("event",
432 GTK_SIGNAL_OFFSET (GtkWidgetClass, event),
433 gtk_widget_marshal_signal_4,
436 widget_signals[BUTTON_PRESS_EVENT] =
437 gtk_signal_new ("button_press_event",
440 GTK_SIGNAL_OFFSET (GtkWidgetClass, button_press_event),
441 gtk_widget_marshal_signal_4,
444 widget_signals[BUTTON_RELEASE_EVENT] =
445 gtk_signal_new ("button_release_event",
448 GTK_SIGNAL_OFFSET (GtkWidgetClass, button_release_event),
449 gtk_widget_marshal_signal_4,
452 widget_signals[MOTION_NOTIFY_EVENT] =
453 gtk_signal_new ("motion_notify_event",
456 GTK_SIGNAL_OFFSET (GtkWidgetClass, motion_notify_event),
457 gtk_widget_marshal_signal_4,
460 widget_signals[DELETE_EVENT] =
461 gtk_signal_new ("delete_event",
464 GTK_SIGNAL_OFFSET (GtkWidgetClass, delete_event),
465 gtk_widget_marshal_signal_4,
468 widget_signals[DESTROY_EVENT] =
469 gtk_signal_new ("destroy_event",
472 GTK_SIGNAL_OFFSET (GtkWidgetClass, destroy_event),
473 gtk_widget_marshal_signal_4,
476 widget_signals[EXPOSE_EVENT] =
477 gtk_signal_new ("expose_event",
480 GTK_SIGNAL_OFFSET (GtkWidgetClass, expose_event),
481 gtk_widget_marshal_signal_4,
484 widget_signals[KEY_PRESS_EVENT] =
485 gtk_signal_new ("key_press_event",
488 GTK_SIGNAL_OFFSET (GtkWidgetClass, key_press_event),
489 gtk_widget_marshal_signal_4,
492 widget_signals[KEY_RELEASE_EVENT] =
493 gtk_signal_new ("key_release_event",
496 GTK_SIGNAL_OFFSET (GtkWidgetClass, key_release_event),
497 gtk_widget_marshal_signal_4,
500 widget_signals[ENTER_NOTIFY_EVENT] =
501 gtk_signal_new ("enter_notify_event",
504 GTK_SIGNAL_OFFSET (GtkWidgetClass, enter_notify_event),
505 gtk_widget_marshal_signal_4,
508 widget_signals[LEAVE_NOTIFY_EVENT] =
509 gtk_signal_new ("leave_notify_event",
512 GTK_SIGNAL_OFFSET (GtkWidgetClass, leave_notify_event),
513 gtk_widget_marshal_signal_4,
516 widget_signals[CONFIGURE_EVENT] =
517 gtk_signal_new ("configure_event",
520 GTK_SIGNAL_OFFSET (GtkWidgetClass, configure_event),
521 gtk_widget_marshal_signal_4,
524 widget_signals[FOCUS_IN_EVENT] =
525 gtk_signal_new ("focus_in_event",
528 GTK_SIGNAL_OFFSET (GtkWidgetClass, focus_in_event),
529 gtk_widget_marshal_signal_4,
532 widget_signals[FOCUS_OUT_EVENT] =
533 gtk_signal_new ("focus_out_event",
536 GTK_SIGNAL_OFFSET (GtkWidgetClass, focus_out_event),
537 gtk_widget_marshal_signal_4,
540 widget_signals[MAP_EVENT] =
541 gtk_signal_new ("map_event",
544 GTK_SIGNAL_OFFSET (GtkWidgetClass, map_event),
545 gtk_widget_marshal_signal_4,
548 widget_signals[UNMAP_EVENT] =
549 gtk_signal_new ("unmap_event",
552 GTK_SIGNAL_OFFSET (GtkWidgetClass, unmap_event),
553 gtk_widget_marshal_signal_4,
556 widget_signals[PROPERTY_NOTIFY_EVENT] =
557 gtk_signal_new ("property_notify_event",
560 GTK_SIGNAL_OFFSET (GtkWidgetClass, property_notify_event),
561 gtk_widget_marshal_signal_4,
564 widget_signals[SELECTION_CLEAR_EVENT] =
565 gtk_signal_new ("selection_clear_event",
568 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_clear_event),
569 gtk_widget_marshal_signal_4,
572 widget_signals[SELECTION_REQUEST_EVENT] =
573 gtk_signal_new ("selection_request_event",
576 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_request_event),
577 gtk_widget_marshal_signal_4,
580 widget_signals[SELECTION_NOTIFY_EVENT] =
581 gtk_signal_new ("selection_notify_event",
584 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_notify_event),
585 gtk_widget_marshal_signal_4,
588 widget_signals[SELECTION_RECEIVED] =
589 gtk_signal_new ("selection_received",
592 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_received),
593 gtk_widget_marshal_signal_1,
596 widget_signals[PROXIMITY_IN_EVENT] =
597 gtk_signal_new ("proximity_in_event",
600 GTK_SIGNAL_OFFSET (GtkWidgetClass, proximity_in_event),
601 gtk_widget_marshal_signal_4,
604 widget_signals[PROXIMITY_OUT_EVENT] =
605 gtk_signal_new ("proximity_out_event",
608 GTK_SIGNAL_OFFSET (GtkWidgetClass, proximity_out_event),
609 gtk_widget_marshal_signal_4,
612 widget_signals[DRAG_BEGIN_EVENT] =
613 gtk_signal_new ("drag_begin_event",
616 GTK_SIGNAL_OFFSET (GtkWidgetClass, drag_begin_event),
617 gtk_widget_marshal_signal_4,
620 widget_signals[DRAG_REQUEST_EVENT] =
621 gtk_signal_new ("drag_request_event",
624 GTK_SIGNAL_OFFSET (GtkWidgetClass, drag_request_event),
625 gtk_widget_marshal_signal_4,
628 widget_signals[DROP_ENTER_EVENT] =
629 gtk_signal_new ("drop_enter_event",
632 GTK_SIGNAL_OFFSET (GtkWidgetClass, drop_enter_event),
633 gtk_widget_marshal_signal_4,
636 widget_signals[DROP_LEAVE_EVENT] =
637 gtk_signal_new ("drop_leave_event",
640 GTK_SIGNAL_OFFSET (GtkWidgetClass, drop_leave_event),
641 gtk_widget_marshal_signal_4,
644 widget_signals[DROP_DATA_AVAILABLE_EVENT] =
645 gtk_signal_new ("drop_data_available_event",
648 GTK_SIGNAL_OFFSET (GtkWidgetClass,
649 drop_data_available_event),
650 gtk_widget_marshal_signal_4,
653 widget_signals[OTHER_EVENT] =
654 gtk_signal_new ("other_event",
657 GTK_SIGNAL_OFFSET (GtkWidgetClass, other_event),
658 gtk_widget_marshal_signal_4,
661 widget_signals[CLIENT_EVENT] =
662 gtk_signal_new ("client_event",
665 GTK_SIGNAL_OFFSET (GtkWidgetClass, client_event),
666 gtk_widget_marshal_signal_4,
669 widget_signals[NO_EXPOSE_EVENT] =
670 gtk_signal_new ("no_expose_event",
673 GTK_SIGNAL_OFFSET (GtkWidgetClass, no_expose_event),
674 gtk_widget_marshal_signal_4,
678 gtk_object_class_add_signals (object_class, widget_signals, LAST_SIGNAL);
680 object_class->destroy = gtk_widget_real_destroy;
681 object_class->finalize = gtk_widget_real_finalize;
683 klass->activate_signal = 0;
684 klass->show = gtk_widget_real_show;
685 klass->hide = gtk_widget_real_hide;
686 klass->show_all = gtk_widget_real_show;
687 klass->hide_all = gtk_widget_real_hide;
688 klass->map = gtk_widget_real_map;
689 klass->unmap = gtk_widget_real_unmap;
690 klass->realize = gtk_widget_real_realize;
691 klass->unrealize = gtk_widget_real_unrealize;
692 klass->draw = gtk_widget_real_draw;
693 klass->draw_focus = NULL;
694 klass->size_request = NULL;
695 klass->size_allocate = gtk_widget_real_size_allocate;
696 klass->state_changed = NULL;
697 klass->parent_set = NULL;
698 klass->style_set = gtk_widget_style_set;
699 klass->install_accelerator = NULL;
700 klass->remove_accelerator = NULL;
702 klass->button_press_event = NULL;
703 klass->button_release_event = NULL;
704 klass->motion_notify_event = NULL;
705 klass->delete_event = NULL;
706 klass->destroy_event = NULL;
707 klass->expose_event = NULL;
708 klass->key_press_event = NULL;
709 klass->key_release_event = NULL;
710 klass->enter_notify_event = NULL;
711 klass->leave_notify_event = NULL;
712 klass->configure_event = NULL;
713 klass->focus_in_event = NULL;
714 klass->focus_out_event = NULL;
715 klass->map_event = NULL;
716 klass->unmap_event = NULL;
717 klass->property_notify_event = gtk_selection_property_notify;
718 klass->selection_clear_event = gtk_selection_clear;
719 klass->selection_request_event = gtk_selection_request;
720 klass->selection_notify_event = gtk_selection_notify;
721 klass->selection_received = NULL;
722 klass->proximity_in_event = NULL;
723 klass->proximity_out_event = NULL;
724 klass->drag_begin_event = NULL;
725 klass->drag_request_event = NULL;
726 klass->drop_enter_event = NULL;
727 klass->drop_leave_event = NULL;
728 klass->drop_data_available_event = NULL;
729 klass->other_event = NULL;
730 klass->no_expose_event = NULL;
733 /*****************************************
734 * gtk_widget_set_arg:
739 *****************************************/
742 gtk_widget_set_arg (GtkWidget *widget,
749 gtk_widget_set_uposition (widget, GTK_VALUE_INT (*arg), -2);
752 gtk_widget_set_uposition (widget, -2, GTK_VALUE_INT (*arg));
755 gtk_widget_set_usize (widget, GTK_VALUE_INT (*arg), -1);
758 gtk_widget_set_usize (widget, -1, GTK_VALUE_INT (*arg));
761 if (GTK_VALUE_BOOL(*arg))
762 gtk_widget_show (widget);
764 gtk_widget_hide (widget);
767 gtk_widget_set_sensitive (widget, GTK_VALUE_BOOL (*arg));
770 if (GTK_VALUE_BOOL (*arg))
771 GTK_WIDGET_SET_FLAGS (widget, GTK_CAN_FOCUS);
773 GTK_WIDGET_UNSET_FLAGS (widget, GTK_CAN_FOCUS);
776 if (GTK_VALUE_BOOL (*arg))
777 gtk_widget_grab_focus (widget);
779 case ARG_CAN_DEFAULT:
780 if (GTK_VALUE_BOOL (*arg))
781 GTK_WIDGET_SET_FLAGS (widget, GTK_CAN_DEFAULT);
783 GTK_WIDGET_UNSET_FLAGS (widget, GTK_CAN_DEFAULT);
785 case ARG_HAS_DEFAULT:
786 if (GTK_VALUE_BOOL (*arg))
787 gtk_widget_grab_default (widget);
790 gtk_widget_set_events (widget, GTK_VALUE_FLAGS (*arg));
792 case ARG_EXTENSION_EVENTS:
793 gtk_widget_set_extension_events (widget, GTK_VALUE_FLAGS (*arg));
796 gtk_widget_set_name (widget, GTK_VALUE_STRING (*arg));
799 gtk_widget_set_style (widget, (GtkStyle*) GTK_VALUE_BOXED (*arg));
802 gtk_container_add (GTK_CONTAINER (GTK_VALUE_OBJECT (*arg)), widget);
805 arg->type = GTK_TYPE_INVALID;
810 /*****************************************
811 * gtk_widget_get_arg:
816 *****************************************/
819 gtk_widget_get_arg (GtkWidget *widget,
823 GtkWidgetAuxInfo *aux_info;
825 GdkExtensionMode *modep;
830 aux_info = gtk_object_get_data (GTK_OBJECT (widget), aux_info_key);
832 GTK_VALUE_INT (*arg) = -2;
834 GTK_VALUE_INT (*arg) = aux_info->x;
837 aux_info = gtk_object_get_data (GTK_OBJECT (widget), aux_info_key);
839 GTK_VALUE_INT (*arg) = -2;
841 GTK_VALUE_INT (*arg) = aux_info->y;
844 aux_info = gtk_object_get_data (GTK_OBJECT (widget), aux_info_key);
846 GTK_VALUE_INT (*arg) = -2;
848 GTK_VALUE_INT (*arg) = aux_info->width;
851 aux_info = gtk_object_get_data (GTK_OBJECT (widget), aux_info_key);
853 GTK_VALUE_INT (*arg) = -2;
855 GTK_VALUE_INT (*arg) = aux_info->height;
858 GTK_VALUE_BOOL (*arg) = GTK_WIDGET_VISIBLE (widget);
861 GTK_VALUE_BOOL (*arg) = GTK_WIDGET_SENSITIVE (widget);
864 GTK_VALUE_BOOL (*arg) = GTK_WIDGET_CAN_FOCUS (widget);
867 GTK_VALUE_BOOL (*arg) = GTK_WIDGET_HAS_FOCUS (widget);
869 case ARG_CAN_DEFAULT:
870 GTK_VALUE_BOOL (*arg) = GTK_WIDGET_CAN_DEFAULT (widget);
872 case ARG_HAS_DEFAULT:
873 GTK_VALUE_BOOL (*arg) = GTK_WIDGET_HAS_DEFAULT (widget);
876 eventp = gtk_object_get_data (GTK_OBJECT (widget), event_key);
878 GTK_VALUE_FLAGS (*arg) = 0;
880 GTK_VALUE_FLAGS (*arg) = *eventp;
882 case ARG_EXTENSION_EVENTS:
883 modep = gtk_object_get_data (GTK_OBJECT (widget), extension_event_key);
885 GTK_VALUE_FLAGS (*arg) = 0;
887 GTK_VALUE_FLAGS (*arg) = *modep;
891 GTK_VALUE_STRING (*arg) = g_strdup (widget->name);
893 GTK_VALUE_STRING (*arg) = g_strdup ("");
896 GTK_VALUE_BOXED (*arg) = (gpointer) gtk_widget_get_style (widget);
899 GTK_VALUE_OBJECT (*arg) = (GtkObject*) widget->parent;
902 arg->type = GTK_TYPE_INVALID;
907 /*****************************************
913 *****************************************/
916 gtk_widget_init (GtkWidget *widget)
918 GdkColormap *colormap;
921 GTK_PRIVATE_FLAGS (widget) = 0;
922 widget->state = GTK_STATE_NORMAL;
923 widget->saved_state = GTK_STATE_NORMAL;
925 widget->requisition.width = 0;
926 widget->requisition.height = 0;
927 widget->allocation.x = -1;
928 widget->allocation.y = -1;
929 widget->allocation.width = 1;
930 widget->allocation.height = 1;
931 widget->window = NULL;
932 widget->parent = NULL;
934 GTK_WIDGET_SET_FLAGS (widget, GTK_SENSITIVE | GTK_PARENT_SENSITIVE);
936 widget->style = gtk_widget_peek_style ();
937 gtk_style_ref (widget->style);
939 colormap = gtk_widget_peek_colormap ();
940 visual = gtk_widget_peek_visual ();
942 /* XXX - should we ref the colormap and visual, too? */
944 if (colormap != gtk_widget_get_default_colormap ())
946 /* gdk_colormap_ref (colormap); */
947 gtk_object_set_data (GTK_OBJECT (widget), colormap_key, colormap);
950 if (visual != gtk_widget_get_default_visual ())
952 /* gdk_visual_ref (visual); */
953 gtk_object_set_data (GTK_OBJECT (widget), visual_key, visual);
957 /*****************************************
963 *****************************************/
966 gtk_widget_new (guint type,
975 g_return_val_if_fail (gtk_type_is_a (type, gtk_widget_get_type ()), NULL);
977 obj = gtk_type_new (type);
979 va_start (args1, type);
980 va_start (args2, type);
982 args = gtk_object_collect_args (&nargs, args1, args2);
983 gtk_object_setv (obj, nargs, args);
989 return GTK_WIDGET (obj);
992 /*****************************************
998 *****************************************/
1001 gtk_widget_newv (guint type,
1005 g_return_val_if_fail (gtk_type_is_a (type, gtk_widget_get_type ()), NULL);
1007 return GTK_WIDGET (gtk_object_newv (type, nargs, args));
1010 /*****************************************
1016 *****************************************/
1019 gtk_widget_get (GtkWidget *widget,
1022 g_return_if_fail (widget != NULL);
1023 g_return_if_fail (arg != NULL);
1025 gtk_object_getv (GTK_OBJECT (widget), 1, arg);
1028 /*****************************************
1034 *****************************************/
1037 gtk_widget_getv (GtkWidget *widget,
1041 gtk_object_getv (GTK_OBJECT (widget), nargs, args);
1044 /*****************************************
1050 *****************************************/
1053 gtk_widget_set (GtkWidget *widget,
1061 g_return_if_fail (widget != NULL);
1063 va_start (args1, widget);
1064 va_start (args2, widget);
1066 args = gtk_object_collect_args (&nargs, args1, args2);
1067 gtk_object_setv (GTK_OBJECT (widget), nargs, args);
1074 /*****************************************
1080 *****************************************/
1083 gtk_widget_setv (GtkWidget *widget,
1087 gtk_object_setv (GTK_OBJECT (widget), nargs, args);
1090 /*****************************************
1091 * gtk_widget_unparent:
1092 * do any cleanup necessary necessary
1093 * for setting parent = NULL.
1098 *****************************************/
1101 gtk_widget_unparent (GtkWidget *widget)
1103 GtkWidget *toplevel;
1105 GtkWidget *old_parent;
1107 g_return_if_fail (widget != NULL);
1108 if (widget->parent == NULL)
1111 /* keep this function in sync with gtk_menu_detach()
1114 toplevel = gtk_widget_get_toplevel (widget);
1115 if (GTK_IS_WINDOW (toplevel))
1117 child = GTK_WINDOW (toplevel)->focus_widget;
1119 while (child && child != widget)
1120 child = child->parent;
1122 if (child == widget)
1123 gtk_window_set_focus (GTK_WINDOW (toplevel), NULL);
1126 if (GTK_WIDGET_RESIZE_NEEDED (widget))
1128 GTK_CONTAINER (toplevel)->resize_widgets =
1129 g_slist_remove (GTK_CONTAINER (toplevel)->resize_widgets, widget);
1130 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_NEEDED);
1133 if (widget->window &&
1134 GTK_WIDGET_NO_WINDOW (widget) &&
1135 GTK_WIDGET_DRAWABLE (widget))
1136 gdk_window_clear_area (widget->window,
1137 widget->allocation.x,
1138 widget->allocation.y,
1139 widget->allocation.width,
1140 widget->allocation.height);
1142 if (GTK_WIDGET_REALIZED (widget) && !GTK_WIDGET_IN_REPARENT (widget))
1143 gtk_widget_unrealize (widget);
1145 old_parent = widget->parent;
1146 widget->parent = NULL;
1147 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[PARENT_SET], old_parent);
1149 gtk_widget_unref (widget);
1152 /*****************************************
1153 * gtk_widget_destroy:
1158 *****************************************/
1161 gtk_widget_destroy (GtkWidget *widget)
1163 g_return_if_fail (widget != NULL);
1164 g_return_if_fail (GTK_IS_WIDGET (widget));
1166 GTK_WIDGET_UNSET_FLAGS (widget, GTK_VISIBLE);
1167 if (GTK_WIDGET_REALIZED (widget))
1168 gtk_widget_unrealize (widget);
1170 gtk_object_destroy (GTK_OBJECT (widget));
1173 /*****************************************
1174 * gtk_widget_destroyed:
1175 * Utility function: sets widget_pointer
1176 * to NULL when widget is destroyed.
1181 *****************************************/
1184 gtk_widget_destroyed (GtkWidget *widget,
1185 GtkWidget **widget_pointer)
1187 /* Don't make any assumptions about the
1189 * Even check widget_pointer.
1192 *widget_pointer = NULL;
1195 /*****************************************
1201 *****************************************/
1204 gtk_widget_show (GtkWidget *widget)
1206 g_return_if_fail (widget != NULL);
1208 if (!GTK_WIDGET_VISIBLE (widget))
1209 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[SHOW]);
1212 /*****************************************
1218 *****************************************/
1221 gtk_widget_hide (GtkWidget *widget)
1223 g_return_if_fail (widget != NULL);
1225 if (GTK_WIDGET_VISIBLE (widget))
1226 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[HIDE]);
1229 /*****************************************
1230 * gtk_widget_show_all:
1232 * Shows the widget and all children.
1234 * Container classes overwrite
1235 * show_all and hide_all to call
1236 * show_all (hide_all) on both themselves
1237 * and on their child widgets.
1242 *****************************************/
1245 gtk_widget_show_all (GtkWidget *widget)
1247 GtkWidgetClass *widget_class;
1249 g_return_if_fail (widget != NULL);
1251 /* show_all shouldn't be invoked through a signal,
1252 because in this case it would be quite slow - there would
1253 be a show and show_all signal emitted for every child widget.
1255 widget_class = GTK_WIDGET_CLASS(GTK_OBJECT(widget)->klass);
1256 widget_class->show_all (widget);
1259 /*****************************************
1260 * gtk_widget_hide_all:
1262 * Hides the widget and all children.
1263 * See gtk_widget_show_all.
1268 *****************************************/
1271 gtk_widget_hide_all (GtkWidget *widget)
1273 GtkWidgetClass *widget_class;
1275 g_return_if_fail (widget != NULL);
1276 g_assert (widget->parent);
1278 if (GTK_WIDGET_RESIZE_NEEDED (widget))
1280 GtkWidget *toplevel;
1282 toplevel = gtk_widget_get_toplevel (widget);
1283 if (toplevel != widget)
1284 GTK_CONTAINER (toplevel)->resize_widgets =
1285 g_slist_remove (GTK_CONTAINER (toplevel)->resize_widgets, widget);
1286 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_NEEDED);
1289 widget_class = GTK_WIDGET_CLASS(GTK_OBJECT(widget)->klass);
1290 widget_class->hide_all (widget);
1293 /*****************************************
1299 *****************************************/
1302 gtk_widget_map (GtkWidget *widget)
1304 g_return_if_fail (widget != NULL);
1306 if (!GTK_WIDGET_MAPPED (widget))
1308 if (!GTK_WIDGET_REALIZED (widget))
1309 gtk_widget_realize (widget);
1311 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[MAP]);
1315 /*****************************************
1321 *****************************************/
1324 gtk_widget_unmap (GtkWidget *widget)
1326 g_return_if_fail (widget != NULL);
1328 if (GTK_WIDGET_MAPPED (widget))
1329 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[UNMAP]);
1332 /*****************************************
1333 * gtk_widget_realize:
1338 *****************************************/
1341 gtk_widget_realize (GtkWidget *widget)
1344 GdkExtensionMode mode;
1345 GtkWidgetShapeInfo *shape_info;
1347 g_return_if_fail (widget != NULL);
1349 if (!GTK_WIDGET_REALIZED (widget))
1352 if (GTK_IS_CONTAINER (widget) && !GTK_WIDGET_NO_WINDOW (widget))
1353 g_print ("%s\n", gtk_type_name (GTK_WIDGET_TYPE (widget)));
1356 if (widget->parent && !GTK_WIDGET_REALIZED (widget->parent))
1357 gtk_widget_realize (widget->parent);
1359 gtk_widget_ensure_style (widget);
1361 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[REALIZE]);
1363 if (GTK_WIDGET_HAS_SHAPE_MASK (widget))
1365 shape_info = gtk_object_get_data (GTK_OBJECT (widget),
1367 gdk_window_shape_combine_mask (widget->window,
1368 shape_info->shape_mask,
1369 shape_info->offset_x,
1370 shape_info->offset_y);
1373 if (!GTK_WIDGET_NO_WINDOW (widget))
1375 mode = gtk_widget_get_extension_events (widget);
1376 if (mode != GDK_EXTENSION_EVENTS_NONE)
1378 events = gtk_widget_get_events (widget);
1379 gdk_input_set_extension_events (widget->window, events, mode);
1386 /*****************************************
1387 * gtk_widget_unrealize:
1392 *****************************************/
1395 gtk_widget_unrealize (GtkWidget *widget)
1397 g_return_if_fail (widget != NULL);
1399 if (GTK_WIDGET_REALIZED (widget))
1400 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[UNREALIZE]);
1403 /*****************************************
1404 * gtk_widget_queue_draw:
1409 *****************************************/
1412 gtk_widget_idle_draw (void *data)
1416 node = gtk_widget_redraw_queue;
1417 gtk_widget_redraw_queue = NULL;
1420 gtk_widget_real_queue_draw ((GtkWidget*) node->data);
1424 return gtk_widget_redraw_queue != NULL;
1428 gtk_widget_queue_draw (GtkWidget *widget)
1432 g_return_if_fail (widget != NULL);
1434 if (GTK_WIDGET_DRAWABLE (widget))
1436 /* We queue the redraw if:
1437 * a) the widget is not already queued for redraw and
1438 * b) non of the widgets ancestors are queued for redraw.
1443 if (GTK_WIDGET_REDRAW_PENDING (parent))
1445 parent = parent->parent;
1448 GTK_PRIVATE_SET_FLAG (widget, GTK_REDRAW_PENDING);
1449 if (gtk_widget_redraw_queue == NULL)
1450 gtk_idle_add_priority (GTK_PRIORITY_INTERNAL,
1451 (GtkFunction) gtk_widget_idle_draw, NULL);
1453 gtk_widget_redraw_queue = g_slist_prepend (gtk_widget_redraw_queue, widget);
1457 /*****************************************
1458 * gtk_widget_queue_resize:
1463 *****************************************/
1466 gtk_widget_idle_sizer (void *data)
1468 GSList *slist, *free_slist;
1470 free_slist = gtk_widget_resize_queue;
1471 gtk_widget_resize_queue = NULL;
1477 widget = slist->data;
1479 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_PENDING);
1480 if (gtk_container_need_resize (GTK_CONTAINER (widget)))
1481 gtk_widget_queue_resize (widget);
1483 slist = slist->next;
1485 g_slist_free (free_slist);
1487 return gtk_widget_resize_queue != NULL;
1491 gtk_widget_queue_resize (GtkWidget *widget)
1493 GtkWidget *toplevel;
1495 g_return_if_fail (widget != NULL);
1497 toplevel = gtk_widget_get_toplevel (widget);
1498 if (GTK_WIDGET_TOPLEVEL (toplevel))
1500 if (GTK_WIDGET_VISIBLE (toplevel))
1502 if (!GTK_CONTAINER_RESIZE_PENDING (toplevel))
1504 GTK_PRIVATE_SET_FLAG (toplevel, GTK_RESIZE_PENDING);
1505 if (gtk_widget_resize_queue == NULL)
1506 gtk_idle_add_priority (GTK_PRIORITY_INTERNAL,
1507 (GtkFunction) gtk_widget_idle_sizer, NULL);
1508 gtk_widget_resize_queue = g_slist_prepend (gtk_widget_resize_queue, toplevel);
1511 if (!GTK_WIDGET_RESIZE_NEEDED (widget))
1513 GTK_PRIVATE_SET_FLAG (widget, GTK_RESIZE_NEEDED);
1514 GTK_CONTAINER (toplevel)->resize_widgets =
1515 g_slist_prepend (GTK_CONTAINER (toplevel)->resize_widgets, widget);
1518 g_assert (g_slist_find (GTK_CONTAINER (toplevel)->resize_widgets, widget)); /* paranoid */
1521 gtk_container_need_resize (GTK_CONTAINER (toplevel));
1525 /*****************************************
1531 *****************************************/
1534 gtk_widget_draw (GtkWidget *widget,
1537 GdkRectangle temp_area;
1539 g_return_if_fail (widget != NULL);
1541 if (GTK_WIDGET_DRAWABLE (widget) &&
1542 !GTK_WIDGET_REDRAW_PENDING (widget))
1546 if (GTK_WIDGET_NO_WINDOW (widget))
1548 temp_area.x = widget->allocation.x;
1549 temp_area.y = widget->allocation.y;
1557 temp_area.width = widget->allocation.width;
1558 temp_area.height = widget->allocation.height;
1562 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[DRAW], area);
1566 /*****************************************
1567 * gtk_widget_draw_focus:
1572 *****************************************/
1575 gtk_widget_draw_focus (GtkWidget *widget)
1577 g_return_if_fail (widget != NULL);
1579 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[DRAW_FOCUS]);
1582 /*****************************************
1583 * gtk_widget_draw_default:
1588 *****************************************/
1591 gtk_widget_draw_default (GtkWidget *widget)
1593 g_return_if_fail (widget != NULL);
1595 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[DRAW_DEFAULT]);
1598 /*****************************************
1599 * gtk_widget_draw_children:
1604 *****************************************/
1607 gtk_widget_draw_children (GtkWidget *widget)
1609 g_return_if_fail (widget != NULL);
1611 if (GTK_IS_CONTAINER (widget))
1612 gtk_container_foreach (GTK_CONTAINER (widget),
1613 gtk_widget_draw_children_recurse,
1617 /*****************************************
1618 * gtk_widget_size_request:
1623 *****************************************/
1626 gtk_widget_size_request (GtkWidget *widget,
1627 GtkRequisition *requisition)
1629 GtkWidgetAuxInfo *aux_info;
1631 g_return_if_fail (widget != NULL);
1633 gtk_widget_ref (widget);
1634 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[SIZE_REQUEST],
1636 aux_info = gtk_object_get_data (GTK_OBJECT (widget), aux_info_key);
1639 if (aux_info->width > 0)
1640 requisition->width = aux_info->width;
1641 if (aux_info->height > 0)
1642 requisition->height = aux_info->height;
1644 gtk_widget_unref (widget);
1647 /*****************************************
1648 * gtk_widget_size_allocate:
1653 *****************************************/
1656 gtk_widget_size_allocate (GtkWidget *widget,
1657 GtkAllocation *allocation)
1659 GtkWidgetAuxInfo *aux_info;
1660 GtkAllocation real_allocation;
1662 g_return_if_fail (widget != NULL);
1664 real_allocation = *allocation;
1665 aux_info = gtk_object_get_data (GTK_OBJECT (widget), aux_info_key);
1669 if (aux_info->x != -1)
1670 real_allocation.x = aux_info->x;
1671 if (aux_info->y != -1)
1672 real_allocation.y = aux_info->y;
1675 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[SIZE_ALLOCATE], &real_allocation);
1678 /*****************************************
1679 * gtk_widget_install_accelerator:
1684 *****************************************/
1687 gtk_widget_install_accelerator (GtkWidget *widget,
1688 GtkAcceleratorTable *table,
1689 const gchar *signal_name,
1695 g_return_if_fail (widget != NULL);
1697 gtk_widget_ref (widget);
1699 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[INSTALL_ACCELERATOR],
1700 signal_name, key, modifiers, &return_val);
1702 gtk_accelerator_table_install (table,
1703 GTK_OBJECT (widget),
1707 gtk_widget_unref (widget);
1710 /*****************************************
1711 * gtk_widget_remove_accelerator:
1716 *****************************************/
1719 gtk_widget_remove_accelerator (GtkWidget *widget,
1720 GtkAcceleratorTable *table,
1721 const gchar *signal_name)
1723 g_return_if_fail (widget != NULL);
1725 gtk_widget_ref (widget);
1726 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[REMOVE_ACCELERATOR],
1728 gtk_accelerator_table_remove (table, GTK_OBJECT (widget), signal_name);
1729 gtk_widget_unref (widget);
1732 /*****************************************
1738 *****************************************/
1741 gtk_widget_event (GtkWidget *widget,
1747 g_return_val_if_fail (widget != NULL, TRUE);
1749 gtk_widget_ref (widget);
1751 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[EVENT], event,
1753 if (return_val || GTK_OBJECT_DESTROYED (widget))
1755 gtk_widget_unref (widget);
1759 switch (event->type)
1764 case GDK_BUTTON_PRESS:
1765 case GDK_2BUTTON_PRESS:
1766 case GDK_3BUTTON_PRESS:
1767 signal_num = BUTTON_PRESS_EVENT;
1769 case GDK_BUTTON_RELEASE:
1770 signal_num = BUTTON_RELEASE_EVENT;
1772 case GDK_MOTION_NOTIFY:
1773 signal_num = MOTION_NOTIFY_EVENT;
1776 signal_num = DELETE_EVENT;
1779 signal_num = DESTROY_EVENT;
1782 signal_num = KEY_PRESS_EVENT;
1784 case GDK_KEY_RELEASE:
1785 signal_num = KEY_RELEASE_EVENT;
1787 case GDK_ENTER_NOTIFY:
1788 signal_num = ENTER_NOTIFY_EVENT;
1790 case GDK_LEAVE_NOTIFY:
1791 signal_num = LEAVE_NOTIFY_EVENT;
1793 case GDK_FOCUS_CHANGE:
1794 if (event->focus_change.in)
1795 signal_num = FOCUS_IN_EVENT;
1797 signal_num = FOCUS_OUT_EVENT;
1800 signal_num = CONFIGURE_EVENT;
1803 signal_num = MAP_EVENT;
1806 signal_num = UNMAP_EVENT;
1808 case GDK_PROPERTY_NOTIFY:
1809 signal_num = PROPERTY_NOTIFY_EVENT;
1811 case GDK_SELECTION_CLEAR:
1812 signal_num = SELECTION_CLEAR_EVENT;
1814 case GDK_SELECTION_REQUEST:
1815 signal_num = SELECTION_REQUEST_EVENT;
1817 case GDK_SELECTION_NOTIFY:
1818 signal_num = SELECTION_NOTIFY_EVENT;
1820 case GDK_PROXIMITY_IN:
1821 signal_num = PROXIMITY_IN_EVENT;
1823 case GDK_PROXIMITY_OUT:
1824 signal_num = PROXIMITY_OUT_EVENT;
1826 case GDK_DRAG_BEGIN:
1827 signal_num = DRAG_BEGIN_EVENT;
1829 case GDK_DRAG_REQUEST:
1830 signal_num = DRAG_REQUEST_EVENT;
1832 case GDK_DROP_ENTER:
1833 signal_num = DROP_ENTER_EVENT;
1835 case GDK_DROP_LEAVE:
1836 signal_num = DROP_LEAVE_EVENT;
1838 case GDK_DROP_DATA_AVAIL:
1839 signal_num = DROP_DATA_AVAILABLE_EVENT;
1841 case GDK_OTHER_EVENT:
1842 signal_num = OTHER_EVENT;
1845 signal_num = NO_EXPOSE_EVENT;
1847 case GDK_CLIENT_EVENT:
1848 signal_num = CLIENT_EVENT;
1851 /* there is no sense in providing a widget with bogus expose events
1853 if (!event->any.window)
1855 gtk_widget_unref (widget);
1858 signal_num = EXPOSE_EVENT;
1861 g_warning ("could not determine signal number for event: %d", event->type);
1862 gtk_widget_unref (widget);
1866 if (signal_num != -1)
1867 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[signal_num], event, &return_val);
1869 return_val |= GTK_OBJECT_DESTROYED (widget);
1871 gtk_widget_unref (widget);
1876 /*****************************************
1877 * gtk_widget_activate:
1882 *****************************************/
1885 gtk_widget_activate (GtkWidget *widget)
1887 g_return_if_fail (widget != NULL);
1888 g_return_if_fail (GTK_IS_WIDGET (widget));
1890 if (WIDGET_CLASS (widget)->activate_signal)
1891 gtk_signal_emit (GTK_OBJECT (widget), WIDGET_CLASS (widget)->activate_signal);
1894 /*****************************************
1895 * gtk_widget_reparent_container_child:
1896 * assistent function to gtk_widget_reparent
1901 *****************************************/
1904 gtk_widget_reparent_container_child(GtkWidget *widget,
1905 gpointer client_data)
1907 g_return_if_fail (widget != NULL);
1908 g_return_if_fail (client_data != NULL);
1910 if (GTK_WIDGET_NO_WINDOW (widget))
1913 gdk_window_unref (widget->window);
1914 widget->window = (GdkWindow*) client_data;
1916 gdk_window_ref (widget->window);
1918 if (GTK_IS_CONTAINER (widget))
1919 gtk_container_foreach (GTK_CONTAINER (widget),
1920 gtk_widget_reparent_container_child,
1924 gdk_window_reparent (widget->window,
1925 (GdkWindow*) client_data, 0, 0);
1928 /*****************************************
1929 * gtk_widget_reparent:
1934 *****************************************/
1937 gtk_widget_reparent (GtkWidget *widget,
1938 GtkWidget *new_parent)
1940 g_return_if_fail (widget != NULL);
1941 g_return_if_fail (GTK_IS_WIDGET (widget));
1942 g_return_if_fail (new_parent != NULL);
1943 g_return_if_fail (GTK_IS_CONTAINER (new_parent));
1944 g_return_if_fail (widget->parent != NULL);
1946 if (widget->parent != new_parent)
1948 /* First try to see if we can get away without unrealizing
1949 * the widget as we reparent it. if so we set a flag so
1950 * that gtk_widget_unparent doesn't unrealize widget
1952 if (GTK_WIDGET_REALIZED (widget) && GTK_WIDGET_REALIZED (new_parent))
1953 GTK_PRIVATE_SET_FLAG (widget, GTK_IN_REPARENT);
1955 gtk_widget_ref (widget);
1956 gtk_container_remove (GTK_CONTAINER (widget->parent), widget);
1957 gtk_container_add (GTK_CONTAINER (new_parent), widget);
1958 gtk_widget_unref (widget);
1960 if (GTK_WIDGET_IN_REPARENT (widget))
1962 GTK_PRIVATE_UNSET_FLAG (widget, GTK_IN_REPARENT);
1964 /* OK, now fix up the widget's window. (And that for any
1965 * children, if the widget is NO_WINDOW and a container)
1967 if (GTK_WIDGET_NO_WINDOW (widget))
1969 if (GTK_IS_CONTAINER (widget))
1970 gtk_container_foreach (GTK_CONTAINER (widget),
1971 gtk_widget_reparent_container_child,
1972 gtk_widget_get_parent_window (widget));
1975 GdkWindow *parent_window;
1977 parent_window = gtk_widget_get_parent_window (widget);
1978 if (parent_window != widget->window)
1981 gdk_window_unref (widget->window);
1982 widget->window = parent_window;
1984 gdk_window_ref (widget->window);
1989 gdk_window_reparent (widget->window, gtk_widget_get_parent_window (widget), 0, 0);
1994 /*****************************************
2000 *****************************************/
2003 gtk_widget_popup (GtkWidget *widget,
2007 g_return_if_fail (widget != NULL);
2009 if (!GTK_WIDGET_VISIBLE (widget))
2011 if (!GTK_WIDGET_REALIZED (widget))
2012 gtk_widget_realize (widget);
2013 if (!GTK_WIDGET_NO_WINDOW (widget))
2014 gdk_window_move (widget->window, x, y);
2015 gtk_widget_show (widget);
2019 /*****************************************
2020 * gtk_widget_intersect:
2025 *****************************************/
2028 gtk_widget_intersect (GtkWidget *widget,
2030 GdkRectangle *intersection)
2036 g_return_val_if_fail (widget != NULL, FALSE);
2037 g_return_val_if_fail (area != NULL, FALSE);
2040 dest = intersection;
2044 return_val = gdk_rectangle_intersect ((GdkRectangle*) &widget->allocation, area, dest);
2046 if (return_val && intersection && !GTK_WIDGET_NO_WINDOW (widget))
2048 intersection->x -= widget->allocation.x;
2049 intersection->y -= widget->allocation.y;
2057 gtk_widget_basic (GtkWidget *widget)
2063 g_return_val_if_fail (widget != NULL, FALSE);
2065 if (!GTK_WIDGET_BASIC (widget))
2067 else if (GTK_IS_CONTAINER (widget))
2069 children = gtk_container_children (GTK_CONTAINER (widget));
2073 tmp_list = children;
2077 if (!gtk_widget_basic (GTK_WIDGET (tmp_list->data)))
2083 tmp_list = tmp_list->next;
2086 g_list_free (children);
2095 /*****************************************
2096 * gtk_widget_grab_focus:
2101 *****************************************/
2104 gtk_widget_grab_focus (GtkWidget *widget)
2110 g_return_if_fail (widget != NULL);
2112 window_type = gtk_window_get_type ();
2113 window = widget->parent;
2116 while (window && !gtk_type_is_a (GTK_WIDGET_TYPE (window), window_type))
2118 GTK_CONTAINER (window)->focus_child = child;
2120 window = window->parent;
2123 if (window && gtk_type_is_a (GTK_WIDGET_TYPE (window), window_type))
2125 GTK_CONTAINER (window)->focus_child = child;
2126 gtk_window_set_focus (GTK_WINDOW (window), widget);
2130 /*****************************************
2131 * gtk_widget_grab_default:
2136 *****************************************/
2139 gtk_widget_grab_default (GtkWidget *widget)
2144 g_return_if_fail (widget != NULL);
2145 g_return_if_fail (GTK_WIDGET_CAN_DEFAULT (widget));
2147 window_type = gtk_window_get_type ();
2148 window = widget->parent;
2150 while (window && !gtk_type_is_a (GTK_WIDGET_TYPE (window), window_type))
2151 window = window->parent;
2153 if (window && gtk_type_is_a (GTK_WIDGET_TYPE (window), window_type))
2154 gtk_window_set_default (GTK_WINDOW (window), widget);
2157 /*****************************************
2158 * gtk_widget_set_name:
2163 *****************************************/
2166 gtk_widget_set_name (GtkWidget *widget,
2169 g_return_if_fail (widget != NULL);
2172 g_free (widget->name);
2173 widget->name = g_strdup (name);
2175 if (!GTK_WIDGET_USER_STYLE (widget))
2176 gtk_widget_set_rc_style (widget);
2179 /*****************************************
2180 * gtk_widget_get_name:
2185 *****************************************/
2188 gtk_widget_get_name (GtkWidget *widget)
2190 g_return_val_if_fail (widget != NULL, NULL);
2193 return widget->name;
2194 return gtk_type_name (GTK_WIDGET_TYPE (widget));
2197 /*****************************************
2198 * gtk_widget_set_state:
2205 *****************************************/
2208 gtk_widget_set_state (GtkWidget *widget,
2211 g_return_if_fail (widget != NULL);
2213 if (state == GTK_WIDGET_STATE (widget))
2216 if (state == GTK_STATE_INSENSITIVE)
2217 gtk_widget_set_sensitive (widget, FALSE);
2221 GtkStateType old_state;
2225 data.parent_sensitive = GTK_WIDGET_IS_SENSITIVE (widget->parent);
2227 data.parent_sensitive = GTK_PARENT_SENSITIVE;
2229 old_state = GTK_WIDGET_STATE (widget);
2231 gtk_widget_propagate_state (widget, &data);
2232 if (old_state != GTK_WIDGET_STATE (widget))
2233 gtk_widget_queue_draw (widget);
2237 /*****************************************
2238 * gtk_widget_set_sensitive:
2242 * boolean value for sensitivity
2245 *****************************************/
2248 gtk_widget_set_sensitive (GtkWidget *widget,
2252 GtkStateType old_state;
2254 g_return_if_fail (widget != NULL);
2258 GTK_WIDGET_SET_FLAGS (widget, GTK_SENSITIVE);
2259 if (GTK_WIDGET_STATE (widget) == GTK_STATE_INSENSITIVE)
2260 data.state = GTK_WIDGET_SAVED_STATE (widget);
2262 data.state = GTK_WIDGET_STATE (widget);
2266 GTK_WIDGET_UNSET_FLAGS (widget, GTK_SENSITIVE);
2267 data.state = GTK_WIDGET_STATE (widget);
2271 data.parent_sensitive = GTK_WIDGET_IS_SENSITIVE (widget->parent);
2273 data.parent_sensitive = GTK_PARENT_SENSITIVE;
2275 old_state = GTK_WIDGET_STATE (widget);
2276 gtk_widget_propagate_state (widget, &data);
2277 if (old_state != GTK_WIDGET_STATE (widget))
2278 gtk_widget_queue_draw (widget);
2281 /*****************************************
2282 * gtk_widget_set_parent:
2287 *****************************************/
2290 gtk_widget_set_parent (GtkWidget *widget,
2295 g_return_if_fail (widget != NULL);
2296 g_return_if_fail (widget->parent == NULL);
2297 g_return_if_fail (!GTK_WIDGET_TOPLEVEL (widget));
2298 g_return_if_fail (parent != NULL);
2300 /* keep this function in sync with gtk_menu_attach_to_widget()
2303 gtk_widget_ref (widget);
2304 gtk_object_sink (GTK_OBJECT (widget));
2305 widget->parent = parent;
2307 if (GTK_WIDGET_STATE (parent) != GTK_STATE_NORMAL)
2308 data.state = GTK_WIDGET_STATE (parent);
2310 data.state = GTK_WIDGET_STATE (widget);
2311 data.parent_sensitive = GTK_WIDGET_IS_SENSITIVE (parent);
2313 gtk_widget_propagate_state (widget, &data);
2315 while (parent->parent != NULL)
2316 parent = parent->parent;
2318 if (GTK_WIDGET_TOPLEVEL (parent))
2320 gtk_widget_ensure_style (widget);
2322 if (GTK_IS_CONTAINER (widget))
2323 gtk_container_foreach (GTK_CONTAINER (widget),
2324 gtk_widget_set_style_recurse,
2328 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[PARENT_SET], NULL);
2331 /*****************************************
2333 * see docs/styles.txt
2334 *****************************************/
2336 gtk_widget_set_style (GtkWidget *widget,
2339 GtkStyle *default_style;
2341 g_return_if_fail (widget != NULL);
2342 g_return_if_fail (style != NULL);
2344 GTK_WIDGET_UNSET_FLAGS (widget, GTK_RC_STYLE);
2345 GTK_PRIVATE_SET_FLAG (widget, GTK_USER_STYLE);
2347 default_style = gtk_object_get_data (GTK_OBJECT (widget), saved_default_style);
2350 gtk_style_ref (widget->style);
2351 gtk_object_set_data (GTK_OBJECT (widget), saved_default_style, widget->style);
2354 gtk_widget_set_style_internal (widget, style);
2358 gtk_widget_ensure_style (GtkWidget *widget)
2360 if (!GTK_WIDGET_USER_STYLE (widget) &&
2361 !GTK_WIDGET_RC_STYLE (widget))
2362 gtk_widget_set_rc_style (widget);
2366 gtk_widget_set_rc_style (GtkWidget *widget)
2368 GtkStyle *saved_style;
2369 GtkStyle *new_style;
2371 g_return_if_fail (widget != NULL);
2373 GTK_PRIVATE_UNSET_FLAG (widget, GTK_USER_STYLE);
2374 GTK_WIDGET_SET_FLAGS (widget, GTK_RC_STYLE);
2376 saved_style = gtk_object_get_data (GTK_OBJECT (widget), saved_default_style);
2377 new_style = gtk_rc_get_style (widget);
2382 gtk_style_ref (widget->style);
2383 gtk_object_set_data (GTK_OBJECT (widget), saved_default_style, widget->style);
2385 gtk_widget_set_style_internal (widget, new_style);
2391 gtk_object_remove_data (GTK_OBJECT (widget), saved_default_style);
2392 gtk_widget_set_style_internal (widget, saved_style);
2393 gtk_style_unref (saved_style);
2399 gtk_widget_get_style (GtkWidget *widget)
2401 g_return_val_if_fail (widget != NULL, NULL);
2403 return widget->style;
2407 gtk_widget_style_set (GtkWidget *widget,
2408 GtkStyle *previous_style)
2410 if (GTK_WIDGET_REALIZED (widget) &&
2411 !GTK_WIDGET_NO_WINDOW (widget))
2412 gtk_style_set_background (widget->style, widget->window, widget->state);
2416 gtk_widget_set_style_internal (GtkWidget *widget,
2419 g_return_if_fail (widget != NULL);
2420 g_return_if_fail (style != NULL);
2422 if (widget->style != style)
2424 GtkStyle *previous_style;
2426 if (GTK_WIDGET_REALIZED (widget))
2427 gtk_style_detach (widget->style);
2429 previous_style = widget->style;
2430 widget->style = style;
2431 gtk_style_ref (widget->style);
2433 if (GTK_WIDGET_REALIZED (widget))
2434 widget->style = gtk_style_attach (widget->style, widget->window);
2436 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[STYLE_SET], previous_style);
2437 gtk_style_unref (previous_style);
2441 GtkRequisition old_requisition;
2443 old_requisition = widget->requisition;
2444 gtk_widget_size_request (widget, &widget->requisition);
2446 if ((old_requisition.width != widget->requisition.width) ||
2447 (old_requisition.height != widget->requisition.height))
2448 gtk_widget_queue_resize (widget);
2449 else if (GTK_WIDGET_DRAWABLE (widget))
2450 gtk_widget_queue_draw (widget);
2456 gtk_widget_set_style_recurse (GtkWidget *widget,
2457 gpointer client_data)
2459 if (!GTK_WIDGET_USER_STYLE (widget))
2460 gtk_widget_set_rc_style (widget);
2462 if (GTK_IS_CONTAINER (widget))
2463 gtk_container_foreach (GTK_CONTAINER (widget),
2464 gtk_widget_set_style_recurse,
2469 gtk_widget_set_default_style (GtkStyle *style)
2471 if (style != default_style)
2474 gtk_style_unref (default_style);
2475 default_style = style;
2477 gtk_style_ref (default_style);
2482 gtk_widget_get_default_style ()
2486 default_style = gtk_style_new ();
2487 gtk_style_ref (default_style);
2490 return default_style;
2494 gtk_widget_push_style (GtkStyle *style)
2496 g_return_if_fail (style != NULL);
2498 gtk_style_ref (style);
2499 style_stack = g_slist_prepend (style_stack, style);
2503 gtk_widget_peek_style ()
2506 return (GtkStyle*) style_stack->data;
2508 return gtk_widget_get_default_style ();
2512 gtk_widget_pop_style ()
2519 style_stack = style_stack->next;
2520 gtk_style_unref ((GtkStyle*) tmp->data);
2521 g_slist_free_1 (tmp);
2525 /* Basically, send a message to all toplevel windows telling them
2526 * that a new _GTK_STYLE_COLORS property is available on the root
2530 gtk_widget_propagate_default_style (void)
2535 /* Set the property on the root window */
2536 gdk_property_change(GDK_ROOT_PARENT(),
2537 gdk_atom_intern("_GTK_DEFAULT_COLORS", FALSE),
2538 gdk_atom_intern("STRING", FALSE),
2540 GDK_PROP_MODE_REPLACE,
2541 (guchar *)gtk_widget_get_default_style(),
2542 GTK_STYLE_NUM_STYLECOLORS() * sizeof(GdkColor));
2544 for(i = 0; i < 5; i++)
2546 sev.data_format = 32;
2547 sev.message_type = gdk_atom_intern ("_GTK_STYLE_CHANGED", FALSE);
2548 gdk_event_send_clientmessage_toall ((GdkEvent *) &sev);
2551 /*************************************************************
2552 * gtk_widget_set_parent_window:
2553 * Set a non default parent window for widget
2560 *************************************************************/
2563 gtk_widget_set_parent_window (GtkWidget *widget,
2564 GdkWindow *parent_window)
2566 GdkWindow *old_parent_window;
2568 g_return_if_fail (widget != NULL);
2570 old_parent_window = gtk_object_get_data (GTK_OBJECT (widget),
2573 if (parent_window != old_parent_window)
2575 gtk_object_set_data (GTK_OBJECT (widget), parent_window_key,
2577 if (old_parent_window)
2578 gdk_window_unref (old_parent_window);
2580 gdk_window_ref (parent_window);
2584 /*************************************************************
2585 * gtk_widget_get_parent_window:
2586 * Get widget's parent window
2593 *************************************************************/
2596 gtk_widget_get_parent_window (GtkWidget *widget)
2598 GdkWindow *parent_window;
2600 g_return_val_if_fail (widget != NULL, NULL);
2601 g_return_val_if_fail (GTK_IS_WIDGET (widget), NULL);
2602 g_return_val_if_fail (widget->parent != NULL, NULL);
2604 parent_window = gtk_object_get_data (GTK_OBJECT (widget),
2607 return (parent_window != NULL) ? parent_window : widget->parent->window;
2610 /*****************************************
2611 * gtk_widget_set_uposition:
2616 *****************************************/
2619 gtk_widget_set_uposition (GtkWidget *widget,
2623 GtkWidgetAuxInfo *aux_info;
2625 g_return_if_fail (widget != NULL);
2627 aux_info = gtk_object_get_data (GTK_OBJECT (widget), aux_info_key);
2630 aux_info = gtk_widget_aux_info_new ();
2631 gtk_object_set_data (GTK_OBJECT (widget), aux_info_key, aux_info);
2639 if (GTK_WIDGET_REALIZED (widget) && GTK_IS_WINDOW (widget) &&
2640 (aux_info->x != -1) && (aux_info->y != -1))
2642 gdk_window_set_hints (widget->window, aux_info->x, aux_info->y, 0, 0, 0, 0, GDK_HINT_POS);
2643 gdk_window_move (widget->window, aux_info->x, aux_info->y);
2646 if (GTK_WIDGET_VISIBLE (widget) && widget->parent)
2647 gtk_widget_size_allocate (widget, &widget->allocation);
2650 /*****************************************
2651 * gtk_widget_set_usize:
2656 *****************************************/
2659 gtk_widget_set_usize (GtkWidget *widget,
2663 GtkWidgetAuxInfo *aux_info;
2665 g_return_if_fail (widget != NULL);
2667 aux_info = gtk_object_get_data (GTK_OBJECT (widget), aux_info_key);
2670 aux_info = gtk_widget_aux_info_new ();
2671 gtk_object_set_data (GTK_OBJECT (widget), aux_info_key, aux_info);
2675 aux_info->width = width;
2677 aux_info->height = height;
2679 if (GTK_WIDGET_VISIBLE (widget))
2680 gtk_widget_queue_resize (widget);
2683 /*****************************************
2684 * gtk_widget_set_events:
2689 *****************************************/
2692 gtk_widget_set_events (GtkWidget *widget,
2697 g_return_if_fail (widget != NULL);
2698 g_return_if_fail (!GTK_WIDGET_NO_WINDOW (widget));
2699 g_return_if_fail (!GTK_WIDGET_REALIZED (widget));
2701 eventp = gtk_object_get_data (GTK_OBJECT (widget), event_key);
2706 eventp = g_new (gint, 1);
2709 gtk_object_set_data (GTK_OBJECT (widget), event_key, eventp);
2716 gtk_object_remove_data (GTK_OBJECT (widget), event_key);
2720 /*****************************************
2721 * gtk_widget_set_extension_events:
2726 *****************************************/
2729 gtk_widget_set_extension_events (GtkWidget *widget,
2730 GdkExtensionMode mode)
2732 GdkExtensionMode *modep;
2734 g_return_if_fail (widget != NULL);
2736 modep = gtk_object_get_data (GTK_OBJECT (widget), extension_event_key);
2739 modep = g_new (GdkExtensionMode, 1);
2742 gtk_object_set_data (GTK_OBJECT (widget), extension_event_key, modep);
2746 /*****************************************
2747 * gtk_widget_get_toplevel:
2752 *****************************************/
2755 gtk_widget_get_toplevel (GtkWidget *widget)
2757 g_return_val_if_fail (widget != NULL, NULL);
2759 while (widget->parent)
2760 widget = widget->parent;
2765 /*****************************************
2766 * gtk_widget_get_ancestor:
2771 *****************************************/
2774 gtk_widget_get_ancestor (GtkWidget *widget,
2777 g_return_val_if_fail (widget != NULL, NULL);
2779 while (widget && !gtk_type_is_a (GTK_WIDGET_TYPE (widget), type))
2780 widget = widget->parent;
2782 if (!(widget && gtk_type_is_a (GTK_WIDGET_TYPE (widget), type)))
2788 /*****************************************
2789 * gtk_widget_get_colormap:
2794 *****************************************/
2797 gtk_widget_get_colormap (GtkWidget *widget)
2799 GdkColormap *colormap;
2801 g_return_val_if_fail (widget != NULL, NULL);
2803 if (!widget->window)
2805 colormap = gtk_object_get_data (GTK_OBJECT (widget), colormap_key);
2808 return gtk_widget_get_default_colormap ();
2811 return gdk_window_get_colormap (widget->window);
2814 /*****************************************
2815 * gtk_widget_get_visual:
2820 *****************************************/
2823 gtk_widget_get_visual (GtkWidget *widget)
2827 g_return_val_if_fail (widget != NULL, NULL);
2829 if (!widget->window)
2831 visual = gtk_object_get_data (GTK_OBJECT (widget), visual_key);
2834 return gtk_widget_get_default_visual ();
2837 return gdk_window_get_visual (widget->window);
2840 /*****************************************
2841 * gtk_widget_get_events:
2846 *****************************************/
2849 gtk_widget_get_events (GtkWidget *widget)
2853 g_return_val_if_fail (widget != NULL, 0);
2855 events = gtk_object_get_data (GTK_OBJECT (widget), event_key);
2862 /*****************************************
2863 * gtk_widget_get_extension_events:
2868 *****************************************/
2871 gtk_widget_get_extension_events (GtkWidget *widget)
2873 GdkExtensionMode *mode;
2875 g_return_val_if_fail (widget != NULL, 0);
2877 mode = gtk_object_get_data (GTK_OBJECT (widget), extension_event_key);
2884 /*****************************************
2885 * gtk_widget_get_pointer:
2890 *****************************************/
2893 gtk_widget_get_pointer (GtkWidget *widget,
2897 g_return_if_fail (widget != NULL);
2904 if (GTK_WIDGET_REALIZED (widget))
2906 gdk_window_get_pointer (widget->window, x, y, NULL);
2908 if (GTK_WIDGET_NO_WINDOW (widget))
2911 *x -= widget->allocation.x;
2913 *y -= widget->allocation.y;
2918 /*****************************************
2919 * gtk_widget_is_ancestor:
2924 *****************************************/
2927 gtk_widget_is_ancestor (GtkWidget *widget,
2928 GtkWidget *ancestor)
2930 g_return_val_if_fail (widget != NULL, FALSE);
2931 g_return_val_if_fail (ancestor != NULL, FALSE);
2935 if (widget->parent == ancestor)
2937 widget = widget->parent;
2943 /*****************************************
2944 * gtk_widget_is_child:
2949 *****************************************/
2952 gtk_widget_is_child (GtkWidget *widget,
2955 g_return_val_if_fail (widget != NULL, FALSE);
2956 g_return_val_if_fail (child != NULL, FALSE);
2958 return (child->parent == widget);
2961 /*****************************************
2962 * gtk_widget_push_colormap:
2967 *****************************************/
2970 gtk_widget_push_colormap (GdkColormap *cmap)
2972 g_return_if_fail (cmap != NULL);
2974 colormap_stack = g_slist_prepend (colormap_stack, cmap);
2977 /*****************************************
2978 * gtk_widget_push_visual:
2983 *****************************************/
2986 gtk_widget_push_visual (GdkVisual *visual)
2988 g_return_if_fail (visual != NULL);
2990 visual_stack = g_slist_prepend (visual_stack, visual);
2993 /*****************************************
2994 * gtk_widget_pop_colormap:
2999 *****************************************/
3002 gtk_widget_pop_colormap ()
3008 tmp = colormap_stack;
3009 colormap_stack = colormap_stack->next;
3010 g_slist_free_1 (tmp);
3014 /*****************************************
3015 * gtk_widget_pop_visual:
3020 *****************************************/
3023 gtk_widget_pop_visual ()
3030 visual_stack = visual_stack->next;
3031 g_slist_free_1 (tmp);
3035 /*****************************************
3036 * gtk_widget_set_default_colormap:
3041 *****************************************/
3044 gtk_widget_set_default_colormap (GdkColormap *colormap)
3046 if (default_colormap != colormap)
3048 if (default_colormap)
3049 gdk_colormap_unref (default_colormap);
3050 default_colormap = colormap;
3051 if (default_colormap)
3052 gdk_colormap_ref (default_colormap);
3056 /*****************************************
3057 * gtk_widget_set_default_visual:
3062 *****************************************/
3065 gtk_widget_set_default_visual (GdkVisual *visual)
3067 default_visual = visual;
3070 /*****************************************
3071 * gtk_widget_get_default_colormap:
3076 *****************************************/
3079 gtk_widget_get_default_colormap ()
3081 if (!default_colormap)
3082 default_colormap = gdk_colormap_get_system ();
3084 return default_colormap;
3087 /*****************************************
3088 * gtk_widget_get_default_visual:
3093 *****************************************/
3096 gtk_widget_get_default_visual ()
3098 if (!default_visual)
3099 default_visual = gdk_visual_get_system ();
3101 return default_visual;
3104 /*****************************************
3105 * gtk_widget_marshal_signal_1:
3110 *****************************************/
3113 gtk_widget_marshal_signal_1 (GtkObject *object,
3118 GtkWidgetSignal1 rfunc;
3120 rfunc = (GtkWidgetSignal1) func;
3123 GTK_VALUE_POINTER (args[0]),
3127 /*****************************************
3128 * gtk_widget_marshal_signal_2:
3133 *****************************************/
3136 gtk_widget_marshal_signal_2 (GtkObject *object,
3141 GtkWidgetSignal2 rfunc;
3144 rfunc = (GtkWidgetSignal2) func;
3145 return_val = GTK_RETLOC_BOOL (args[3]);
3147 *return_val = (* rfunc) (object,
3148 GTK_VALUE_STRING (args[0]),
3149 GTK_VALUE_CHAR (args[1]),
3150 GTK_VALUE_INT (args[2]),
3154 /*****************************************
3155 * gtk_widget_marshal_signal_3:
3160 *****************************************/
3163 gtk_widget_marshal_signal_3 (GtkObject *object,
3168 GtkWidgetSignal3 rfunc;
3170 rfunc = (GtkWidgetSignal3) func;
3173 GTK_VALUE_STRING (args[0]),
3177 /*****************************************
3178 * gtk_widget_marshal_signal_4:
3183 *****************************************/
3186 gtk_widget_marshal_signal_4 (GtkObject *object,
3191 GtkWidgetSignal4 rfunc;
3194 rfunc = (GtkWidgetSignal4) func;
3195 return_val = GTK_RETLOC_BOOL (args[1]);
3197 *return_val = (* rfunc) (object,
3198 GTK_VALUE_BOXED (args[0]),
3202 /*****************************************
3203 * gtk_widget_marshal_signal_5:
3208 *****************************************/
3211 gtk_widget_marshal_signal_5 (GtkObject *object,
3216 GtkWidgetSignal5 rfunc;
3218 rfunc = (GtkWidgetSignal5) func;
3221 GTK_VALUE_UINT (args[0]),
3225 /*****************************************
3226 * gtk_widget_marshal_signal_6:
3231 *****************************************/
3234 gtk_widget_marshal_signal_6 (GtkObject *object,
3239 GtkWidgetSignal6 rfunc;
3241 rfunc = (GtkWidgetSignal6) func;
3244 GTK_VALUE_OBJECT (args[0]),
3248 /*****************************************
3249 * gtk_widget_marshal_signal_7:
3254 *****************************************/
3257 gtk_widget_marshal_signal_7 (GtkObject *object,
3262 GtkWidgetSignal7 rfunc;
3264 rfunc = (GtkWidgetSignal7) func;
3267 GTK_VALUE_BOXED (args[0]),
3272 gtk_widget_real_destroy (GtkObject *object)
3274 GtkWidget *widget = GTK_WIDGET (object);
3276 gtk_widget_ref (widget);
3278 if (GTK_WIDGET_REDRAW_PENDING (widget))
3280 gtk_widget_redraw_queue = g_slist_remove (gtk_widget_redraw_queue, widget);
3281 GTK_PRIVATE_UNSET_FLAG (widget, GTK_REDRAW_PENDING);
3284 if (GTK_CONTAINER_RESIZE_PENDING (widget))
3286 gtk_widget_resize_queue = g_slist_remove (gtk_widget_resize_queue, widget);
3287 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_PENDING);
3290 if (GTK_WIDGET_HAS_SHAPE_MASK (widget))
3291 gtk_widget_shape_combine_mask (widget, NULL, -1, -1);
3293 gtk_grab_remove (widget);
3294 gtk_selection_remove_all (widget);
3297 gtk_container_remove (GTK_CONTAINER (widget->parent), widget);
3299 gtk_style_unref (widget->style);
3300 widget->style = NULL;
3302 parent_class->destroy (object);
3304 gtk_widget_unref (widget);
3308 gtk_widget_real_finalize (GtkObject *object)
3311 GtkWidgetAuxInfo *aux_info;
3313 GdkExtensionMode *mode;
3315 g_return_if_fail (object != NULL);
3316 g_return_if_fail (GTK_IS_WIDGET (object));
3318 widget = GTK_WIDGET (object);
3322 g_free (widget->name);
3323 widget->name = NULL;
3326 aux_info = gtk_object_get_data (GTK_OBJECT (widget), aux_info_key);
3329 gtk_widget_aux_info_destroy (aux_info);
3330 gtk_object_remove_data (GTK_OBJECT (widget), aux_info_key);
3333 events = gtk_object_get_data (GTK_OBJECT (widget), event_key);
3337 gtk_object_remove_data (GTK_OBJECT (widget), event_key);
3340 mode = gtk_object_get_data (GTK_OBJECT (widget), extension_event_key);
3344 gtk_object_remove_data (GTK_OBJECT (widget), extension_event_key);
3347 parent_class->finalize (object);
3350 /*****************************************
3351 * gtk_widget_real_show:
3356 *****************************************/
3359 gtk_widget_real_show (GtkWidget *widget)
3361 g_return_if_fail (widget != NULL);
3362 g_return_if_fail (GTK_IS_WIDGET (widget));
3364 if (!GTK_WIDGET_VISIBLE (widget))
3366 GTK_WIDGET_SET_FLAGS (widget, GTK_VISIBLE);
3370 gtk_widget_queue_resize (widget);
3372 if (GTK_WIDGET_MAPPED (widget->parent))
3373 gtk_widget_map (widget);
3378 /*****************************************
3379 * gtk_widget_real_hide:
3384 *****************************************/
3387 gtk_widget_real_hide (GtkWidget *widget)
3389 g_return_if_fail (widget != NULL);
3390 g_return_if_fail (GTK_IS_WIDGET (widget));
3392 if (GTK_WIDGET_VISIBLE (widget))
3394 GTK_WIDGET_UNSET_FLAGS (widget, GTK_VISIBLE);
3396 if (GTK_WIDGET_MAPPED (widget))
3397 gtk_widget_unmap (widget);
3400 gtk_widget_queue_resize (widget);
3404 /*****************************************
3405 * gtk_widget_real_map:
3410 *****************************************/
3413 gtk_widget_real_map (GtkWidget *widget)
3415 g_return_if_fail (widget != NULL);
3416 g_return_if_fail (GTK_IS_WIDGET (widget));
3418 if (GTK_WIDGET_REALIZED (widget) && !GTK_WIDGET_MAPPED (widget))
3420 GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
3422 if (!GTK_WIDGET_NO_WINDOW (widget))
3423 gdk_window_show (widget->window);
3425 gtk_widget_queue_draw (widget);
3429 /*****************************************
3430 * gtk_widget_real_unmap:
3435 *****************************************/
3438 gtk_widget_real_unmap (GtkWidget *widget)
3440 g_return_if_fail (widget != NULL);
3441 g_return_if_fail (GTK_IS_WIDGET (widget));
3443 if (GTK_WIDGET_MAPPED (widget))
3445 GTK_WIDGET_UNSET_FLAGS (widget, GTK_MAPPED);
3447 if (GTK_WIDGET_NO_WINDOW (widget))
3448 gdk_window_clear_area (widget->window,
3449 widget->allocation.x,
3450 widget->allocation.y,
3451 widget->allocation.width,
3452 widget->allocation.height);
3454 gdk_window_hide (widget->window);
3458 /*****************************************
3459 * gtk_widget_real_realize:
3464 *****************************************/
3467 gtk_widget_real_realize (GtkWidget *widget)
3469 g_return_if_fail (widget != NULL);
3470 g_return_if_fail (GTK_IS_WIDGET (widget));
3471 g_return_if_fail (GTK_WIDGET_NO_WINDOW (widget));
3473 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
3476 widget->window = gtk_widget_get_parent_window (widget);
3477 gdk_window_ref (widget->window);
3479 widget->style = gtk_style_attach (widget->style, widget->window);
3482 /*****************************************
3483 * gtk_widget_real_unrealize:
3488 *****************************************/
3491 gtk_widget_real_unrealize (GtkWidget *widget)
3493 g_return_if_fail (widget != NULL);
3494 g_return_if_fail (GTK_IS_WIDGET (widget));
3496 if (GTK_WIDGET_NO_WINDOW (widget) && GTK_WIDGET_MAPPED (widget))
3497 gtk_widget_real_unmap (widget);
3499 GTK_WIDGET_UNSET_FLAGS (widget, GTK_REALIZED | GTK_MAPPED);
3501 /* printf ("unrealizing %s\n", gtk_type_name (GTK_OBJECT(widget)->klass->type));
3504 gtk_style_detach (widget->style);
3505 if (!GTK_WIDGET_NO_WINDOW (widget))
3507 gdk_window_set_user_data (widget->window, NULL);
3508 gdk_window_destroy (widget->window);
3512 gdk_window_unref (widget->window);
3515 /* Unrealize afterwards to improve visual effect */
3517 if (GTK_IS_CONTAINER (widget))
3518 gtk_container_foreach (GTK_CONTAINER (widget),
3519 (GtkCallback)gtk_widget_unrealize,
3522 widget->window = NULL;
3525 /*****************************************
3526 * gtk_widget_real_draw:
3531 *****************************************/
3534 gtk_widget_real_draw (GtkWidget *widget,
3537 GdkEventExpose event;
3539 g_return_if_fail (widget != NULL);
3540 g_return_if_fail (GTK_IS_WIDGET (widget));
3541 g_return_if_fail (area != NULL);
3543 if (GTK_WIDGET_DRAWABLE (widget))
3545 event.type = GDK_EXPOSE;
3546 event.window = widget->window;
3549 gdk_window_ref (event.window);
3550 gtk_widget_event (widget, (GdkEvent*) &event);
3551 gdk_window_unref (event.window);
3555 /*****************************************
3556 * gtk_widget_real_queue_draw:
3561 *****************************************/
3564 gtk_widget_real_queue_draw (GtkWidget *widget)
3566 g_return_val_if_fail (widget != NULL, FALSE);
3567 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
3569 GTK_PRIVATE_UNSET_FLAG (widget, GTK_REDRAW_PENDING);
3570 gtk_widget_draw (widget, NULL);
3575 /*****************************************
3576 * gtk_widget_real_size_allocate:
3581 *****************************************/
3584 gtk_widget_real_size_allocate (GtkWidget *widget,
3585 GtkAllocation *allocation)
3587 g_return_if_fail (widget != NULL);
3588 g_return_if_fail (GTK_IS_WIDGET (widget));
3590 if (GTK_WIDGET_NO_WINDOW (widget) &&
3591 GTK_WIDGET_MAPPED (widget) &&
3592 ((widget->allocation.x != allocation->x) ||
3593 (widget->allocation.y != allocation->y) ||
3594 (widget->allocation.width != allocation->width) ||
3595 (widget->allocation.height != allocation->height)) &&
3596 (widget->allocation.width != 0) &&
3597 (widget->allocation.height != 0))
3598 gdk_window_clear_area (widget->window,
3599 widget->allocation.x,
3600 widget->allocation.y,
3601 widget->allocation.width,
3602 widget->allocation.height);
3604 widget->allocation = *allocation;
3606 if (GTK_WIDGET_REALIZED (widget) &&
3607 !GTK_WIDGET_NO_WINDOW (widget))
3608 gdk_window_move_resize (widget->window,
3609 allocation->x, allocation->y,
3610 allocation->width, allocation->height);
3613 /*****************************************
3614 * gtk_widget_peek_colormap:
3619 *****************************************/
3622 gtk_widget_peek_colormap ()
3625 return (GdkColormap*) colormap_stack->data;
3626 return gtk_widget_get_default_colormap ();
3629 /*****************************************
3630 * gtk_widget_peek_visual:
3635 *****************************************/
3638 gtk_widget_peek_visual ()
3641 return (GdkVisual*) visual_stack->data;
3642 return gtk_widget_get_default_visual ();
3645 /*************************************************************
3646 * gtk_widget_propagate_state:
3647 * Propagate a change in the widgets state down the tree
3651 * GtkStateData: state
3655 *************************************************************/
3658 gtk_widget_propagate_state (GtkWidget *widget,
3663 /* don't call this function with state=GTK_STATE_INSENSITIVE,
3664 * parent_sensitive=TRUE and a sensitive widget
3667 old_state = GTK_WIDGET_STATE (widget);
3669 if (data->parent_sensitive)
3671 GTK_WIDGET_SET_FLAGS (widget, GTK_PARENT_SENSITIVE);
3673 if (GTK_WIDGET_IS_SENSITIVE (widget))
3674 GTK_WIDGET_STATE (widget) = data->state;
3677 GTK_WIDGET_STATE (widget) = GTK_STATE_INSENSITIVE;
3678 if (data->state != GTK_STATE_INSENSITIVE)
3679 GTK_WIDGET_SAVED_STATE (widget) = data->state;
3684 GTK_WIDGET_UNSET_FLAGS (widget, GTK_PARENT_SENSITIVE);
3685 GTK_WIDGET_STATE (widget) = GTK_STATE_INSENSITIVE;
3686 if (data->state != GTK_STATE_INSENSITIVE)
3687 GTK_WIDGET_SAVED_STATE (widget) = data->state;
3690 if (GTK_WIDGET_HAS_FOCUS (widget) && !GTK_WIDGET_IS_SENSITIVE (widget))
3694 window = gtk_widget_get_ancestor (widget, gtk_window_get_type ());
3696 gtk_window_set_focus (GTK_WINDOW (window), NULL);
3699 if (old_state != GTK_WIDGET_STATE (widget))
3701 gtk_widget_ref (widget);
3702 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[STATE_CHANGED], old_state);
3704 if (GTK_IS_CONTAINER (widget))
3706 data->parent_sensitive = GTK_WIDGET_IS_SENSITIVE (widget);
3707 data->state = GTK_WIDGET_STATE (widget);
3708 gtk_container_foreach (GTK_CONTAINER (widget),
3709 (GtkCallback) gtk_widget_propagate_state,
3712 gtk_widget_unref (widget);
3716 /*****************************************
3717 * gtk_widget_draw_children_recurse:
3722 *****************************************/
3725 gtk_widget_draw_children_recurse (GtkWidget *widget,
3726 gpointer client_data)
3728 gtk_widget_draw (widget, NULL);
3729 gtk_widget_draw_children (widget);
3732 /*****************************************
3733 * gtk_widget_aux_info_new:
3738 *****************************************/
3740 static GtkWidgetAuxInfo*
3741 gtk_widget_aux_info_new ()
3743 GtkWidgetAuxInfo *aux_info;
3745 if (!aux_info_mem_chunk)
3746 aux_info_mem_chunk = g_mem_chunk_new ("widget aux info mem chunk",
3747 sizeof (GtkWidgetAuxInfo),
3748 1024, G_ALLOC_AND_FREE);
3750 aux_info = g_chunk_new (GtkWidgetAuxInfo, aux_info_mem_chunk);
3754 aux_info->width = 0;
3755 aux_info->height = 0;
3760 /*****************************************
3761 * gtk_widget_aux_info_destroy:
3766 *****************************************/
3769 gtk_widget_aux_info_destroy (GtkWidgetAuxInfo *aux_info)
3771 g_return_if_fail (aux_info != NULL);
3773 g_mem_chunk_free (aux_info_mem_chunk, aux_info);
3776 /*****************************************
3777 * gtk_widget_shape_combine_mask:
3778 * set a shape for this widgets' gdk window, this allows for
3779 * transparent windows etc., see gdk_window_shape_combine_mask
3780 * for more information
3785 *****************************************/
3787 gtk_widget_shape_combine_mask (GtkWidget *widget,
3788 GdkBitmap *shape_mask,
3792 GtkWidgetShapeInfo* shape_info;
3794 g_return_if_fail (widget != NULL);
3795 /* set_shape doesn't work on widgets without gdk window */
3796 g_return_if_fail (!GTK_WIDGET_NO_WINDOW (widget));
3800 GTK_PRIVATE_UNSET_FLAG (widget, GTK_HAS_SHAPE_MASK);
3803 gdk_window_shape_combine_mask (widget->window, NULL, 0, 0);
3805 shape_info = gtk_object_get_data (GTK_OBJECT (widget), shape_info_key);
3806 gtk_object_remove_data (GTK_OBJECT (widget), shape_info_key);
3807 g_free (shape_info);
3811 GTK_PRIVATE_SET_FLAG (widget, GTK_HAS_SHAPE_MASK);
3813 shape_info = gtk_object_get_data (GTK_OBJECT (widget), shape_info_key);
3816 shape_info = g_new (GtkWidgetShapeInfo, 1);
3817 gtk_object_set_data (GTK_OBJECT (widget), shape_info_key, shape_info);
3819 shape_info->shape_mask = shape_mask;
3820 shape_info->offset_x = offset_x;
3821 shape_info->offset_y = offset_y;
3823 /* set shape if widget has a gdk window allready.
3824 * otherwise the shape is scheduled to be set by gtk_widget_realize.
3827 gdk_window_shape_combine_mask (widget->window, shape_mask,
3828 offset_x, offset_y);
3832 /*****************************************
3833 * gtk_widget_dnd_drag_add:
3834 * when you get a DRAG_ENTER event, you can use this
3835 * to tell Gtk ofother widgets that are to be dragged as well
3840 *****************************************/
3842 gtk_widget_dnd_drag_add (GtkWidget *widget)
3846 /*****************************************
3847 * gtk_widget_dnd_drag_set:
3848 * these two functions enable drag and/or drop on a
3849 * widget and also let Gtk know what data types will be accepted
3850 * use MIME type naming,plus tacking "URL:" on the front for link
3857 *****************************************/
3859 gtk_widget_dnd_drag_set (GtkWidget *widget,
3861 gchar **type_accept_list,
3864 g_return_if_fail(widget != NULL);
3866 if (!widget->window)
3867 gtk_widget_realize (widget);
3869 g_return_if_fail (widget->window != NULL);
3870 gdk_window_dnd_drag_set (widget->window,
3876 /*****************************************
3877 * gtk_widget_dnd_drop_set:
3882 *****************************************/
3884 gtk_widget_dnd_drop_set (GtkWidget *widget,
3886 gchar **type_accept_list,
3888 guint8 is_destructive_operation)
3890 g_return_if_fail(widget != NULL);
3892 if (!widget->window)
3893 gtk_widget_realize (widget);
3895 g_return_if_fail (widget->window != NULL);
3896 gdk_window_dnd_drop_set (widget->window,
3900 is_destructive_operation);
3903 /*****************************************
3904 * gtk_widget_dnd_data_set:
3909 *****************************************/
3911 gtk_widget_dnd_data_set (GtkWidget *widget,
3914 gulong data_numbytes)
3916 g_return_if_fail (widget != NULL);
3917 g_return_if_fail (widget->window != NULL);
3919 gdk_window_dnd_data_set (widget->window, event, data, data_numbytes);
3923 #undef gtk_widget_ref
3924 #undef gtk_widget_unref
3928 gtk_widget_ref (GtkWidget *widget)
3930 gtk_object_ref (GTK_OBJECT (widget));
3934 gtk_widget_unref (GtkWidget *widget)
3936 gtk_object_unref (GTK_OBJECT (widget));