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
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 #include "gtkcontainer.h"
24 #include "gtkselection.h"
25 #include "gtksignal.h"
26 #include "gtkwidget.h"
27 #include "gtkwindow.h"
28 #include "gtkprivate.h"
33 #define WIDGET_CLASS(w) GTK_WIDGET_CLASS (GTK_OBJECT (w)->klass)
69 PROPERTY_NOTIFY_EVENT,
70 SELECTION_CLEAR_EVENT,
71 SELECTION_REQUEST_EVENT,
72 SELECTION_NOTIFY_EVENT,
81 DROP_DATA_AVAILABLE_EVENT,
108 typedef void (*GtkWidgetSignal1) (GtkObject *object,
111 typedef gint (*GtkWidgetSignal2) (GtkObject *object,
116 typedef void (*GtkWidgetSignal3) (GtkObject *object,
119 typedef gint (*GtkWidgetSignal4) (GtkObject *object,
122 typedef void (*GtkWidgetSignal5) (GtkObject *object,
125 typedef void (*GtkWidgetSignal6) (GtkObject *object,
128 typedef void (*GtkWidgetSignal7) (GtkObject *object,
132 typedef struct _GtkStateData GtkStateData;
137 guint state_restauration : 1;
138 guint parent_sensitive : 1;
142 static void gtk_widget_marshal_signal_1 (GtkObject *object,
146 static void gtk_widget_marshal_signal_2 (GtkObject *object,
150 static void gtk_widget_marshal_signal_3 (GtkObject *object,
154 static void gtk_widget_marshal_signal_4 (GtkObject *object,
158 static void gtk_widget_marshal_signal_5 (GtkObject *object,
162 static void gtk_widget_marshal_signal_6 (GtkObject *object,
166 static void gtk_widget_marshal_signal_7 (GtkObject *object,
171 static void gtk_widget_class_init (GtkWidgetClass *klass);
172 static void gtk_widget_init (GtkWidget *widget);
173 static void gtk_widget_set_arg (GtkWidget *widget,
176 static void gtk_widget_get_arg (GtkWidget *widget,
179 static void gtk_widget_shutdown (GtkObject *object);
180 static void gtk_widget_real_destroy (GtkObject *object);
181 static void gtk_widget_finalize (GtkObject *object);
182 static void gtk_widget_real_show (GtkWidget *widget);
183 static void gtk_widget_real_hide (GtkWidget *widget);
184 static void gtk_widget_real_map (GtkWidget *widget);
185 static void gtk_widget_real_unmap (GtkWidget *widget);
186 static void gtk_widget_real_realize (GtkWidget *widget);
187 static void gtk_widget_real_unrealize (GtkWidget *widget);
188 static void gtk_widget_real_draw (GtkWidget *widget,
190 static gint gtk_widget_real_queue_draw (GtkWidget *widget);
191 static void gtk_widget_real_size_allocate (GtkWidget *widget,
192 GtkAllocation *allocation);
193 static void gtk_widget_style_set (GtkWidget *widget,
194 GtkStyle *previous_style);
196 static GdkColormap* gtk_widget_peek_colormap (void);
197 static GdkVisual* gtk_widget_peek_visual (void);
198 static GtkStyle* gtk_widget_peek_style (void);
200 static void gtk_widget_reparent_container_child (GtkWidget *widget,
201 gpointer client_data);
202 static void gtk_widget_propagate_state (GtkWidget *widget,
204 static void gtk_widget_draw_children_recurse (GtkWidget *widget,
205 gpointer client_data);
206 static void gtk_widget_set_style_internal (GtkWidget *widget,
208 gboolean initial_emission);
209 static void gtk_widget_set_style_recurse (GtkWidget *widget,
210 gpointer client_data);
212 extern GtkArg* gtk_object_collect_args (guint *nargs,
216 static GtkWidgetAuxInfo* gtk_widget_aux_info_new (void);
217 static void gtk_widget_aux_info_destroy (GtkWidgetAuxInfo *aux_info);
219 static GtkObjectClass *parent_class = NULL;
220 static guint widget_signals[LAST_SIGNAL] = { 0 };
222 static GMemChunk *aux_info_mem_chunk = NULL;
224 static GdkColormap *default_colormap = NULL;
225 static GdkVisual *default_visual = NULL;
226 static GtkStyle *default_style = NULL;
228 static GSList *colormap_stack = NULL;
229 static GSList *visual_stack = NULL;
230 static GSList *style_stack = NULL;
232 static GSList *gtk_widget_redraw_queue = NULL;
233 static GSList *gtk_widget_resize_queue = NULL;
235 static const gchar *aux_info_key = "gtk-aux-info";
236 static guint aux_info_key_id = 0;
237 static const gchar *event_key = "gtk-event-mask";
238 static guint event_key_id = 0;
239 static const gchar *extension_event_key = "gtk-extension-event-mode";
240 static guint extension_event_key_id = 0;
241 static const gchar *parent_window_key = "gtk-parent-window";
242 static guint parent_window_key_id = 0;
243 static const gchar *saved_default_style_key = "gtk-saved-default-style";
244 static guint saved_default_style_key_id = 0;
245 static const gchar *shape_info_key = "gtk-shape-info";
246 static const gchar *colormap_key = "gtk-colormap";
247 static const gchar *visual_key = "gtk-visual";
251 /*****************************************
252 * gtk_widget_get_type:
257 *****************************************/
260 gtk_widget_get_type (void)
262 static GtkType widget_type = 0;
266 GtkTypeInfo widget_info =
270 sizeof (GtkWidgetClass),
271 (GtkClassInitFunc) gtk_widget_class_init,
272 (GtkObjectInitFunc) gtk_widget_init,
273 (GtkArgSetFunc) gtk_widget_set_arg,
274 (GtkArgGetFunc) gtk_widget_get_arg,
277 widget_type = gtk_type_unique (gtk_object_get_type (), &widget_info);
283 /*****************************************
284 * gtk_widget_class_init:
289 *****************************************/
292 gtk_widget_class_init (GtkWidgetClass *klass)
294 GtkObjectClass *object_class;
296 object_class = (GtkObjectClass*) klass;
298 parent_class = gtk_type_class (gtk_object_get_type ());
300 gtk_object_add_arg_type ("GtkWidget::name", GTK_TYPE_STRING, GTK_ARG_READWRITE, ARG_NAME);
301 gtk_object_add_arg_type ("GtkWidget::parent", GTK_TYPE_CONTAINER, GTK_ARG_READWRITE, ARG_PARENT);
302 gtk_object_add_arg_type ("GtkWidget::x", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_X);
303 gtk_object_add_arg_type ("GtkWidget::y", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_Y);
304 gtk_object_add_arg_type ("GtkWidget::width", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_WIDTH);
305 gtk_object_add_arg_type ("GtkWidget::height", GTK_TYPE_INT, GTK_ARG_READWRITE, ARG_HEIGHT);
306 gtk_object_add_arg_type ("GtkWidget::visible", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_VISIBLE);
307 gtk_object_add_arg_type ("GtkWidget::sensitive", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_SENSITIVE);
308 gtk_object_add_arg_type ("GtkWidget::can_focus", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_CAN_FOCUS);
309 gtk_object_add_arg_type ("GtkWidget::has_focus", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_HAS_FOCUS);
310 gtk_object_add_arg_type ("GtkWidget::can_default", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_CAN_DEFAULT);
311 gtk_object_add_arg_type ("GtkWidget::has_default", GTK_TYPE_BOOL, GTK_ARG_READWRITE, ARG_HAS_DEFAULT);
312 gtk_object_add_arg_type ("GtkWidget::style", GTK_TYPE_STYLE, GTK_ARG_READWRITE, ARG_STYLE);
313 gtk_object_add_arg_type ("GtkWidget::events", GTK_TYPE_GDK_EVENT_MASK, GTK_ARG_READWRITE, ARG_EVENTS);
314 gtk_object_add_arg_type ("GtkWidget::extension_events", GTK_TYPE_GDK_EVENT_MASK, GTK_ARG_READWRITE, ARG_EXTENSION_EVENTS);
316 widget_signals[SHOW] =
317 gtk_signal_new ("show",
320 GTK_SIGNAL_OFFSET (GtkWidgetClass, show),
321 gtk_signal_default_marshaller,
323 widget_signals[HIDE] =
324 gtk_signal_new ("hide",
327 GTK_SIGNAL_OFFSET (GtkWidgetClass, hide),
328 gtk_signal_default_marshaller,
330 widget_signals[MAP] =
331 gtk_signal_new ("map",
334 GTK_SIGNAL_OFFSET (GtkWidgetClass, map),
335 gtk_signal_default_marshaller,
337 widget_signals[UNMAP] =
338 gtk_signal_new ("unmap",
341 GTK_SIGNAL_OFFSET (GtkWidgetClass, unmap),
342 gtk_signal_default_marshaller,
344 widget_signals[REALIZE] =
345 gtk_signal_new ("realize",
348 GTK_SIGNAL_OFFSET (GtkWidgetClass, realize),
349 gtk_signal_default_marshaller,
351 widget_signals[UNREALIZE] =
352 gtk_signal_new ("unrealize",
355 GTK_SIGNAL_OFFSET (GtkWidgetClass, unrealize),
356 gtk_signal_default_marshaller,
358 widget_signals[DRAW] =
359 gtk_signal_new ("draw",
362 GTK_SIGNAL_OFFSET (GtkWidgetClass, draw),
363 gtk_widget_marshal_signal_1,
366 widget_signals[DRAW_FOCUS] =
367 gtk_signal_new ("draw_focus",
370 GTK_SIGNAL_OFFSET (GtkWidgetClass, draw_focus),
371 gtk_signal_default_marshaller,
373 widget_signals[DRAW_DEFAULT] =
374 gtk_signal_new ("draw_default",
377 GTK_SIGNAL_OFFSET (GtkWidgetClass, draw_default),
378 gtk_signal_default_marshaller,
380 widget_signals[SIZE_REQUEST] =
381 gtk_signal_new ("size_request",
384 GTK_SIGNAL_OFFSET (GtkWidgetClass, size_request),
385 gtk_widget_marshal_signal_1,
388 widget_signals[SIZE_ALLOCATE] =
389 gtk_signal_new ("size_allocate",
392 GTK_SIGNAL_OFFSET (GtkWidgetClass, size_allocate),
393 gtk_widget_marshal_signal_1,
396 widget_signals[STATE_CHANGED] =
397 gtk_signal_new ("state_changed",
400 GTK_SIGNAL_OFFSET (GtkWidgetClass, state_changed),
401 gtk_widget_marshal_signal_5,
404 widget_signals[PARENT_SET] =
405 gtk_signal_new ("parent_set",
408 GTK_SIGNAL_OFFSET (GtkWidgetClass, parent_set),
409 gtk_widget_marshal_signal_6,
412 widget_signals[STYLE_SET] =
413 gtk_signal_new ("style_set",
416 GTK_SIGNAL_OFFSET (GtkWidgetClass, style_set),
417 gtk_widget_marshal_signal_7,
420 widget_signals[INSTALL_ACCELERATOR] =
421 gtk_signal_new ("install_accelerator",
424 GTK_SIGNAL_OFFSET (GtkWidgetClass, install_accelerator),
425 gtk_widget_marshal_signal_2,
430 widget_signals[REMOVE_ACCELERATOR] =
431 gtk_signal_new ("remove_accelerator",
434 GTK_SIGNAL_OFFSET (GtkWidgetClass, remove_accelerator),
435 gtk_widget_marshal_signal_3,
438 widget_signals[EVENT] =
439 gtk_signal_new ("event",
442 GTK_SIGNAL_OFFSET (GtkWidgetClass, event),
443 gtk_widget_marshal_signal_4,
446 widget_signals[BUTTON_PRESS_EVENT] =
447 gtk_signal_new ("button_press_event",
450 GTK_SIGNAL_OFFSET (GtkWidgetClass, button_press_event),
451 gtk_widget_marshal_signal_4,
454 widget_signals[BUTTON_RELEASE_EVENT] =
455 gtk_signal_new ("button_release_event",
458 GTK_SIGNAL_OFFSET (GtkWidgetClass, button_release_event),
459 gtk_widget_marshal_signal_4,
462 widget_signals[MOTION_NOTIFY_EVENT] =
463 gtk_signal_new ("motion_notify_event",
466 GTK_SIGNAL_OFFSET (GtkWidgetClass, motion_notify_event),
467 gtk_widget_marshal_signal_4,
470 widget_signals[DELETE_EVENT] =
471 gtk_signal_new ("delete_event",
474 GTK_SIGNAL_OFFSET (GtkWidgetClass, delete_event),
475 gtk_widget_marshal_signal_4,
478 widget_signals[DESTROY_EVENT] =
479 gtk_signal_new ("destroy_event",
482 GTK_SIGNAL_OFFSET (GtkWidgetClass, destroy_event),
483 gtk_widget_marshal_signal_4,
486 widget_signals[EXPOSE_EVENT] =
487 gtk_signal_new ("expose_event",
490 GTK_SIGNAL_OFFSET (GtkWidgetClass, expose_event),
491 gtk_widget_marshal_signal_4,
494 widget_signals[KEY_PRESS_EVENT] =
495 gtk_signal_new ("key_press_event",
498 GTK_SIGNAL_OFFSET (GtkWidgetClass, key_press_event),
499 gtk_widget_marshal_signal_4,
502 widget_signals[KEY_RELEASE_EVENT] =
503 gtk_signal_new ("key_release_event",
506 GTK_SIGNAL_OFFSET (GtkWidgetClass, key_release_event),
507 gtk_widget_marshal_signal_4,
510 widget_signals[ENTER_NOTIFY_EVENT] =
511 gtk_signal_new ("enter_notify_event",
514 GTK_SIGNAL_OFFSET (GtkWidgetClass, enter_notify_event),
515 gtk_widget_marshal_signal_4,
518 widget_signals[LEAVE_NOTIFY_EVENT] =
519 gtk_signal_new ("leave_notify_event",
522 GTK_SIGNAL_OFFSET (GtkWidgetClass, leave_notify_event),
523 gtk_widget_marshal_signal_4,
526 widget_signals[CONFIGURE_EVENT] =
527 gtk_signal_new ("configure_event",
530 GTK_SIGNAL_OFFSET (GtkWidgetClass, configure_event),
531 gtk_widget_marshal_signal_4,
534 widget_signals[FOCUS_IN_EVENT] =
535 gtk_signal_new ("focus_in_event",
538 GTK_SIGNAL_OFFSET (GtkWidgetClass, focus_in_event),
539 gtk_widget_marshal_signal_4,
542 widget_signals[FOCUS_OUT_EVENT] =
543 gtk_signal_new ("focus_out_event",
546 GTK_SIGNAL_OFFSET (GtkWidgetClass, focus_out_event),
547 gtk_widget_marshal_signal_4,
550 widget_signals[MAP_EVENT] =
551 gtk_signal_new ("map_event",
554 GTK_SIGNAL_OFFSET (GtkWidgetClass, map_event),
555 gtk_widget_marshal_signal_4,
558 widget_signals[UNMAP_EVENT] =
559 gtk_signal_new ("unmap_event",
562 GTK_SIGNAL_OFFSET (GtkWidgetClass, unmap_event),
563 gtk_widget_marshal_signal_4,
566 widget_signals[PROPERTY_NOTIFY_EVENT] =
567 gtk_signal_new ("property_notify_event",
570 GTK_SIGNAL_OFFSET (GtkWidgetClass, property_notify_event),
571 gtk_widget_marshal_signal_4,
574 widget_signals[SELECTION_CLEAR_EVENT] =
575 gtk_signal_new ("selection_clear_event",
578 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_clear_event),
579 gtk_widget_marshal_signal_4,
582 widget_signals[SELECTION_REQUEST_EVENT] =
583 gtk_signal_new ("selection_request_event",
586 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_request_event),
587 gtk_widget_marshal_signal_4,
590 widget_signals[SELECTION_NOTIFY_EVENT] =
591 gtk_signal_new ("selection_notify_event",
594 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_notify_event),
595 gtk_widget_marshal_signal_4,
598 widget_signals[SELECTION_RECEIVED] =
599 gtk_signal_new ("selection_received",
602 GTK_SIGNAL_OFFSET (GtkWidgetClass, selection_received),
603 gtk_widget_marshal_signal_1,
606 widget_signals[PROXIMITY_IN_EVENT] =
607 gtk_signal_new ("proximity_in_event",
610 GTK_SIGNAL_OFFSET (GtkWidgetClass, proximity_in_event),
611 gtk_widget_marshal_signal_4,
614 widget_signals[PROXIMITY_OUT_EVENT] =
615 gtk_signal_new ("proximity_out_event",
618 GTK_SIGNAL_OFFSET (GtkWidgetClass, proximity_out_event),
619 gtk_widget_marshal_signal_4,
622 widget_signals[DRAG_BEGIN_EVENT] =
623 gtk_signal_new ("drag_begin_event",
626 GTK_SIGNAL_OFFSET (GtkWidgetClass, drag_begin_event),
627 gtk_widget_marshal_signal_4,
630 widget_signals[DRAG_REQUEST_EVENT] =
631 gtk_signal_new ("drag_request_event",
634 GTK_SIGNAL_OFFSET (GtkWidgetClass, drag_request_event),
635 gtk_widget_marshal_signal_4,
638 widget_signals[DRAG_END_EVENT] =
639 gtk_signal_new ("drag_end_event",
642 GTK_SIGNAL_OFFSET (GtkWidgetClass, drag_end_event),
643 gtk_widget_marshal_signal_4,
646 widget_signals[DROP_ENTER_EVENT] =
647 gtk_signal_new ("drop_enter_event",
650 GTK_SIGNAL_OFFSET (GtkWidgetClass, drop_enter_event),
651 gtk_widget_marshal_signal_4,
654 widget_signals[DROP_LEAVE_EVENT] =
655 gtk_signal_new ("drop_leave_event",
658 GTK_SIGNAL_OFFSET (GtkWidgetClass, drop_leave_event),
659 gtk_widget_marshal_signal_4,
662 widget_signals[DROP_DATA_AVAILABLE_EVENT] =
663 gtk_signal_new ("drop_data_available_event",
666 GTK_SIGNAL_OFFSET (GtkWidgetClass,
667 drop_data_available_event),
668 gtk_widget_marshal_signal_4,
671 widget_signals[OTHER_EVENT] =
672 gtk_signal_new ("other_event",
675 GTK_SIGNAL_OFFSET (GtkWidgetClass, other_event),
676 gtk_widget_marshal_signal_4,
679 widget_signals[CLIENT_EVENT] =
680 gtk_signal_new ("client_event",
683 GTK_SIGNAL_OFFSET (GtkWidgetClass, client_event),
684 gtk_widget_marshal_signal_4,
687 widget_signals[NO_EXPOSE_EVENT] =
688 gtk_signal_new ("no_expose_event",
691 GTK_SIGNAL_OFFSET (GtkWidgetClass, no_expose_event),
692 gtk_widget_marshal_signal_4,
696 gtk_object_class_add_signals (object_class, widget_signals, LAST_SIGNAL);
698 object_class->shutdown = gtk_widget_shutdown;
699 object_class->destroy = gtk_widget_real_destroy;
700 object_class->finalize = gtk_widget_finalize;
702 klass->activate_signal = 0;
703 klass->show = gtk_widget_real_show;
704 klass->hide = gtk_widget_real_hide;
705 klass->show_all = gtk_widget_real_show;
706 klass->hide_all = gtk_widget_real_hide;
707 klass->map = gtk_widget_real_map;
708 klass->unmap = gtk_widget_real_unmap;
709 klass->realize = gtk_widget_real_realize;
710 klass->unrealize = gtk_widget_real_unrealize;
711 klass->draw = gtk_widget_real_draw;
712 klass->draw_focus = NULL;
713 klass->size_request = NULL;
714 klass->size_allocate = gtk_widget_real_size_allocate;
715 klass->state_changed = NULL;
716 klass->parent_set = NULL;
717 klass->style_set = gtk_widget_style_set;
718 klass->install_accelerator = NULL;
719 klass->remove_accelerator = NULL;
721 klass->button_press_event = NULL;
722 klass->button_release_event = NULL;
723 klass->motion_notify_event = NULL;
724 klass->delete_event = NULL;
725 klass->destroy_event = NULL;
726 klass->expose_event = NULL;
727 klass->key_press_event = NULL;
728 klass->key_release_event = NULL;
729 klass->enter_notify_event = NULL;
730 klass->leave_notify_event = NULL;
731 klass->configure_event = NULL;
732 klass->focus_in_event = NULL;
733 klass->focus_out_event = NULL;
734 klass->map_event = NULL;
735 klass->unmap_event = NULL;
736 klass->property_notify_event = gtk_selection_property_notify;
737 klass->selection_clear_event = gtk_selection_clear;
738 klass->selection_request_event = gtk_selection_request;
739 klass->selection_notify_event = gtk_selection_notify;
740 klass->selection_received = NULL;
741 klass->proximity_in_event = NULL;
742 klass->proximity_out_event = NULL;
743 klass->drag_begin_event = NULL;
744 klass->drag_request_event = NULL;
745 klass->drop_enter_event = NULL;
746 klass->drop_leave_event = NULL;
747 klass->drop_data_available_event = NULL;
748 klass->other_event = NULL;
749 klass->no_expose_event = NULL;
752 /*****************************************
753 * gtk_widget_set_arg:
758 *****************************************/
761 gtk_widget_set_arg (GtkWidget *widget,
770 gtk_widget_set_name (widget, GTK_VALUE_STRING (*arg));
773 gtk_container_add (GTK_CONTAINER (GTK_VALUE_OBJECT (*arg)), widget);
776 gtk_widget_set_uposition (widget, GTK_VALUE_INT (*arg), -2);
779 gtk_widget_set_uposition (widget, -2, GTK_VALUE_INT (*arg));
782 gtk_widget_set_usize (widget, GTK_VALUE_INT (*arg), -1);
785 gtk_widget_set_usize (widget, -1, GTK_VALUE_INT (*arg));
788 if (GTK_VALUE_BOOL(*arg))
789 gtk_widget_show (widget);
791 gtk_widget_hide (widget);
794 gtk_widget_set_sensitive (widget, GTK_VALUE_BOOL (*arg));
797 saved_flags = GTK_WIDGET_FLAGS (widget);
798 if (GTK_VALUE_BOOL (*arg))
799 GTK_WIDGET_SET_FLAGS (widget, GTK_CAN_FOCUS);
801 GTK_WIDGET_UNSET_FLAGS (widget, GTK_CAN_FOCUS);
802 if (saved_flags != GTK_WIDGET_FLAGS (widget))
803 gtk_widget_queue_resize (widget);
806 if (GTK_VALUE_BOOL (*arg))
807 gtk_widget_grab_focus (widget);
809 case ARG_CAN_DEFAULT:
810 saved_flags = GTK_WIDGET_FLAGS (widget);
811 if (GTK_VALUE_BOOL (*arg))
812 GTK_WIDGET_SET_FLAGS (widget, GTK_CAN_DEFAULT);
814 GTK_WIDGET_UNSET_FLAGS (widget, GTK_CAN_DEFAULT);
815 if (saved_flags != GTK_WIDGET_FLAGS (widget))
816 gtk_widget_queue_resize (widget);
818 case ARG_HAS_DEFAULT:
819 if (GTK_VALUE_BOOL (*arg))
820 gtk_widget_grab_default (widget);
823 gtk_widget_set_style (widget, (GtkStyle*) GTK_VALUE_BOXED (*arg));
826 gtk_widget_set_events (widget, GTK_VALUE_FLAGS (*arg));
828 case ARG_EXTENSION_EVENTS:
829 gtk_widget_set_extension_events (widget, GTK_VALUE_FLAGS (*arg));
832 arg->type = GTK_TYPE_INVALID;
837 /*****************************************
838 * gtk_widget_get_arg:
843 *****************************************/
846 gtk_widget_get_arg (GtkWidget *widget,
850 GtkWidgetAuxInfo *aux_info;
852 GdkExtensionMode *modep;
858 GTK_VALUE_STRING (*arg) = g_strdup (widget->name);
860 GTK_VALUE_STRING (*arg) = g_strdup ("");
863 GTK_VALUE_OBJECT (*arg) = (GtkObject*) widget->parent;
866 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
868 GTK_VALUE_INT (*arg) = -2;
870 GTK_VALUE_INT (*arg) = aux_info->x;
873 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
875 GTK_VALUE_INT (*arg) = -2;
877 GTK_VALUE_INT (*arg) = aux_info->y;
880 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
882 GTK_VALUE_INT (*arg) = -2;
884 GTK_VALUE_INT (*arg) = aux_info->width;
887 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
889 GTK_VALUE_INT (*arg) = -2;
891 GTK_VALUE_INT (*arg) = aux_info->height;
894 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_VISIBLE (widget) != FALSE);
897 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_SENSITIVE (widget) != FALSE);
900 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_CAN_FOCUS (widget) != FALSE);
903 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_HAS_FOCUS (widget) != FALSE);
905 case ARG_CAN_DEFAULT:
906 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_CAN_DEFAULT (widget) != FALSE);
908 case ARG_HAS_DEFAULT:
909 GTK_VALUE_BOOL (*arg) = (GTK_WIDGET_HAS_DEFAULT (widget) != FALSE);
912 GTK_VALUE_BOXED (*arg) = (gpointer) gtk_widget_get_style (widget);
915 eventp = gtk_object_get_data_by_id (GTK_OBJECT (widget), event_key_id);
917 GTK_VALUE_FLAGS (*arg) = 0;
919 GTK_VALUE_FLAGS (*arg) = *eventp;
921 case ARG_EXTENSION_EVENTS:
922 modep = gtk_object_get_data_by_id (GTK_OBJECT (widget), extension_event_key_id);
924 GTK_VALUE_FLAGS (*arg) = 0;
926 GTK_VALUE_FLAGS (*arg) = *modep;
929 arg->type = GTK_TYPE_INVALID;
934 /*****************************************
940 *****************************************/
943 gtk_widget_init (GtkWidget *widget)
945 GdkColormap *colormap;
948 GTK_PRIVATE_FLAGS (widget) = 0;
949 widget->state = GTK_STATE_NORMAL;
950 widget->saved_state = GTK_STATE_NORMAL;
952 widget->requisition.width = 0;
953 widget->requisition.height = 0;
954 widget->allocation.x = -1;
955 widget->allocation.y = -1;
956 widget->allocation.width = 1;
957 widget->allocation.height = 1;
958 widget->window = NULL;
959 widget->parent = NULL;
961 GTK_WIDGET_SET_FLAGS (widget, GTK_SENSITIVE | GTK_PARENT_SENSITIVE);
963 widget->style = gtk_widget_peek_style ();
964 gtk_style_ref (widget->style);
966 colormap = gtk_widget_peek_colormap ();
967 visual = gtk_widget_peek_visual ();
969 /* XXX - should we ref the colormap and visual, too? */
971 if (colormap != gtk_widget_get_default_colormap ())
973 /* gdk_colormap_ref (colormap); */
974 gtk_object_set_data (GTK_OBJECT (widget), colormap_key, colormap);
977 if (visual != gtk_widget_get_default_visual ())
979 /* gdk_visual_ref (visual); */
980 gtk_object_set_data (GTK_OBJECT (widget), visual_key, visual);
984 /*****************************************
990 *****************************************/
993 gtk_widget_new (guint type,
1002 g_return_val_if_fail (GTK_TYPE_IS_A (type, gtk_widget_get_type ()), NULL);
1004 obj = gtk_type_new (type);
1006 va_start (args1, type);
1007 va_start (args2, type);
1009 args = gtk_object_collect_args (&nargs, args1, args2);
1010 gtk_object_setv (obj, nargs, args);
1016 return GTK_WIDGET (obj);
1019 /*****************************************
1025 *****************************************/
1028 gtk_widget_newv (guint type,
1032 g_return_val_if_fail (GTK_TYPE_IS_A (type, gtk_widget_get_type ()), NULL);
1034 return GTK_WIDGET (gtk_object_newv (type, nargs, args));
1037 /*****************************************
1043 *****************************************/
1046 gtk_widget_get (GtkWidget *widget,
1049 g_return_if_fail (widget != NULL);
1050 g_return_if_fail (arg != NULL);
1052 gtk_object_getv (GTK_OBJECT (widget), 1, arg);
1055 /*****************************************
1061 *****************************************/
1064 gtk_widget_getv (GtkWidget *widget,
1068 gtk_object_getv (GTK_OBJECT (widget), nargs, args);
1071 /*****************************************
1077 *****************************************/
1080 gtk_widget_set (GtkWidget *widget,
1088 g_return_if_fail (widget != NULL);
1090 va_start (args1, widget);
1091 va_start (args2, widget);
1093 args = gtk_object_collect_args (&nargs, args1, args2);
1094 gtk_object_setv (GTK_OBJECT (widget), nargs, args);
1101 /*****************************************
1107 *****************************************/
1110 gtk_widget_setv (GtkWidget *widget,
1114 gtk_object_setv (GTK_OBJECT (widget), nargs, args);
1117 /*****************************************
1118 * gtk_widget_unparent:
1119 * do any cleanup necessary necessary
1120 * for setting parent = NULL.
1125 *****************************************/
1128 gtk_widget_unparent (GtkWidget *widget)
1130 GtkWidget *toplevel;
1131 GtkWidget *old_parent;
1132 GSList *tmp_list, *prev_list;
1134 g_return_if_fail (widget != NULL);
1135 if (widget->parent == NULL)
1138 /* keep this function in sync with gtk_menu_detach()
1141 /* unset focused and default children properly
1143 toplevel = gtk_widget_get_toplevel (widget);
1144 if (GTK_CONTAINER (widget->parent)->focus_child == widget)
1146 gtk_container_set_focus_child (GTK_CONTAINER (widget->parent), NULL);
1148 if (GTK_IS_WINDOW (toplevel))
1152 child = GTK_WINDOW (toplevel)->focus_widget;
1154 while (child && child != widget)
1155 child = child->parent;
1157 if (child == widget)
1158 gtk_window_set_focus (GTK_WINDOW (toplevel), NULL);
1161 if (GTK_IS_WINDOW (toplevel))
1165 child = GTK_WINDOW (toplevel)->default_widget;
1167 while (child && child != widget)
1168 child = child->parent;
1170 if (child == widget)
1171 gtk_window_set_default (GTK_WINDOW (toplevel), NULL);
1174 /* Remove the widget and all its children from toplevel->resize_widgets
1177 /* Three ways to make this prettier:
1178 * Write a g_slist_conditional_remove (GSList, gboolean (*)(gpointer))
1179 * Change resize_widgets to a GList
1180 * Just bite the bullet and use g_slist_remove
1182 tmp_list = GTK_CONTAINER (toplevel)->resize_widgets;
1186 GSList *tmp = tmp_list;
1187 GtkWidget *child = (GtkWidget *)tmp->data;
1188 GtkWidget *parent = child;
1190 tmp_list = tmp_list->next;
1192 while (parent && (parent != widget))
1193 parent = parent->parent;
1195 if (parent == widget)
1197 GTK_PRIVATE_UNSET_FLAG (child, GTK_RESIZE_NEEDED);
1200 prev_list->next = tmp_list;
1202 GTK_CONTAINER (toplevel)->resize_widgets = tmp_list;
1206 g_slist_free_1 (tmp);
1212 if (widget->window &&
1213 GTK_WIDGET_NO_WINDOW (widget) &&
1214 GTK_WIDGET_DRAWABLE (widget))
1215 gdk_window_clear_area (widget->window,
1216 widget->allocation.x,
1217 widget->allocation.y,
1218 widget->allocation.width,
1219 widget->allocation.height);
1221 /* Reset the width and height here, to force reallocation if we
1222 * get added back to a new parent. This won't work if our new
1223 * allocation is smaller than 1x1 and we actually want a size of 1x1...
1224 * (would 0x0 be OK here?)
1226 widget->allocation.width = 1;
1227 widget->allocation.height = 1;
1229 if (GTK_WIDGET_REALIZED (widget) && !GTK_WIDGET_IN_REPARENT (widget))
1230 gtk_widget_unrealize (widget);
1232 old_parent = widget->parent;
1233 widget->parent = NULL;
1234 gtk_widget_set_parent_window (widget, NULL);
1235 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[PARENT_SET], old_parent);
1237 gtk_widget_unref (widget);
1240 /*****************************************
1241 * gtk_widget_destroy:
1246 *****************************************/
1249 gtk_widget_destroy (GtkWidget *widget)
1251 g_return_if_fail (widget != NULL);
1252 g_return_if_fail (GTK_IS_WIDGET (widget));
1254 gtk_object_destroy ((GtkObject*) widget);
1257 /*****************************************
1258 * gtk_widget_destroyed:
1259 * Utility function: sets widget_pointer
1260 * to NULL when widget is destroyed.
1265 *****************************************/
1268 gtk_widget_destroyed (GtkWidget *widget,
1269 GtkWidget **widget_pointer)
1271 /* Don't make any assumptions about the
1273 * Even check widget_pointer.
1276 *widget_pointer = NULL;
1279 /*****************************************
1285 *****************************************/
1288 gtk_widget_show (GtkWidget *widget)
1290 g_return_if_fail (widget != NULL);
1292 if (!GTK_WIDGET_VISIBLE (widget))
1293 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[SHOW]);
1297 /*************************************************************
1298 * gtk_widget_show_now:
1299 * Show a widget, and if it is an unmapped toplevel widget
1300 * wait for the map_event before returning
1302 * Warning: This routine will call the main loop recursively.
1307 *************************************************************/
1310 gtk_widget_show_map_callback (GtkWidget *widget, GdkEvent *event, gint *flag)
1313 gtk_signal_disconnect_by_data (GTK_OBJECT (widget), flag);
1317 gtk_widget_show_now (GtkWidget *widget)
1321 /* make sure we will get event */
1322 if (!GTK_WIDGET_MAPPED (widget) &&
1323 GTK_WIDGET_TOPLEVEL (widget))
1325 gtk_widget_show (widget);
1327 gtk_signal_connect (GTK_OBJECT (widget), "map_event",
1328 GTK_SIGNAL_FUNC (gtk_widget_show_map_callback),
1332 gtk_main_iteration();
1335 gtk_widget_show (widget);
1338 /*****************************************
1344 *****************************************/
1347 gtk_widget_hide (GtkWidget *widget)
1349 g_return_if_fail (widget != NULL);
1350 g_return_if_fail (GTK_IS_WIDGET (widget));
1352 if (GTK_WIDGET_VISIBLE (widget))
1353 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[HIDE]);
1357 gtk_widget_hide_on_delete (GtkWidget *widget)
1359 g_return_val_if_fail (widget != NULL, FALSE);
1360 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
1362 gtk_widget_hide (widget);
1367 /*****************************************
1368 * gtk_widget_show_all:
1370 * Shows the widget and all children.
1372 * Container classes overwrite
1373 * show_all and hide_all to call
1374 * show_all (hide_all) on both themselves
1375 * and on their child widgets.
1380 *****************************************/
1383 gtk_widget_show_all (GtkWidget *widget)
1385 GtkWidgetClass *widget_class;
1387 g_return_if_fail (widget != NULL);
1389 /* show_all shouldn't be invoked through a signal,
1390 because in this case it would be quite slow - there would
1391 be a show and show_all signal emitted for every child widget.
1393 widget_class = GTK_WIDGET_CLASS(GTK_OBJECT(widget)->klass);
1394 widget_class->show_all (widget);
1397 /*****************************************
1398 * gtk_widget_hide_all:
1400 * Hides the widget and all children.
1401 * See gtk_widget_show_all.
1406 *****************************************/
1409 gtk_widget_hide_all (GtkWidget *widget)
1411 g_return_if_fail (widget != NULL);
1412 g_assert (widget->parent);
1414 if (GTK_WIDGET_RESIZE_NEEDED (widget))
1416 GtkWidget *toplevel;
1418 toplevel = gtk_widget_get_toplevel (widget);
1419 GTK_CONTAINER (toplevel)->resize_widgets =
1420 g_slist_remove (GTK_CONTAINER (toplevel)->resize_widgets, widget);
1421 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_NEEDED);
1424 GTK_WIDGET_CLASS (GTK_OBJECT (widget)->klass)->hide_all (widget);
1427 /*****************************************
1433 *****************************************/
1436 gtk_widget_map (GtkWidget *widget)
1438 g_return_if_fail (widget != NULL);
1440 if (!GTK_WIDGET_MAPPED (widget))
1442 if (!GTK_WIDGET_REALIZED (widget))
1443 gtk_widget_realize (widget);
1445 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[MAP]);
1449 /*****************************************
1455 *****************************************/
1458 gtk_widget_unmap (GtkWidget *widget)
1460 g_return_if_fail (widget != NULL);
1462 if (GTK_WIDGET_MAPPED (widget))
1463 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[UNMAP]);
1466 /*****************************************
1467 * gtk_widget_realize:
1472 *****************************************/
1475 gtk_widget_realize (GtkWidget *widget)
1478 GdkExtensionMode mode;
1479 GtkWidgetShapeInfo *shape_info;
1481 g_return_if_fail (widget != NULL);
1483 if (!GTK_WIDGET_REALIZED (widget))
1486 if (GTK_IS_CONTAINER (widget) && !GTK_WIDGET_NO_WINDOW (widget))
1487 g_print ("%s\n", gtk_type_name (GTK_WIDGET_TYPE (widget)));
1490 if (widget->parent && !GTK_WIDGET_REALIZED (widget->parent))
1491 gtk_widget_realize (widget->parent);
1493 gtk_widget_ensure_style (widget);
1495 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[REALIZE]);
1497 if (GTK_WIDGET_HAS_SHAPE_MASK (widget))
1499 shape_info = gtk_object_get_data (GTK_OBJECT (widget),
1501 gdk_window_shape_combine_mask (widget->window,
1502 shape_info->shape_mask,
1503 shape_info->offset_x,
1504 shape_info->offset_y);
1507 if (!GTK_WIDGET_NO_WINDOW (widget))
1509 mode = gtk_widget_get_extension_events (widget);
1510 if (mode != GDK_EXTENSION_EVENTS_NONE)
1512 events = gtk_widget_get_events (widget);
1513 gdk_input_set_extension_events (widget->window, events, mode);
1520 /*****************************************
1521 * gtk_widget_unrealize:
1526 *****************************************/
1529 gtk_widget_unrealize (GtkWidget *widget)
1531 g_return_if_fail (widget != NULL);
1533 if (GTK_WIDGET_REDRAW_PENDING (widget))
1535 gtk_widget_redraw_queue = g_slist_remove (gtk_widget_redraw_queue, widget);
1536 GTK_PRIVATE_UNSET_FLAG (widget, GTK_REDRAW_PENDING);
1539 if (GTK_WIDGET_HAS_SHAPE_MASK (widget))
1540 gtk_widget_shape_combine_mask (widget, NULL, -1, -1);
1542 if (GTK_WIDGET_REALIZED (widget))
1544 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[UNREALIZE]);
1545 GTK_WIDGET_UNSET_FLAGS (widget, GTK_REALIZED | GTK_MAPPED);
1549 /*****************************************
1550 * gtk_widget_queue_draw:
1555 *****************************************/
1558 gtk_widget_idle_draw (void *data)
1562 node = gtk_widget_redraw_queue;
1563 gtk_widget_redraw_queue = NULL;
1566 gtk_widget_real_queue_draw ((GtkWidget*) node->data);
1570 return gtk_widget_redraw_queue != NULL;
1574 gtk_widget_queue_draw (GtkWidget *widget)
1578 g_return_if_fail (widget != NULL);
1580 if (GTK_WIDGET_DRAWABLE (widget))
1582 /* We queue the redraw if:
1583 * a) the widget is not already queued for redraw and
1584 * b) non of the widgets ancestors are queued for redraw.
1589 if (GTK_WIDGET_REDRAW_PENDING (parent))
1591 parent = parent->parent;
1594 GTK_PRIVATE_SET_FLAG (widget, GTK_REDRAW_PENDING);
1595 if (gtk_widget_redraw_queue == NULL)
1596 gtk_idle_add_priority (GTK_PRIORITY_INTERNAL,
1597 (GtkFunction) gtk_widget_idle_draw, NULL);
1599 gtk_widget_redraw_queue = g_slist_prepend (gtk_widget_redraw_queue, widget);
1603 /*****************************************
1604 * gtk_widget_queue_resize:
1609 *****************************************/
1612 gtk_widget_idle_sizer (void *data)
1614 GSList *slist, *free_slist;
1616 free_slist = gtk_widget_resize_queue;
1617 gtk_widget_resize_queue = NULL;
1619 for (slist = free_slist; slist; slist = slist->next)
1623 widget = slist->data;
1625 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_PENDING);
1626 if (gtk_container_need_resize (GTK_CONTAINER (widget)))
1627 gtk_widget_queue_resize (widget);
1629 g_slist_free (free_slist);
1631 return gtk_widget_resize_queue != NULL;
1635 gtk_widget_queue_resize (GtkWidget *widget)
1637 GtkWidget *toplevel;
1639 g_return_if_fail (widget != NULL);
1641 toplevel = gtk_widget_get_toplevel (widget);
1642 if (GTK_WIDGET_TOPLEVEL (toplevel))
1644 if (GTK_WIDGET_VISIBLE (toplevel))
1646 if (!GTK_CONTAINER_RESIZE_PENDING (toplevel))
1648 GTK_PRIVATE_SET_FLAG (toplevel, GTK_RESIZE_PENDING);
1649 if (gtk_widget_resize_queue == NULL)
1650 gtk_idle_add_priority (GTK_PRIORITY_INTERNAL,
1651 (GtkFunction) gtk_widget_idle_sizer, NULL);
1652 gtk_widget_resize_queue = g_slist_prepend (gtk_widget_resize_queue, toplevel);
1655 if (!GTK_WIDGET_RESIZE_NEEDED (widget))
1657 GTK_PRIVATE_SET_FLAG (widget, GTK_RESIZE_NEEDED);
1658 GTK_CONTAINER (toplevel)->resize_widgets =
1659 g_slist_prepend (GTK_CONTAINER (toplevel)->resize_widgets, widget);
1662 g_assert (g_slist_find (GTK_CONTAINER (toplevel)->resize_widgets, widget)); /* paranoid */
1665 gtk_container_need_resize (GTK_CONTAINER (toplevel));
1669 /*****************************************
1675 *****************************************/
1678 gtk_widget_draw (GtkWidget *widget,
1681 GdkRectangle temp_area;
1683 g_return_if_fail (widget != NULL);
1685 if (GTK_WIDGET_REDRAW_PENDING (widget))
1687 gtk_widget_redraw_queue = g_slist_remove (gtk_widget_redraw_queue, widget);
1688 GTK_PRIVATE_UNSET_FLAG (widget, GTK_REDRAW_PENDING);
1693 if (GTK_WIDGET_DRAWABLE (widget))
1697 if (GTK_WIDGET_NO_WINDOW (widget))
1699 temp_area.x = widget->allocation.x;
1700 temp_area.y = widget->allocation.y;
1708 temp_area.width = widget->allocation.width;
1709 temp_area.height = widget->allocation.height;
1713 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[DRAW], area);
1717 /*****************************************
1718 * gtk_widget_draw_focus:
1723 *****************************************/
1726 gtk_widget_draw_focus (GtkWidget *widget)
1728 g_return_if_fail (widget != NULL);
1730 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[DRAW_FOCUS]);
1733 /*****************************************
1734 * gtk_widget_draw_default:
1739 *****************************************/
1742 gtk_widget_draw_default (GtkWidget *widget)
1744 g_return_if_fail (widget != NULL);
1746 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[DRAW_DEFAULT]);
1749 /*****************************************
1750 * gtk_widget_draw_children:
1755 *****************************************/
1758 gtk_widget_draw_children (GtkWidget *widget)
1760 g_return_if_fail (widget != NULL);
1762 if (GTK_IS_CONTAINER (widget))
1763 gtk_container_foreach (GTK_CONTAINER (widget),
1764 gtk_widget_draw_children_recurse,
1768 /*****************************************
1769 * gtk_widget_size_request:
1774 *****************************************/
1777 gtk_widget_size_request (GtkWidget *widget,
1778 GtkRequisition *requisition)
1780 GtkWidgetAuxInfo *aux_info;
1782 g_return_if_fail (widget != NULL);
1784 gtk_widget_ref (widget);
1785 gtk_widget_ensure_style (widget);
1786 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[SIZE_REQUEST],
1788 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
1791 if (aux_info->width > 0)
1792 requisition->width = aux_info->width;
1793 if (aux_info->height > 0)
1794 requisition->height = aux_info->height;
1796 gtk_widget_unref (widget);
1799 /*****************************************
1800 * gtk_widget_size_allocate:
1805 *****************************************/
1808 gtk_widget_size_allocate (GtkWidget *widget,
1809 GtkAllocation *allocation)
1811 GtkWidgetAuxInfo *aux_info;
1812 GtkAllocation real_allocation;
1814 g_return_if_fail (widget != NULL);
1816 real_allocation = *allocation;
1817 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
1821 if (aux_info->x != -1)
1822 real_allocation.x = aux_info->x;
1823 if (aux_info->y != -1)
1824 real_allocation.y = aux_info->y;
1827 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[SIZE_ALLOCATE], &real_allocation);
1830 /*****************************************
1831 * gtk_widget_install_accelerator:
1836 *****************************************/
1839 gtk_widget_install_accelerator (GtkWidget *widget,
1840 GtkAcceleratorTable *table,
1841 const gchar *signal_name,
1847 g_return_if_fail (widget != NULL);
1849 gtk_widget_ref (widget);
1851 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[INSTALL_ACCELERATOR],
1852 signal_name, key, modifiers, &return_val);
1854 gtk_accelerator_table_install (table,
1855 GTK_OBJECT (widget),
1859 gtk_widget_unref (widget);
1862 /*****************************************
1863 * gtk_widget_remove_accelerator:
1868 *****************************************/
1871 gtk_widget_remove_accelerator (GtkWidget *widget,
1872 GtkAcceleratorTable *table,
1873 const gchar *signal_name)
1875 g_return_if_fail (widget != NULL);
1877 gtk_widget_ref (widget);
1878 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[REMOVE_ACCELERATOR],
1880 gtk_accelerator_table_remove (table, GTK_OBJECT (widget), signal_name);
1881 gtk_widget_unref (widget);
1884 /*****************************************
1890 *****************************************/
1893 gtk_widget_event (GtkWidget *widget,
1899 g_return_val_if_fail (widget != NULL, TRUE);
1901 gtk_widget_ref (widget);
1903 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[EVENT], event,
1905 if (return_val || GTK_OBJECT_DESTROYED (widget))
1907 gtk_widget_unref (widget);
1911 switch (event->type)
1916 case GDK_BUTTON_PRESS:
1917 case GDK_2BUTTON_PRESS:
1918 case GDK_3BUTTON_PRESS:
1919 signal_num = BUTTON_PRESS_EVENT;
1921 case GDK_BUTTON_RELEASE:
1922 signal_num = BUTTON_RELEASE_EVENT;
1924 case GDK_MOTION_NOTIFY:
1925 signal_num = MOTION_NOTIFY_EVENT;
1928 signal_num = DELETE_EVENT;
1931 signal_num = DESTROY_EVENT;
1934 signal_num = KEY_PRESS_EVENT;
1936 case GDK_KEY_RELEASE:
1937 signal_num = KEY_RELEASE_EVENT;
1939 case GDK_ENTER_NOTIFY:
1940 signal_num = ENTER_NOTIFY_EVENT;
1942 case GDK_LEAVE_NOTIFY:
1943 signal_num = LEAVE_NOTIFY_EVENT;
1945 case GDK_FOCUS_CHANGE:
1946 if (event->focus_change.in)
1947 signal_num = FOCUS_IN_EVENT;
1949 signal_num = FOCUS_OUT_EVENT;
1952 signal_num = CONFIGURE_EVENT;
1955 signal_num = MAP_EVENT;
1958 signal_num = UNMAP_EVENT;
1960 case GDK_PROPERTY_NOTIFY:
1961 signal_num = PROPERTY_NOTIFY_EVENT;
1963 case GDK_SELECTION_CLEAR:
1964 signal_num = SELECTION_CLEAR_EVENT;
1966 case GDK_SELECTION_REQUEST:
1967 signal_num = SELECTION_REQUEST_EVENT;
1969 case GDK_SELECTION_NOTIFY:
1970 signal_num = SELECTION_NOTIFY_EVENT;
1972 case GDK_PROXIMITY_IN:
1973 signal_num = PROXIMITY_IN_EVENT;
1975 case GDK_PROXIMITY_OUT:
1976 signal_num = PROXIMITY_OUT_EVENT;
1978 case GDK_DRAG_BEGIN:
1979 signal_num = DRAG_BEGIN_EVENT;
1981 case GDK_DRAG_REQUEST:
1982 signal_num = DRAG_REQUEST_EVENT;
1984 case GDK_DROP_ENTER:
1985 signal_num = DROP_ENTER_EVENT;
1987 case GDK_DROP_LEAVE:
1988 signal_num = DROP_LEAVE_EVENT;
1990 case GDK_DROP_DATA_AVAIL:
1991 signal_num = DROP_DATA_AVAILABLE_EVENT;
1993 case GDK_OTHER_EVENT:
1994 signal_num = OTHER_EVENT;
1997 signal_num = NO_EXPOSE_EVENT;
1999 case GDK_CLIENT_EVENT:
2000 signal_num = CLIENT_EVENT;
2003 /* there is no sense in providing a widget with bogus expose events
2005 if (!event->any.window)
2007 gtk_widget_unref (widget);
2010 signal_num = EXPOSE_EVENT;
2013 g_warning ("could not determine signal number for event: %d", event->type);
2014 gtk_widget_unref (widget);
2018 if (signal_num != -1)
2019 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[signal_num], event, &return_val);
2021 return_val |= GTK_OBJECT_DESTROYED (widget);
2023 gtk_widget_unref (widget);
2028 /*****************************************
2029 * gtk_widget_activate:
2034 *****************************************/
2037 gtk_widget_activate (GtkWidget *widget)
2039 g_return_if_fail (widget != NULL);
2040 g_return_if_fail (GTK_IS_WIDGET (widget));
2042 if (WIDGET_CLASS (widget)->activate_signal)
2043 gtk_signal_emit (GTK_OBJECT (widget), WIDGET_CLASS (widget)->activate_signal);
2046 /*****************************************
2047 * gtk_widget_reparent_container_child:
2048 * assistent function to gtk_widget_reparent
2053 *****************************************/
2056 gtk_widget_reparent_container_child(GtkWidget *widget,
2057 gpointer client_data)
2059 g_return_if_fail (widget != NULL);
2060 g_return_if_fail (client_data != NULL);
2062 if (GTK_WIDGET_NO_WINDOW (widget))
2065 gdk_window_unref (widget->window);
2066 widget->window = (GdkWindow*) client_data;
2068 gdk_window_ref (widget->window);
2070 if (GTK_IS_CONTAINER (widget))
2071 gtk_container_foreach (GTK_CONTAINER (widget),
2072 gtk_widget_reparent_container_child,
2076 gdk_window_reparent (widget->window,
2077 (GdkWindow*) client_data, 0, 0);
2080 /*****************************************
2081 * gtk_widget_reparent:
2086 *****************************************/
2089 gtk_widget_reparent (GtkWidget *widget,
2090 GtkWidget *new_parent)
2092 g_return_if_fail (widget != NULL);
2093 g_return_if_fail (GTK_IS_WIDGET (widget));
2094 g_return_if_fail (new_parent != NULL);
2095 g_return_if_fail (GTK_IS_CONTAINER (new_parent));
2096 g_return_if_fail (widget->parent != NULL);
2098 if (widget->parent != new_parent)
2100 /* First try to see if we can get away without unrealizing
2101 * the widget as we reparent it. if so we set a flag so
2102 * that gtk_widget_unparent doesn't unrealize widget
2104 if (GTK_WIDGET_REALIZED (widget) && GTK_WIDGET_REALIZED (new_parent))
2105 GTK_PRIVATE_SET_FLAG (widget, GTK_IN_REPARENT);
2107 gtk_widget_ref (widget);
2108 gtk_container_remove (GTK_CONTAINER (widget->parent), widget);
2109 gtk_container_add (GTK_CONTAINER (new_parent), widget);
2110 gtk_widget_unref (widget);
2112 if (GTK_WIDGET_IN_REPARENT (widget))
2114 GTK_PRIVATE_UNSET_FLAG (widget, GTK_IN_REPARENT);
2116 /* OK, now fix up the widget's window. (And that for any
2117 * children, if the widget is NO_WINDOW and a container)
2119 if (GTK_WIDGET_NO_WINDOW (widget))
2121 if (GTK_IS_CONTAINER (widget))
2122 gtk_container_foreach (GTK_CONTAINER (widget),
2123 gtk_widget_reparent_container_child,
2124 gtk_widget_get_parent_window (widget));
2127 GdkWindow *parent_window;
2129 parent_window = gtk_widget_get_parent_window (widget);
2130 if (parent_window != widget->window)
2133 gdk_window_unref (widget->window);
2134 widget->window = parent_window;
2136 gdk_window_ref (widget->window);
2141 gdk_window_reparent (widget->window, gtk_widget_get_parent_window (widget), 0, 0);
2146 /*****************************************
2152 *****************************************/
2155 gtk_widget_popup (GtkWidget *widget,
2159 g_return_if_fail (widget != NULL);
2161 if (!GTK_WIDGET_VISIBLE (widget))
2163 if (!GTK_WIDGET_REALIZED (widget))
2164 gtk_widget_realize (widget);
2165 if (!GTK_WIDGET_NO_WINDOW (widget))
2166 gdk_window_move (widget->window, x, y);
2167 gtk_widget_show (widget);
2171 /*****************************************
2172 * gtk_widget_intersect:
2177 *****************************************/
2180 gtk_widget_intersect (GtkWidget *widget,
2182 GdkRectangle *intersection)
2188 g_return_val_if_fail (widget != NULL, FALSE);
2189 g_return_val_if_fail (area != NULL, FALSE);
2192 dest = intersection;
2196 return_val = gdk_rectangle_intersect ((GdkRectangle*) &widget->allocation, area, dest);
2198 if (return_val && intersection && !GTK_WIDGET_NO_WINDOW (widget))
2200 intersection->x -= widget->allocation.x;
2201 intersection->y -= widget->allocation.y;
2209 gtk_widget_basic (GtkWidget *widget)
2215 g_return_val_if_fail (widget != NULL, FALSE);
2217 if (!GTK_WIDGET_BASIC (widget))
2219 else if (GTK_IS_CONTAINER (widget))
2221 children = gtk_container_children (GTK_CONTAINER (widget));
2225 tmp_list = children;
2229 if (!gtk_widget_basic (GTK_WIDGET (tmp_list->data)))
2235 tmp_list = tmp_list->next;
2238 g_list_free (children);
2247 /*****************************************
2248 * gtk_widget_grab_focus:
2253 *****************************************/
2256 gtk_widget_grab_focus (GtkWidget *widget)
2258 g_return_if_fail (widget != NULL);
2259 g_return_if_fail (GTK_IS_WIDGET (widget));
2261 if (GTK_WIDGET_CAN_FOCUS (widget))
2265 GtkType window_type;
2267 window_type = gtk_window_get_type ();
2268 parent = widget->parent;
2271 while (parent && !GTK_TYPE_IS_A (GTK_WIDGET_TYPE (parent), window_type))
2273 gtk_container_set_focus_child (GTK_CONTAINER (parent), child);
2275 parent = parent->parent;
2278 if (parent && GTK_TYPE_IS_A (GTK_WIDGET_TYPE (parent), window_type))
2280 gtk_container_set_focus_child (GTK_CONTAINER (parent), child);
2281 gtk_window_set_focus (GTK_WINDOW (parent), widget);
2286 /*****************************************
2287 * gtk_widget_grab_default:
2292 *****************************************/
2295 gtk_widget_grab_default (GtkWidget *widget)
2298 GtkType window_type;
2300 g_return_if_fail (widget != NULL);
2301 g_return_if_fail (GTK_WIDGET_CAN_DEFAULT (widget));
2303 window_type = gtk_window_get_type ();
2304 window = widget->parent;
2306 while (window && !GTK_TYPE_IS_A (GTK_WIDGET_TYPE (window), window_type))
2307 window = window->parent;
2309 if (window && GTK_TYPE_IS_A (GTK_WIDGET_TYPE (window), window_type))
2310 gtk_window_set_default (GTK_WINDOW (window), widget);
2313 /*****************************************
2314 * gtk_widget_set_name:
2319 *****************************************/
2322 gtk_widget_set_name (GtkWidget *widget,
2325 g_return_if_fail (widget != NULL);
2328 g_free (widget->name);
2329 widget->name = g_strdup (name);
2331 if (!GTK_WIDGET_USER_STYLE (widget))
2332 gtk_widget_set_rc_style (widget);
2335 /*****************************************
2336 * gtk_widget_get_name:
2341 *****************************************/
2344 gtk_widget_get_name (GtkWidget *widget)
2346 g_return_val_if_fail (widget != NULL, NULL);
2349 return widget->name;
2350 return gtk_type_name (GTK_WIDGET_TYPE (widget));
2353 /*****************************************
2354 * gtk_widget_set_state:
2361 *****************************************/
2364 gtk_widget_set_state (GtkWidget *widget,
2367 g_return_if_fail (widget != NULL);
2368 g_return_if_fail (GTK_IS_WIDGET (widget));
2370 if (state == GTK_WIDGET_STATE (widget))
2373 if (state == GTK_STATE_INSENSITIVE)
2374 gtk_widget_set_sensitive (widget, FALSE);
2380 data.state_restauration = FALSE;
2382 data.parent_sensitive = (GTK_WIDGET_IS_SENSITIVE (widget->parent) != FALSE);
2384 data.parent_sensitive = TRUE;
2386 gtk_widget_propagate_state (widget, &data);
2387 gtk_widget_queue_draw (widget);
2391 /*****************************************
2392 * gtk_widget_set_sensitive:
2396 * boolean value for sensitivity
2399 *****************************************/
2402 gtk_widget_set_sensitive (GtkWidget *widget,
2407 g_return_if_fail (widget != NULL);
2408 g_return_if_fail (GTK_IS_WIDGET (widget));
2410 sensitive = (sensitive != FALSE);
2412 if (sensitive == (GTK_WIDGET_SENSITIVE (widget) != FALSE))
2417 GTK_WIDGET_SET_FLAGS (widget, GTK_SENSITIVE);
2418 data.state = GTK_WIDGET_SAVED_STATE (widget);
2422 GTK_WIDGET_UNSET_FLAGS (widget, GTK_SENSITIVE);
2423 data.state = GTK_WIDGET_STATE (widget);
2425 data.state_restauration = TRUE;
2428 data.parent_sensitive = (GTK_WIDGET_IS_SENSITIVE (widget->parent) != FALSE);
2430 data.parent_sensitive = TRUE;
2432 gtk_widget_propagate_state (widget, &data);
2433 gtk_widget_queue_draw (widget);
2436 /*****************************************
2437 * gtk_widget_set_parent:
2442 *****************************************/
2445 gtk_widget_set_parent (GtkWidget *widget,
2450 g_return_if_fail (widget != NULL);
2451 g_return_if_fail (widget->parent == NULL);
2452 g_return_if_fail (!GTK_WIDGET_TOPLEVEL (widget));
2453 g_return_if_fail (parent != NULL);
2455 /* keep this function in sync with gtk_menu_attach_to_widget()
2458 gtk_widget_ref (widget);
2459 gtk_object_sink (GTK_OBJECT (widget));
2460 widget->parent = parent;
2462 if (GTK_WIDGET_STATE (parent) != GTK_STATE_NORMAL)
2463 data.state = GTK_WIDGET_STATE (parent);
2465 data.state = GTK_WIDGET_STATE (widget);
2466 data.state_restauration = FALSE;
2467 data.parent_sensitive = (GTK_WIDGET_IS_SENSITIVE (parent) != FALSE);
2469 gtk_widget_propagate_state (widget, &data);
2471 while (parent->parent != NULL)
2472 parent = parent->parent;
2474 gtk_widget_set_style_recurse (widget, NULL);
2476 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[PARENT_SET], NULL);
2479 /*****************************************
2481 * see docs/styles.txt
2482 *****************************************/
2484 gtk_widget_set_style (GtkWidget *widget,
2487 GtkStyle *default_style;
2488 gboolean initial_emission;
2490 g_return_if_fail (widget != NULL);
2491 g_return_if_fail (style != NULL);
2493 initial_emission = !GTK_WIDGET_RC_STYLE (widget) && !GTK_WIDGET_USER_STYLE (widget);
2495 GTK_WIDGET_UNSET_FLAGS (widget, GTK_RC_STYLE);
2496 GTK_PRIVATE_SET_FLAG (widget, GTK_USER_STYLE);
2498 default_style = gtk_object_get_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
2501 gtk_style_ref (widget->style);
2502 if (!saved_default_style_key_id)
2503 saved_default_style_key_id = gtk_object_data_force_id (saved_default_style_key);
2504 gtk_object_set_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id, widget->style);
2507 gtk_widget_set_style_internal (widget, style, initial_emission);
2511 gtk_widget_ensure_style (GtkWidget *widget)
2513 if (!GTK_WIDGET_USER_STYLE (widget) &&
2514 !GTK_WIDGET_RC_STYLE (widget))
2515 gtk_widget_set_rc_style (widget);
2519 gtk_widget_set_rc_style (GtkWidget *widget)
2521 GtkStyle *saved_style;
2522 GtkStyle *new_style;
2523 gboolean initial_emission;
2525 g_return_if_fail (widget != NULL);
2527 initial_emission = !GTK_WIDGET_RC_STYLE (widget) && !GTK_WIDGET_USER_STYLE (widget);
2529 GTK_PRIVATE_UNSET_FLAG (widget, GTK_USER_STYLE);
2530 GTK_WIDGET_SET_FLAGS (widget, GTK_RC_STYLE);
2532 saved_style = gtk_object_get_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
2533 new_style = gtk_rc_get_style (widget);
2538 gtk_style_ref (widget->style);
2539 if (!saved_default_style_key_id)
2540 saved_default_style_key_id = gtk_object_data_force_id (saved_default_style_key);
2541 gtk_object_set_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id, widget->style);
2543 gtk_widget_set_style_internal (widget, new_style, initial_emission);
2549 g_assert (initial_emission == FALSE); /* FIXME: remove this line */
2551 gtk_object_remove_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
2552 gtk_widget_set_style_internal (widget, saved_style, initial_emission);
2553 gtk_style_unref (saved_style);
2557 if (initial_emission)
2558 gtk_widget_set_style_internal (widget, widget->style, TRUE);
2564 gtk_widget_restore_default_style (GtkWidget *widget)
2566 GtkStyle *default_style;
2568 g_return_if_fail (widget != NULL);
2570 GTK_PRIVATE_UNSET_FLAG (widget, GTK_USER_STYLE);
2572 default_style = gtk_object_get_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
2575 gtk_object_remove_data_by_id (GTK_OBJECT (widget), saved_default_style_key_id);
2576 gtk_widget_set_style_internal (widget, default_style, FALSE);
2577 gtk_style_unref (default_style);
2582 gtk_widget_get_style (GtkWidget *widget)
2584 g_return_val_if_fail (widget != NULL, NULL);
2586 return widget->style;
2590 gtk_widget_style_set (GtkWidget *widget,
2591 GtkStyle *previous_style)
2593 if (GTK_WIDGET_REALIZED (widget) &&
2594 !GTK_WIDGET_NO_WINDOW (widget))
2596 gtk_style_set_background (widget->style, widget->window, widget->state);
2597 if (GTK_WIDGET_DRAWABLE (widget))
2598 gdk_window_clear (widget->window);
2603 gtk_widget_set_style_internal (GtkWidget *widget,
2605 gboolean initial_emission)
2607 g_return_if_fail (widget != NULL);
2608 g_return_if_fail (style != NULL);
2610 if (widget->style != style)
2612 GtkStyle *previous_style;
2614 if (GTK_WIDGET_REALIZED (widget))
2615 gtk_style_detach (widget->style);
2617 previous_style = widget->style;
2618 widget->style = style;
2619 gtk_style_ref (widget->style);
2621 if (GTK_WIDGET_REALIZED (widget))
2622 widget->style = gtk_style_attach (widget->style, widget->window);
2624 gtk_signal_emit (GTK_OBJECT (widget),
2625 widget_signals[STYLE_SET],
2626 initial_emission ? NULL : previous_style);
2627 gtk_style_unref (previous_style);
2629 if (widget->parent && !initial_emission)
2631 GtkRequisition old_requisition;
2633 old_requisition = widget->requisition;
2634 gtk_widget_size_request (widget, &widget->requisition);
2636 if ((old_requisition.width != widget->requisition.width) ||
2637 (old_requisition.height != widget->requisition.height))
2638 gtk_widget_queue_resize (widget);
2639 else if (GTK_WIDGET_DRAWABLE (widget))
2640 gtk_widget_queue_draw (widget);
2643 else if (initial_emission)
2645 gtk_signal_emit (GTK_OBJECT (widget),
2646 widget_signals[STYLE_SET],
2652 gtk_widget_set_style_recurse (GtkWidget *widget,
2653 gpointer client_data)
2655 if (GTK_WIDGET_RC_STYLE (widget))
2656 gtk_widget_set_rc_style (widget);
2658 if (GTK_IS_CONTAINER (widget))
2659 gtk_container_foreach (GTK_CONTAINER (widget),
2660 gtk_widget_set_style_recurse,
2665 gtk_widget_reset_rc_styles (GtkWidget *widget)
2667 gtk_widget_set_style_recurse (widget, NULL);
2671 gtk_widget_set_default_style (GtkStyle *style)
2673 if (style != default_style)
2676 gtk_style_unref (default_style);
2677 default_style = style;
2679 gtk_style_ref (default_style);
2684 gtk_widget_get_default_style (void)
2688 default_style = gtk_style_new ();
2689 gtk_style_ref (default_style);
2692 return default_style;
2696 gtk_widget_push_style (GtkStyle *style)
2698 g_return_if_fail (style != NULL);
2700 gtk_style_ref (style);
2701 style_stack = g_slist_prepend (style_stack, style);
2705 gtk_widget_peek_style (void)
2708 return (GtkStyle*) style_stack->data;
2710 return gtk_widget_get_default_style ();
2714 gtk_widget_pop_style (void)
2721 style_stack = style_stack->next;
2722 gtk_style_unref ((GtkStyle*) tmp->data);
2723 g_slist_free_1 (tmp);
2727 /* Basically, send a message to all toplevel windows telling them
2728 * that a new _GTK_STYLE_COLORS property is available on the root
2732 gtk_widget_propagate_default_style (void)
2737 /* Set the property on the root window */
2738 gdk_property_change(GDK_ROOT_PARENT(),
2739 gdk_atom_intern("_GTK_DEFAULT_COLORS", FALSE),
2740 gdk_atom_intern("STRING", FALSE),
2742 GDK_PROP_MODE_REPLACE,
2743 (guchar *)gtk_widget_get_default_style(),
2744 GTK_STYLE_NUM_STYLECOLORS() * sizeof(GdkColor));
2746 for(i = 0; i < 5; i++)
2748 sev.data_format = 32;
2749 sev.message_type = gdk_atom_intern ("_GTK_STYLE_CHANGED", FALSE);
2750 gdk_event_send_clientmessage_toall ((GdkEvent *) &sev);
2753 /*************************************************************
2754 * gtk_widget_set_parent_window:
2755 * Set a non default parent window for widget
2762 *************************************************************/
2765 gtk_widget_set_parent_window (GtkWidget *widget,
2766 GdkWindow *parent_window)
2768 GdkWindow *old_parent_window;
2770 g_return_if_fail (widget != NULL);
2772 old_parent_window = gtk_object_get_data_by_id (GTK_OBJECT (widget),
2773 parent_window_key_id);
2775 if (parent_window != old_parent_window)
2777 if (!parent_window_key_id)
2778 parent_window_key_id = gtk_object_data_force_id (parent_window_key);
2779 gtk_object_set_data_by_id (GTK_OBJECT (widget), parent_window_key_id,
2781 if (old_parent_window)
2782 gdk_window_unref (old_parent_window);
2784 gdk_window_ref (parent_window);
2788 /*************************************************************
2789 * gtk_widget_get_parent_window:
2790 * Get widget's parent window
2797 *************************************************************/
2800 gtk_widget_get_parent_window (GtkWidget *widget)
2802 GdkWindow *parent_window;
2804 g_return_val_if_fail (widget != NULL, NULL);
2805 g_return_val_if_fail (GTK_IS_WIDGET (widget), NULL);
2806 g_return_val_if_fail (widget->parent != NULL, NULL);
2808 parent_window = gtk_object_get_data_by_id (GTK_OBJECT (widget),
2809 parent_window_key_id);
2811 return (parent_window != NULL) ? parent_window : widget->parent->window;
2814 /*****************************************
2815 * gtk_widget_set_uposition:
2820 *****************************************/
2823 gtk_widget_set_uposition (GtkWidget *widget,
2827 GtkWidgetAuxInfo *aux_info;
2829 g_return_if_fail (widget != NULL);
2831 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
2834 if (!aux_info_key_id)
2835 aux_info_key_id = gtk_object_data_force_id (aux_info_key);
2836 aux_info = gtk_widget_aux_info_new ();
2837 gtk_object_set_data_by_id (GTK_OBJECT (widget), aux_info_key_id, aux_info);
2845 if (GTK_WIDGET_REALIZED (widget) && GTK_IS_WINDOW (widget) &&
2846 (aux_info->x != -1) && (aux_info->y != -1))
2848 gdk_window_set_hints (widget->window, aux_info->x, aux_info->y, 0, 0, 0, 0, GDK_HINT_POS);
2849 gdk_window_move (widget->window, aux_info->x, aux_info->y);
2852 if (GTK_WIDGET_VISIBLE (widget) && widget->parent)
2853 gtk_widget_size_allocate (widget, &widget->allocation);
2856 /*****************************************
2857 * gtk_widget_set_usize:
2862 *****************************************/
2865 gtk_widget_set_usize (GtkWidget *widget,
2869 GtkWidgetAuxInfo *aux_info;
2871 g_return_if_fail (widget != NULL);
2873 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
2876 if (!aux_info_key_id)
2877 aux_info_key_id = gtk_object_data_force_id (aux_info_key);
2878 aux_info = gtk_widget_aux_info_new ();
2879 gtk_object_set_data_by_id (GTK_OBJECT (widget), aux_info_key_id, aux_info);
2883 aux_info->width = width;
2885 aux_info->height = height;
2887 if (GTK_WIDGET_VISIBLE (widget))
2888 gtk_widget_queue_resize (widget);
2891 /*****************************************
2892 * gtk_widget_set_events:
2897 *****************************************/
2900 gtk_widget_set_events (GtkWidget *widget,
2905 g_return_if_fail (widget != NULL);
2906 g_return_if_fail (!GTK_WIDGET_NO_WINDOW (widget));
2907 g_return_if_fail (!GTK_WIDGET_REALIZED (widget));
2909 eventp = gtk_object_get_data_by_id (GTK_OBJECT (widget), event_key_id);
2914 eventp = g_new (gint, 1);
2918 event_key_id = gtk_object_data_force_id (event_key);
2919 gtk_object_set_data_by_id (GTK_OBJECT (widget), event_key_id, eventp);
2924 gtk_object_remove_data_by_id (GTK_OBJECT (widget), event_key_id);
2928 /*****************************************
2929 * gtk_widget_set_extension_events:
2934 *****************************************/
2937 gtk_widget_set_extension_events (GtkWidget *widget,
2938 GdkExtensionMode mode)
2940 GdkExtensionMode *modep;
2942 g_return_if_fail (widget != NULL);
2944 modep = gtk_object_get_data_by_id (GTK_OBJECT (widget), extension_event_key_id);
2947 modep = g_new (GdkExtensionMode, 1);
2950 if (!extension_event_key_id)
2951 extension_event_key_id = gtk_object_data_force_id (extension_event_key);
2952 gtk_object_set_data_by_id (GTK_OBJECT (widget), extension_event_key_id, modep);
2956 /*****************************************
2957 * gtk_widget_get_toplevel:
2962 *****************************************/
2965 gtk_widget_get_toplevel (GtkWidget *widget)
2967 g_return_val_if_fail (widget != NULL, NULL);
2969 while (widget->parent)
2970 widget = widget->parent;
2975 /*****************************************
2976 * gtk_widget_get_ancestor:
2981 *****************************************/
2984 gtk_widget_get_ancestor (GtkWidget *widget,
2985 GtkType widget_type)
2987 g_return_val_if_fail (widget != NULL, NULL);
2989 while (widget && !GTK_TYPE_IS_A (GTK_WIDGET_TYPE (widget), widget_type))
2990 widget = widget->parent;
2992 if (!(widget && GTK_TYPE_IS_A (GTK_WIDGET_TYPE (widget), widget_type)))
2998 /*****************************************
2999 * gtk_widget_get_colormap:
3004 *****************************************/
3007 gtk_widget_get_colormap (GtkWidget *widget)
3009 GdkColormap *colormap;
3011 g_return_val_if_fail (widget != NULL, NULL);
3013 if (!widget->window)
3015 colormap = gtk_object_get_data (GTK_OBJECT (widget), colormap_key);
3018 return gtk_widget_get_default_colormap ();
3021 return gdk_window_get_colormap (widget->window);
3024 /*****************************************
3025 * gtk_widget_get_visual:
3030 *****************************************/
3033 gtk_widget_get_visual (GtkWidget *widget)
3037 g_return_val_if_fail (widget != NULL, NULL);
3039 if (!widget->window)
3041 visual = gtk_object_get_data (GTK_OBJECT (widget), visual_key);
3044 return gtk_widget_get_default_visual ();
3047 return gdk_window_get_visual (widget->window);
3050 /*****************************************
3051 * gtk_widget_get_events:
3056 *****************************************/
3059 gtk_widget_get_events (GtkWidget *widget)
3063 g_return_val_if_fail (widget != NULL, 0);
3065 events = gtk_object_get_data_by_id (GTK_OBJECT (widget), event_key_id);
3072 /*****************************************
3073 * gtk_widget_get_extension_events:
3078 *****************************************/
3081 gtk_widget_get_extension_events (GtkWidget *widget)
3083 GdkExtensionMode *mode;
3085 g_return_val_if_fail (widget != NULL, 0);
3087 mode = gtk_object_get_data_by_id (GTK_OBJECT (widget), extension_event_key_id);
3094 /*****************************************
3095 * gtk_widget_get_pointer:
3100 *****************************************/
3103 gtk_widget_get_pointer (GtkWidget *widget,
3107 g_return_if_fail (widget != NULL);
3114 if (GTK_WIDGET_REALIZED (widget))
3116 gdk_window_get_pointer (widget->window, x, y, NULL);
3118 if (GTK_WIDGET_NO_WINDOW (widget))
3121 *x -= widget->allocation.x;
3123 *y -= widget->allocation.y;
3128 /*****************************************
3129 * gtk_widget_is_ancestor:
3134 *****************************************/
3137 gtk_widget_is_ancestor (GtkWidget *widget,
3138 GtkWidget *ancestor)
3140 g_return_val_if_fail (widget != NULL, FALSE);
3141 g_return_val_if_fail (ancestor != NULL, FALSE);
3145 if (widget->parent == ancestor)
3147 widget = widget->parent;
3153 /*****************************************
3154 * gtk_widget_is_child:
3159 *****************************************/
3162 gtk_widget_is_child (GtkWidget *widget,
3165 g_return_val_if_fail (widget != NULL, FALSE);
3166 g_return_val_if_fail (child != NULL, FALSE);
3168 return (child->parent == widget);
3171 /*****************************************
3172 * gtk_widget_push_colormap:
3177 *****************************************/
3180 gtk_widget_push_colormap (GdkColormap *cmap)
3182 g_return_if_fail (cmap != NULL);
3184 colormap_stack = g_slist_prepend (colormap_stack, cmap);
3187 /*****************************************
3188 * gtk_widget_push_visual:
3193 *****************************************/
3196 gtk_widget_push_visual (GdkVisual *visual)
3198 g_return_if_fail (visual != NULL);
3200 visual_stack = g_slist_prepend (visual_stack, visual);
3203 /*****************************************
3204 * gtk_widget_pop_colormap:
3209 *****************************************/
3212 gtk_widget_pop_colormap (void)
3218 tmp = colormap_stack;
3219 colormap_stack = colormap_stack->next;
3220 g_slist_free_1 (tmp);
3224 /*****************************************
3225 * gtk_widget_pop_visual:
3230 *****************************************/
3233 gtk_widget_pop_visual (void)
3240 visual_stack = visual_stack->next;
3241 g_slist_free_1 (tmp);
3245 /*****************************************
3246 * gtk_widget_set_default_colormap:
3251 *****************************************/
3254 gtk_widget_set_default_colormap (GdkColormap *colormap)
3256 if (default_colormap != colormap)
3258 if (default_colormap)
3259 gdk_colormap_unref (default_colormap);
3260 default_colormap = colormap;
3261 if (default_colormap)
3262 gdk_colormap_ref (default_colormap);
3266 /*****************************************
3267 * gtk_widget_set_default_visual:
3272 *****************************************/
3275 gtk_widget_set_default_visual (GdkVisual *visual)
3277 default_visual = visual;
3280 /*****************************************
3281 * gtk_widget_get_default_colormap:
3286 *****************************************/
3289 gtk_widget_get_default_colormap (void)
3291 if (!default_colormap)
3292 default_colormap = gdk_colormap_get_system ();
3294 return default_colormap;
3297 /*****************************************
3298 * gtk_widget_get_default_visual:
3303 *****************************************/
3306 gtk_widget_get_default_visual (void)
3308 if (!default_visual)
3309 default_visual = gdk_visual_get_system ();
3311 return default_visual;
3314 /*****************************************
3315 * gtk_widget_marshal_signal_1:
3320 *****************************************/
3323 gtk_widget_marshal_signal_1 (GtkObject *object,
3328 GtkWidgetSignal1 rfunc;
3330 rfunc = (GtkWidgetSignal1) func;
3333 GTK_VALUE_POINTER (args[0]),
3337 /*****************************************
3338 * gtk_widget_marshal_signal_2:
3343 *****************************************/
3346 gtk_widget_marshal_signal_2 (GtkObject *object,
3351 GtkWidgetSignal2 rfunc;
3354 rfunc = (GtkWidgetSignal2) func;
3355 return_val = GTK_RETLOC_BOOL (args[3]);
3357 *return_val = (* rfunc) (object,
3358 GTK_VALUE_STRING (args[0]),
3359 GTK_VALUE_CHAR (args[1]),
3360 GTK_VALUE_INT (args[2]),
3364 /*****************************************
3365 * gtk_widget_marshal_signal_3:
3370 *****************************************/
3373 gtk_widget_marshal_signal_3 (GtkObject *object,
3378 GtkWidgetSignal3 rfunc;
3380 rfunc = (GtkWidgetSignal3) func;
3383 GTK_VALUE_STRING (args[0]),
3387 /*****************************************
3388 * gtk_widget_marshal_signal_4:
3393 *****************************************/
3396 gtk_widget_marshal_signal_4 (GtkObject *object,
3401 GtkWidgetSignal4 rfunc;
3404 rfunc = (GtkWidgetSignal4) func;
3405 return_val = GTK_RETLOC_BOOL (args[1]);
3407 *return_val = (* rfunc) (object,
3408 GTK_VALUE_BOXED (args[0]),
3412 /*****************************************
3413 * gtk_widget_marshal_signal_5:
3418 *****************************************/
3421 gtk_widget_marshal_signal_5 (GtkObject *object,
3426 GtkWidgetSignal5 rfunc;
3428 rfunc = (GtkWidgetSignal5) func;
3431 GTK_VALUE_UINT (args[0]),
3435 /*****************************************
3436 * gtk_widget_marshal_signal_6:
3441 *****************************************/
3444 gtk_widget_marshal_signal_6 (GtkObject *object,
3449 GtkWidgetSignal6 rfunc;
3451 rfunc = (GtkWidgetSignal6) func;
3454 GTK_VALUE_OBJECT (args[0]),
3458 /*****************************************
3459 * gtk_widget_marshal_signal_7:
3464 *****************************************/
3467 gtk_widget_marshal_signal_7 (GtkObject *object,
3472 GtkWidgetSignal7 rfunc;
3474 rfunc = (GtkWidgetSignal7) func;
3477 GTK_VALUE_BOXED (args[0]),
3482 gtk_widget_shutdown (GtkObject *object)
3486 /* gtk_object_destroy() will already hold a refcount on object
3488 widget = GTK_WIDGET (object);
3491 gtk_container_remove (GTK_CONTAINER (widget->parent), widget);
3493 GTK_WIDGET_UNSET_FLAGS (widget, GTK_VISIBLE);
3494 if (GTK_WIDGET_REALIZED (widget))
3495 gtk_widget_unrealize (widget);
3497 parent_class->shutdown (object);
3501 gtk_widget_real_destroy (GtkObject *object)
3504 GtkStyle *saved_style;
3506 /* gtk_object_destroy() will already hold a refcount on object
3508 widget = GTK_WIDGET (object);
3510 if (GTK_CONTAINER_RESIZE_PENDING (widget))
3512 gtk_widget_resize_queue = g_slist_remove (gtk_widget_resize_queue, widget);
3513 GTK_PRIVATE_UNSET_FLAG (widget, GTK_RESIZE_PENDING);
3516 gtk_grab_remove (widget);
3517 gtk_selection_remove_all (widget);
3518 gtk_accelerator_tables_delete (object);
3520 saved_style = gtk_object_get_data_by_id (object, saved_default_style_key_id);
3523 gtk_style_unref (saved_style);
3524 gtk_object_remove_data_by_id (object, saved_default_style_key_id);
3527 gtk_style_unref (widget->style);
3528 widget->style = NULL;
3530 parent_class->destroy (object);
3534 gtk_widget_finalize (GtkObject *object)
3537 GtkWidgetAuxInfo *aux_info;
3539 GdkExtensionMode *mode;
3541 widget = GTK_WIDGET (object);
3544 g_free (widget->name);
3546 aux_info = gtk_object_get_data_by_id (GTK_OBJECT (widget), aux_info_key_id);
3548 gtk_widget_aux_info_destroy (aux_info);
3550 events = gtk_object_get_data_by_id (GTK_OBJECT (widget), event_key_id);
3554 mode = gtk_object_get_data_by_id (GTK_OBJECT (widget), extension_event_key_id);
3558 parent_class->finalize (object);
3561 /*****************************************
3562 * gtk_widget_real_show:
3567 *****************************************/
3570 gtk_widget_real_show (GtkWidget *widget)
3572 g_return_if_fail (widget != NULL);
3573 g_return_if_fail (GTK_IS_WIDGET (widget));
3575 if (!GTK_WIDGET_VISIBLE (widget))
3577 GTK_WIDGET_SET_FLAGS (widget, GTK_VISIBLE);
3581 gtk_widget_queue_resize (widget->parent);
3583 if (GTK_WIDGET_MAPPED (widget->parent))
3584 gtk_widget_map (widget);
3589 /*****************************************
3590 * gtk_widget_real_hide:
3595 *****************************************/
3598 gtk_widget_real_hide (GtkWidget *widget)
3600 g_return_if_fail (widget != NULL);
3601 g_return_if_fail (GTK_IS_WIDGET (widget));
3603 if (GTK_WIDGET_VISIBLE (widget))
3605 GTK_WIDGET_UNSET_FLAGS (widget, GTK_VISIBLE);
3607 if (GTK_WIDGET_MAPPED (widget))
3608 gtk_widget_unmap (widget);
3611 gtk_widget_queue_resize (widget);
3615 /*****************************************
3616 * gtk_widget_real_map:
3621 *****************************************/
3624 gtk_widget_real_map (GtkWidget *widget)
3626 g_return_if_fail (widget != NULL);
3627 g_return_if_fail (GTK_IS_WIDGET (widget));
3629 if (GTK_WIDGET_REALIZED (widget) && !GTK_WIDGET_MAPPED (widget))
3631 GTK_WIDGET_SET_FLAGS (widget, GTK_MAPPED);
3633 if (!GTK_WIDGET_NO_WINDOW (widget))
3634 gdk_window_show (widget->window);
3636 gtk_widget_queue_draw (widget);
3640 /*****************************************
3641 * gtk_widget_real_unmap:
3646 *****************************************/
3649 gtk_widget_real_unmap (GtkWidget *widget)
3651 g_return_if_fail (widget != NULL);
3652 g_return_if_fail (GTK_IS_WIDGET (widget));
3654 if (GTK_WIDGET_MAPPED (widget))
3656 GTK_WIDGET_UNSET_FLAGS (widget, GTK_MAPPED);
3658 if (GTK_WIDGET_NO_WINDOW (widget))
3659 gdk_window_clear_area (widget->window,
3660 widget->allocation.x,
3661 widget->allocation.y,
3662 widget->allocation.width,
3663 widget->allocation.height);
3665 gdk_window_hide (widget->window);
3669 /*****************************************
3670 * gtk_widget_real_realize:
3675 *****************************************/
3678 gtk_widget_real_realize (GtkWidget *widget)
3680 g_return_if_fail (widget != NULL);
3681 g_return_if_fail (GTK_IS_WIDGET (widget));
3682 g_return_if_fail (GTK_WIDGET_NO_WINDOW (widget));
3684 GTK_WIDGET_SET_FLAGS (widget, GTK_REALIZED);
3687 widget->window = gtk_widget_get_parent_window (widget);
3688 gdk_window_ref (widget->window);
3690 widget->style = gtk_style_attach (widget->style, widget->window);
3693 /*****************************************
3694 * gtk_widget_real_unrealize:
3699 *****************************************/
3702 gtk_widget_real_unrealize (GtkWidget *widget)
3704 g_return_if_fail (widget != NULL);
3705 g_return_if_fail (GTK_IS_WIDGET (widget));
3707 if (GTK_WIDGET_NO_WINDOW (widget) && GTK_WIDGET_MAPPED (widget))
3708 gtk_widget_real_unmap (widget);
3710 GTK_WIDGET_UNSET_FLAGS (widget, GTK_REALIZED | GTK_MAPPED);
3712 /* printf ("unrealizing %s\n", gtk_type_name (GTK_OBJECT(widget)->klass->type));
3715 gtk_style_detach (widget->style);
3716 if (!GTK_WIDGET_NO_WINDOW (widget))
3718 gdk_window_set_user_data (widget->window, NULL);
3719 gdk_window_destroy (widget->window);
3723 gdk_window_unref (widget->window);
3726 /* Unrealize afterwards to improve visual effect */
3728 if (GTK_IS_CONTAINER (widget))
3729 gtk_container_foreach (GTK_CONTAINER (widget),
3730 (GtkCallback)gtk_widget_unrealize,
3733 widget->window = NULL;
3736 /*****************************************
3737 * gtk_widget_real_draw:
3742 *****************************************/
3745 gtk_widget_real_draw (GtkWidget *widget,
3748 GdkEventExpose event;
3750 g_return_if_fail (widget != NULL);
3751 g_return_if_fail (GTK_IS_WIDGET (widget));
3752 g_return_if_fail (area != NULL);
3754 if (GTK_WIDGET_DRAWABLE (widget))
3756 event.type = GDK_EXPOSE;
3757 event.send_event = TRUE;
3758 event.window = widget->window;
3762 gdk_window_ref (event.window);
3763 gtk_widget_event (widget, (GdkEvent*) &event);
3764 gdk_window_unref (event.window);
3768 /*****************************************
3769 * gtk_widget_real_queue_draw:
3774 *****************************************/
3777 gtk_widget_real_queue_draw (GtkWidget *widget)
3779 g_return_val_if_fail (widget != NULL, FALSE);
3780 g_return_val_if_fail (GTK_IS_WIDGET (widget), FALSE);
3782 GTK_PRIVATE_UNSET_FLAG (widget, GTK_REDRAW_PENDING);
3783 gtk_widget_draw (widget, NULL);
3788 /*****************************************
3789 * gtk_widget_real_size_allocate:
3794 *****************************************/
3797 gtk_widget_real_size_allocate (GtkWidget *widget,
3798 GtkAllocation *allocation)
3800 g_return_if_fail (widget != NULL);
3801 g_return_if_fail (GTK_IS_WIDGET (widget));
3803 if (GTK_WIDGET_NO_WINDOW (widget) &&
3804 GTK_WIDGET_MAPPED (widget) &&
3805 ((widget->allocation.x != allocation->x) ||
3806 (widget->allocation.y != allocation->y) ||
3807 (widget->allocation.width != allocation->width) ||
3808 (widget->allocation.height != allocation->height)) &&
3809 (widget->allocation.width != 0) &&
3810 (widget->allocation.height != 0))
3811 gdk_window_clear_area (widget->window,
3812 widget->allocation.x,
3813 widget->allocation.y,
3814 widget->allocation.width,
3815 widget->allocation.height);
3817 widget->allocation = *allocation;
3819 if (GTK_WIDGET_REALIZED (widget) &&
3820 !GTK_WIDGET_NO_WINDOW (widget))
3821 gdk_window_move_resize (widget->window,
3822 allocation->x, allocation->y,
3823 allocation->width, allocation->height);
3826 /*****************************************
3827 * gtk_widget_peek_colormap:
3832 *****************************************/
3835 gtk_widget_peek_colormap (void)
3838 return (GdkColormap*) colormap_stack->data;
3839 return gtk_widget_get_default_colormap ();
3842 /*****************************************
3843 * gtk_widget_peek_visual:
3848 *****************************************/
3851 gtk_widget_peek_visual (void)
3854 return (GdkVisual*) visual_stack->data;
3855 return gtk_widget_get_default_visual ();
3858 /*************************************************************
3859 * gtk_widget_propagate_state:
3860 * Propagate a change in the widgets state down the tree
3864 * GtkStateData: state
3868 *************************************************************/
3871 gtk_widget_propagate_state (GtkWidget *widget,
3876 /* don't call this function with state==GTK_STATE_INSENSITIVE,
3877 * parent_sensitive==TRUE on a sensitive widget
3880 old_state = GTK_WIDGET_STATE (widget);
3882 if (data->parent_sensitive)
3884 GTK_WIDGET_SET_FLAGS (widget, GTK_PARENT_SENSITIVE);
3886 if (GTK_WIDGET_IS_SENSITIVE (widget))
3888 if (data->state_restauration)
3889 GTK_WIDGET_STATE (widget) = GTK_WIDGET_SAVED_STATE (widget);
3891 GTK_WIDGET_STATE (widget) = data->state;
3895 GTK_WIDGET_STATE (widget) = GTK_STATE_INSENSITIVE;
3896 if (!data->state_restauration &&
3897 data->state != GTK_STATE_INSENSITIVE)
3898 GTK_WIDGET_SAVED_STATE (widget) = data->state;
3903 GTK_WIDGET_UNSET_FLAGS (widget, GTK_PARENT_SENSITIVE);
3904 if (!data->state_restauration)
3906 if (data->state != GTK_STATE_INSENSITIVE)
3907 GTK_WIDGET_SAVED_STATE (widget) = data->state;
3909 else if (GTK_WIDGET_STATE (widget) != GTK_STATE_INSENSITIVE)
3910 GTK_WIDGET_SAVED_STATE (widget) = GTK_WIDGET_STATE (widget);
3911 GTK_WIDGET_STATE (widget) = GTK_STATE_INSENSITIVE;
3914 if (GTK_WIDGET_HAS_FOCUS (widget) && !GTK_WIDGET_IS_SENSITIVE (widget))
3918 window = gtk_widget_get_ancestor (widget, gtk_window_get_type ());
3920 gtk_window_set_focus (GTK_WINDOW (window), NULL);
3923 if (old_state != GTK_WIDGET_STATE (widget))
3925 gtk_widget_ref (widget);
3926 gtk_signal_emit (GTK_OBJECT (widget), widget_signals[STATE_CHANGED], old_state);
3928 if (GTK_IS_CONTAINER (widget))
3930 data->parent_sensitive = (GTK_WIDGET_IS_SENSITIVE (widget) != FALSE);
3931 data->state = GTK_WIDGET_STATE (widget);
3932 gtk_container_foreach (GTK_CONTAINER (widget),
3933 (GtkCallback) gtk_widget_propagate_state,
3936 gtk_widget_unref (widget);
3940 /*****************************************
3941 * gtk_widget_draw_children_recurse:
3946 *****************************************/
3949 gtk_widget_draw_children_recurse (GtkWidget *widget,
3950 gpointer client_data)
3952 gtk_widget_draw (widget, NULL);
3953 gtk_widget_draw_children (widget);
3956 /*****************************************
3957 * gtk_widget_aux_info_new:
3962 *****************************************/
3964 static GtkWidgetAuxInfo*
3965 gtk_widget_aux_info_new (void)
3967 GtkWidgetAuxInfo *aux_info;
3969 if (!aux_info_mem_chunk)
3970 aux_info_mem_chunk = g_mem_chunk_new ("widget aux info mem chunk",
3971 sizeof (GtkWidgetAuxInfo),
3972 1024, G_ALLOC_AND_FREE);
3974 aux_info = g_chunk_new (GtkWidgetAuxInfo, aux_info_mem_chunk);
3978 aux_info->width = 0;
3979 aux_info->height = 0;
3984 /*****************************************
3985 * gtk_widget_aux_info_destroy:
3990 *****************************************/
3993 gtk_widget_aux_info_destroy (GtkWidgetAuxInfo *aux_info)
3995 g_return_if_fail (aux_info != NULL);
3997 g_mem_chunk_free (aux_info_mem_chunk, aux_info);
4000 /*****************************************
4001 * gtk_widget_shape_combine_mask:
4002 * set a shape for this widgets' gdk window, this allows for
4003 * transparent windows etc., see gdk_window_shape_combine_mask
4004 * for more information
4009 *****************************************/
4011 gtk_widget_shape_combine_mask (GtkWidget *widget,
4012 GdkBitmap *shape_mask,
4016 GtkWidgetShapeInfo* shape_info;
4018 g_return_if_fail (widget != NULL);
4019 /* set_shape doesn't work on widgets without gdk window */
4020 g_return_if_fail (!GTK_WIDGET_NO_WINDOW (widget));
4024 GTK_PRIVATE_UNSET_FLAG (widget, GTK_HAS_SHAPE_MASK);
4027 gdk_window_shape_combine_mask (widget->window, NULL, 0, 0);
4029 shape_info = gtk_object_get_data (GTK_OBJECT (widget), shape_info_key);
4030 gtk_object_remove_data (GTK_OBJECT (widget), shape_info_key);
4031 g_free (shape_info);
4035 GTK_PRIVATE_SET_FLAG (widget, GTK_HAS_SHAPE_MASK);
4037 shape_info = gtk_object_get_data (GTK_OBJECT (widget), shape_info_key);
4040 shape_info = g_new (GtkWidgetShapeInfo, 1);
4041 gtk_object_set_data (GTK_OBJECT (widget), shape_info_key, shape_info);
4043 shape_info->shape_mask = shape_mask;
4044 shape_info->offset_x = offset_x;
4045 shape_info->offset_y = offset_y;
4047 /* set shape if widget has a gdk window allready.
4048 * otherwise the shape is scheduled to be set by gtk_widget_realize.
4051 gdk_window_shape_combine_mask (widget->window, shape_mask,
4052 offset_x, offset_y);
4056 /*****************************************
4057 * gtk_widget_dnd_drag_add:
4058 * when you get a DRAG_ENTER event, you can use this
4059 * to tell Gtk ofother widgets that are to be dragged as well
4064 *****************************************/
4066 gtk_widget_dnd_drag_add (GtkWidget *widget)
4070 /*****************************************
4071 * gtk_widget_dnd_drag_set:
4072 * these two functions enable drag and/or drop on a
4073 * widget and also let Gtk know what data types will be accepted
4074 * use MIME type naming,plus tacking "URL:" on the front for link
4081 *****************************************/
4083 gtk_widget_dnd_drag_set (GtkWidget *widget,
4085 gchar **type_accept_list,
4088 g_return_if_fail(widget != NULL);
4090 if (!widget->window)
4091 gtk_widget_realize (widget);
4093 g_return_if_fail (widget->window != NULL);
4094 gdk_window_dnd_drag_set (widget->window,
4100 /*****************************************
4101 * gtk_widget_dnd_drop_set:
4106 *****************************************/
4108 gtk_widget_dnd_drop_set (GtkWidget *widget,
4110 gchar **type_accept_list,
4112 guint8 is_destructive_operation)
4114 g_return_if_fail(widget != NULL);
4116 if (!widget->window)
4117 gtk_widget_realize (widget);
4119 g_return_if_fail (widget->window != NULL);
4120 gdk_window_dnd_drop_set (widget->window,
4124 is_destructive_operation);
4127 /*****************************************
4128 * gtk_widget_dnd_data_set:
4133 *****************************************/
4135 gtk_widget_dnd_data_set (GtkWidget *widget,
4138 gulong data_numbytes)
4140 g_return_if_fail (widget != NULL);
4141 g_return_if_fail (widget->window != NULL);
4143 gdk_window_dnd_data_set (widget->window, event, data, data_numbytes);
4147 gtk_widget_ref (GtkWidget *widget)
4149 g_return_if_fail (widget != NULL);
4150 g_return_if_fail (GTK_IS_WIDGET (widget));
4152 gtk_object_ref ((GtkObject*) widget);
4156 gtk_widget_unref (GtkWidget *widget)
4158 g_return_if_fail (widget != NULL);
4159 g_return_if_fail (GTK_IS_WIDGET (widget));
4161 gtk_object_unref ((GtkObject*) widget);