1 <!-- ##### SECTION Title ##### -->
4 <!-- ##### SECTION Short_Description ##### -->
5 Base class for all widgets
7 <!-- ##### SECTION Long_Description ##### -->
8 <para id="style-properties">
9 <structname>GtkWidget</structname> introduces <firstterm>style
10 properties</firstterm> - these are basically object properties that are stored
11 not on the object, but in the style object associated to the widget. Style
12 properties are set in <link linkend="gtk-Resource-Files">resource files</link>.
13 This mechanism is used for configuring such things as the location of the
14 scrollbar arrows through the theme, giving theme authors more control over the
15 look of applications without the need to write a theme engine in C.
18 Use gtk_widget_class_install_style_property() to install style properties for
19 a widget class, gtk_widget_class_find_style_property() or
20 gtk_widget_class_list_style_properties() to get information about existing
21 style properties and gtk_widget_style_get_property(), gtk_widget_style_get() or
22 gtk_widget_style_get_valist() to obtain the value of a style property.
25 <!-- ##### SECTION See_Also ##### -->
30 <!-- ##### STRUCT GtkWidget ##### -->
36 <!-- ##### STRUCT GtkWidgetClass ##### -->
38 <structfield>activate_signal</structfield>
39 The signal to emit when a widget of this class is activated,
40 gtk_widget_activate() handles the emission. Implementation of this
45 <structfield>set_scroll_adjustment_signal</structfield>
46 This signal is emitted when a widget of this class is added
47 to a scrolling aware parent, gtk_widget_set_scroll_adjustments()
49 Implementation of this signal is optional.
54 @set_scroll_adjustments_signal:
56 <!-- ##### ENUM GtkWidgetFlags ##### -->
58 Tells about certain properties of the widget.
62 widgets without a real parent, as there are #GtkWindow<!-- -->s and
63 #GtkMenu<!-- -->s have this flag set throughout their lifetime.
64 Toplevel widgets always contain their own #GdkWindow.
66 Indicative for a widget that does not provide its own #GdkWindow.
67 Visible action (e.g. drawing) is performed on the parent's #GdkWindow.
69 Set by gtk_widget_realize(), unset by gtk_widget_unrealize().
70 A realized widget has an associated #GdkWindow.
72 Set by gtk_widget_map(), unset by gtk_widget_unmap().
73 Only realized widgets can be mapped. It means that gdk_window_show()
74 has been called on the widgets window(s).
76 Set by gtk_widget_show(), unset by gtk_widget_hide(). Implies that a
77 widget will be mapped as soon as its parent is mapped.
79 Set and unset by gtk_widget_set_sensitive().
80 The sensitivity of a widget determines whether it will receive
81 certain events (e.g. button or key presses). One premise for
82 the widgets sensitivity is to have this flag set.
83 @GTK_PARENT_SENSITIVE:
84 Set and unset by gtk_widget_set_sensitive() operations on the
85 parents of the widget.
86 This is the second premise for the widgets sensitivity. Once
87 it has %GTK_SENSITIVE and %GTK_PARENT_SENSITIVE set, its state is
88 effectively sensitive. This is expressed (and can be examined) by
89 the #GTK_WIDGET_IS_SENSITIVE macro.
91 Determines whether a widget is able to handle focus grabs.
93 Set by gtk_widget_grab_focus() for widgets that also
94 have %GTK_CAN_FOCUS set. The flag will be unset once another widget
97 The widget is allowed to receive the default action via
98 gtk_widget_grab_default().
100 The widget currently is receiving the default action.
102 Set by gtk_grab_add(), unset by gtk_grab_remove(). It means that the
103 widget is in the grab_widgets stack, and will be the preferred one for
104 receiving events other than ones of cosmetic value.
106 Indicates that the widgets style has been looked up through the rc
107 mechanism. It does not imply that the widget actually had a style
108 defined through the rc mechanism.
109 @GTK_COMPOSITE_CHILD:
110 Indicates that the widget is a composite child of its parent; see
111 gtk_widget_push_composite_child(), gtk_widget_pop_composite_child().
113 Unused since before GTK+ 1.2, will be removed in a future version.
115 Set and unset by gtk_widget_set_app_paintable().
116 Must be set on widgets whose window the application directly draws on,
117 in order to keep GTK+ from overwriting the drawn stuff.
118 @GTK_RECEIVES_DEFAULT:
119 The widget when focused will receive the default action and have
120 %GTK_HAS_DEFAULT set even if there is a different widget set as default.
121 @GTK_DOUBLE_BUFFERED:
122 Set and unset by gtk_widget_set_double_buffered().
123 Indicates that exposes done on the widget should be double-buffered.
125 <!-- ##### MACRO GTK_WIDGET_TYPE ##### -->
127 Gets the type of a widget.
133 <!-- ##### MACRO GTK_WIDGET_STATE ##### -->
135 Returns the current state of the widget, as a #GtkStateType.
141 <!-- ##### MACRO GTK_WIDGET_SAVED_STATE ##### -->
143 Returns the saved state of the widget, as a #GtkStateType.
146 The saved state will be restored when a widget gets sensitive
147 again, after it has been made insensitive with gtk_widget_set_state()
148 or gtk_widget_set_sensitive().
154 <!-- ##### MACRO GTK_WIDGET_FLAGS ##### -->
156 Returns the widget flags from @wid.
162 <!-- ##### MACRO GTK_WIDGET_TOPLEVEL ##### -->
164 Evaluates to %TRUE if the widget is a toplevel widget.
170 <!-- ##### MACRO GTK_WIDGET_NO_WINDOW ##### -->
172 Evaluates to %TRUE if the widget doesn't have an own #GdkWindow.
178 <!-- ##### MACRO GTK_WIDGET_REALIZED ##### -->
180 Evaluates to %TRUE if the widget is realized.
186 <!-- ##### MACRO GTK_WIDGET_MAPPED ##### -->
188 Evaluates to %TRUE if the widget is mapped.
194 <!-- ##### MACRO GTK_WIDGET_VISIBLE ##### -->
196 Evaluates to %TRUE if the widget is visible.
202 <!-- ##### MACRO GTK_WIDGET_DRAWABLE ##### -->
204 Evaluates to %TRUE if the widget is mapped and visible.
210 <!-- ##### MACRO GTK_WIDGET_SENSITIVE ##### -->
212 Evaluates to %TRUE if the #GTK_SENSITIVE flag has be set on the widget.
218 <!-- ##### MACRO GTK_WIDGET_PARENT_SENSITIVE ##### -->
220 Evaluates to %TRUE if the #GTK_PARENT_SENSITIVE flag has be set on the widget.
226 <!-- ##### MACRO GTK_WIDGET_IS_SENSITIVE ##### -->
228 Evaluates to %TRUE if the widget is effectively sensitive.
234 <!-- ##### MACRO GTK_WIDGET_CAN_FOCUS ##### -->
236 Evaluates to %TRUE if the widget is able to handle focus grabs.
242 <!-- ##### MACRO GTK_WIDGET_HAS_FOCUS ##### -->
244 Evaluates to %TRUE if the widget has grabbed the focus and no other
245 widget has done so more recently.
251 <!-- ##### MACRO GTK_WIDGET_CAN_DEFAULT ##### -->
253 Evaluates to %TRUE if the widget is allowed to receive the default action
254 via gtk_widget_grab_default().
260 <!-- ##### MACRO GTK_WIDGET_RECEIVES_DEFAULT ##### -->
262 Evaluates to %TRUE if the widget when focused will receive the default action
263 even if there is a different widget set as default.
269 <!-- ##### MACRO GTK_WIDGET_HAS_DEFAULT ##### -->
271 Evaluates to %TRUE if the widget currently is receiving the default action.
277 <!-- ##### MACRO GTK_WIDGET_HAS_GRAB ##### -->
279 Evaluates to %TRUE if the widget is in the grab_widgets stack, and will be
280 the preferred one for receiving events other than ones of cosmetic value.
286 <!-- ##### MACRO GTK_WIDGET_RC_STYLE ##### -->
288 Evaluates to %TRUE if the widgets style has been looked up through the rc
295 <!-- ##### MACRO GTK_WIDGET_COMPOSITE_CHILD ##### -->
297 Evaluates to %TRUE if the widget is a composite child of its parent.
303 <!-- ##### MACRO GTK_WIDGET_APP_PAINTABLE ##### -->
305 Evaluates to %TRUE if the #GTK_APP_PAINTABLE flag has been set on the widget.
311 <!-- ##### MACRO GTK_WIDGET_DOUBLE_BUFFERED ##### -->
313 Evaluates to %TRUE if the #GTK_DOUBLE_BUFFERED flag has been set on the widget.
319 <!-- ##### MACRO GTK_WIDGET_SET_FLAGS ##### -->
321 Turns on certain widget flags.
325 @flag: the flags to set.
328 <!-- ##### MACRO GTK_WIDGET_UNSET_FLAGS ##### -->
330 Turns off certain widget flags.
334 @flag: the flags to unset.
337 <!-- ##### USER_FUNCTION GtkCallback ##### -->
346 <!-- ##### STRUCT GtkRequisition ##### -->
354 <!-- ##### STRUCT GtkAllocation ##### -->
364 <!-- ##### STRUCT GtkSelectionData ##### -->
377 <!-- ##### STRUCT GtkWidgetAuxInfo ##### -->
389 <!-- ##### STRUCT GtkWidgetShapeInfo ##### -->
398 <!-- ##### ENUM GtkWidgetHelpType ##### -->
403 @GTK_WIDGET_HELP_TOOLTIP:
404 @GTK_WIDGET_HELP_WHATS_THIS:
406 <!-- ##### FUNCTION gtk_widget_new ##### -->
412 @first_property_name:
415 <!-- # Unused Parameters # -->
419 <!-- ##### FUNCTION gtk_widget_ref ##### -->
428 <!-- ##### FUNCTION gtk_widget_unref ##### -->
436 <!-- ##### FUNCTION gtk_widget_destroy ##### -->
444 <!-- ##### FUNCTION gtk_widget_destroyed ##### -->
453 <!-- ##### FUNCTION gtk_widget_set ##### -->
459 @first_property_name:
461 <!-- # Unused Parameters # -->
465 <!-- ##### FUNCTION gtk_widget_unparent ##### -->
473 <!-- ##### FUNCTION gtk_widget_show ##### -->
481 <!-- ##### FUNCTION gtk_widget_show_now ##### -->
489 <!-- ##### FUNCTION gtk_widget_hide ##### -->
497 <!-- ##### FUNCTION gtk_widget_show_all ##### -->
505 <!-- ##### FUNCTION gtk_widget_hide_all ##### -->
513 <!-- ##### FUNCTION gtk_widget_map ##### -->
521 <!-- ##### FUNCTION gtk_widget_unmap ##### -->
529 <!-- ##### FUNCTION gtk_widget_realize ##### -->
537 <!-- ##### FUNCTION gtk_widget_unrealize ##### -->
545 <!-- ##### FUNCTION gtk_widget_queue_draw ##### -->
553 <!-- ##### FUNCTION gtk_widget_queue_resize ##### -->
561 <!-- ##### FUNCTION gtk_widget_draw ##### -->
570 <!-- ##### FUNCTION gtk_widget_size_request ##### -->
579 <!-- ##### FUNCTION gtk_widget_get_child_requisition ##### -->
588 <!-- ##### FUNCTION gtk_widget_size_allocate ##### -->
597 <!-- ##### FUNCTION gtk_widget_add_accelerator ##### -->
610 <!-- ##### FUNCTION gtk_widget_remove_accelerator ##### -->
622 <!-- ##### FUNCTION gtk_widget_set_accel_path ##### -->
632 <!-- ##### FUNCTION gtk_widget_list_accel_closures ##### -->
641 <!-- ##### FUNCTION gtk_widget_event ##### -->
651 <!-- ##### FUNCTION gtk_widget_activate ##### -->
660 <!-- ##### FUNCTION gtk_widget_reparent ##### -->
669 <!-- ##### FUNCTION gtk_widget_intersect ##### -->
680 <!-- ##### FUNCTION gtk_widget_is_focus ##### -->
689 <!-- ##### FUNCTION gtk_widget_grab_focus ##### -->
697 <!-- ##### FUNCTION gtk_widget_grab_default ##### -->
705 <!-- ##### FUNCTION gtk_widget_set_name ##### -->
714 <!-- ##### FUNCTION gtk_widget_get_name ##### -->
723 <!-- ##### FUNCTION gtk_widget_set_state ##### -->
732 <!-- ##### FUNCTION gtk_widget_set_sensitive ##### -->
741 <!-- ##### FUNCTION gtk_widget_set_parent ##### -->
750 <!-- ##### FUNCTION gtk_widget_set_parent_window ##### -->
759 <!-- ##### FUNCTION gtk_widget_get_parent_window ##### -->
768 <!-- ##### FUNCTION gtk_widget_set_uposition ##### -->
778 <!-- ##### FUNCTION gtk_widget_set_usize ##### -->
788 <!-- ##### FUNCTION gtk_widget_set_events ##### -->
797 <!-- ##### FUNCTION gtk_widget_add_events ##### -->
806 <!-- ##### FUNCTION gtk_widget_set_extension_events ##### -->
815 <!-- ##### FUNCTION gtk_widget_get_extension_events ##### -->
824 <!-- ##### FUNCTION gtk_widget_get_toplevel ##### -->
833 <!-- ##### FUNCTION gtk_widget_get_ancestor ##### -->
843 <!-- ##### FUNCTION gtk_widget_get_colormap ##### -->
852 <!-- ##### FUNCTION gtk_widget_set_colormap ##### -->
861 <!-- ##### FUNCTION gtk_widget_get_visual ##### -->
870 <!-- ##### FUNCTION gtk_widget_get_events ##### -->
879 <!-- ##### FUNCTION gtk_widget_get_pointer ##### -->
889 <!-- ##### FUNCTION gtk_widget_is_ancestor ##### -->
899 <!-- ##### FUNCTION gtk_widget_translate_coordinates ##### -->
913 <!-- ##### FUNCTION gtk_widget_hide_on_delete ##### -->
922 <!-- ##### FUNCTION gtk_widget_set_style ##### -->
931 <!-- ##### MACRO gtk_widget_set_rc_style ##### -->
933 Equivalent to <literal>gtk_widget_set_style (widget, NULL)</literal>.
936 @widget: a #GtkWidget.
939 <!-- ##### FUNCTION gtk_widget_ensure_style ##### -->
947 <!-- ##### FUNCTION gtk_widget_get_style ##### -->
956 <!-- ##### MACRO gtk_widget_restore_default_style ##### -->
958 Equivalent to <literal>gtk_widget_set_style (widget, NULL)</literal>.
961 @widget: a #GtkWidget.
964 <!-- ##### FUNCTION gtk_widget_reset_rc_styles ##### -->
966 Reset the styles of @widget and all descendents, so when
967 they are looked up again, they get the correct values
968 for the currently loaded RC file settings.
971 This function is not useful for applications.
974 @widget: a #GtkWidget.
977 <!-- ##### FUNCTION gtk_widget_push_colormap ##### -->
985 <!-- ##### FUNCTION gtk_widget_pop_colormap ##### -->
992 <!-- ##### FUNCTION gtk_widget_set_default_colormap ##### -->
1000 <!-- ##### FUNCTION gtk_widget_get_default_style ##### -->
1008 <!-- ##### FUNCTION gtk_widget_get_default_colormap ##### -->
1016 <!-- ##### FUNCTION gtk_widget_get_default_visual ##### -->
1024 <!-- ##### FUNCTION gtk_widget_set_direction ##### -->
1033 <!-- ##### ENUM GtkTextDirection ##### -->
1042 <!-- ##### FUNCTION gtk_widget_get_direction ##### -->
1051 <!-- ##### FUNCTION gtk_widget_set_default_direction ##### -->
1059 <!-- ##### FUNCTION gtk_widget_get_default_direction ##### -->
1067 <!-- ##### FUNCTION gtk_widget_shape_combine_mask ##### -->
1078 <!-- ##### FUNCTION gtk_widget_path ##### -->
1089 <!-- ##### FUNCTION gtk_widget_class_path ##### -->
1100 <!-- ##### FUNCTION gtk_widget_get_composite_name ##### -->
1109 <!-- ##### FUNCTION gtk_widget_modify_style ##### -->
1118 <!-- ##### FUNCTION gtk_widget_get_modifier_style ##### -->
1127 <!-- ##### FUNCTION gtk_widget_modify_fg ##### -->
1137 <!-- ##### FUNCTION gtk_widget_modify_bg ##### -->
1147 <!-- ##### FUNCTION gtk_widget_modify_text ##### -->
1157 <!-- ##### FUNCTION gtk_widget_modify_base ##### -->
1167 <!-- ##### FUNCTION gtk_widget_modify_font ##### -->
1176 <!-- ##### FUNCTION gtk_widget_create_pango_context ##### -->
1185 <!-- ##### FUNCTION gtk_widget_get_pango_context ##### -->
1194 <!-- ##### FUNCTION gtk_widget_create_pango_layout ##### -->
1204 <!-- ##### FUNCTION gtk_widget_render_icon ##### -->
1216 <!-- ##### FUNCTION gtk_widget_pop_composite_child ##### -->
1223 <!-- ##### FUNCTION gtk_widget_push_composite_child ##### -->
1230 <!-- ##### FUNCTION gtk_widget_queue_clear ##### -->
1238 <!-- ##### FUNCTION gtk_widget_queue_clear_area ##### -->
1250 <!-- ##### FUNCTION gtk_widget_queue_draw_area ##### -->
1262 <!-- ##### FUNCTION gtk_widget_reset_shapes ##### -->
1270 <!-- ##### FUNCTION gtk_widget_set_app_paintable ##### -->
1279 <!-- ##### FUNCTION gtk_widget_set_double_buffered ##### -->
1288 <!-- ##### FUNCTION gtk_widget_set_redraw_on_allocate ##### -->
1294 @redraw_on_allocate:
1297 <!-- ##### FUNCTION gtk_widget_set_composite_name ##### -->
1306 <!-- ##### FUNCTION gtk_widget_set_scroll_adjustments ##### -->
1317 <!-- ##### FUNCTION gtk_widget_mnemonic_activate ##### -->
1327 <!-- ##### FUNCTION gtk_widget_class_install_style_property ##### -->
1334 <!-- # Unused Parameters # -->
1338 <!-- ##### FUNCTION gtk_widget_class_install_style_property_parser ##### -->
1346 <!-- # Unused Parameters # -->
1350 <!-- ##### FUNCTION gtk_widget_class_find_style_property ##### -->
1358 <!-- # Unused Parameters # -->
1362 <!-- ##### FUNCTION gtk_widget_class_list_style_properties ##### -->
1370 <!-- # Unused Parameters # -->
1374 <!-- ##### FUNCTION gtk_widget_region_intersect ##### -->
1384 <!-- ##### FUNCTION gtk_widget_send_expose ##### -->
1394 <!-- ##### FUNCTION gtk_widget_style_get ##### -->
1400 @first_property_name:
1404 <!-- ##### FUNCTION gtk_widget_style_get_property ##### -->
1414 <!-- ##### FUNCTION gtk_widget_style_get_valist ##### -->
1420 @first_property_name:
1424 <!-- ##### FUNCTION gtk_widget_get_accessible ##### -->
1433 <!-- ##### FUNCTION gtk_widget_child_focus ##### -->
1443 <!-- ##### FUNCTION gtk_widget_child_notify ##### -->
1452 <!-- ##### FUNCTION gtk_widget_freeze_child_notify ##### -->
1460 <!-- ##### FUNCTION gtk_widget_get_child_visible ##### -->
1469 <!-- ##### FUNCTION gtk_widget_get_parent ##### -->
1478 <!-- ##### FUNCTION gtk_widget_get_settings ##### -->
1487 <!-- ##### FUNCTION gtk_widget_get_clipboard ##### -->
1497 <!-- ##### FUNCTION gtk_widget_get_display ##### -->
1506 <!-- ##### FUNCTION gtk_widget_get_root_window ##### -->
1515 <!-- ##### FUNCTION gtk_widget_get_screen ##### -->
1524 <!-- ##### FUNCTION gtk_widget_has_screen ##### -->
1533 <!-- ##### FUNCTION gtk_widget_get_size_request ##### -->
1543 <!-- ##### MACRO gtk_widget_pop_visual ##### -->
1545 This function is deprecated; it does nothing.
1550 <!-- ##### MACRO gtk_widget_push_visual ##### -->
1552 This function is deprecated; it does nothing.
1558 <!-- ##### FUNCTION gtk_widget_set_child_visible ##### -->
1567 <!-- ##### MACRO gtk_widget_set_default_visual ##### -->
1569 This function is deprecated; it does nothing.
1575 <!-- ##### FUNCTION gtk_widget_set_size_request ##### -->
1585 <!-- ##### MACRO gtk_widget_set_visual ##### -->
1587 This function is deprecated; it does nothing.
1594 <!-- ##### FUNCTION gtk_widget_thaw_child_notify ##### -->
1602 <!-- ##### FUNCTION gtk_requisition_copy ##### -->
1611 <!-- ##### FUNCTION gtk_requisition_free ##### -->
1619 <!-- ##### SIGNAL GtkWidget::accel-closures-changed ##### -->
1624 @widget: the object which received the signal.
1626 <!-- ##### SIGNAL GtkWidget::button-press-event ##### -->
1631 @widget: the object which received the signal.
1633 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1635 <!-- ##### SIGNAL GtkWidget::button-release-event ##### -->
1640 @widget: the object which received the signal.
1642 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1644 <!-- ##### SIGNAL GtkWidget::child-notify ##### -->
1649 @widget: the object which received the signal.
1652 <!-- ##### SIGNAL GtkWidget::client-event ##### -->
1657 @widget: the object which received the signal.
1659 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1661 <!-- ##### SIGNAL GtkWidget::configure-event ##### -->
1666 @widget: the object which received the signal.
1668 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1670 <!-- ##### SIGNAL GtkWidget::delete-event ##### -->
1675 @widget: the object which received the signal.
1677 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1679 <!-- ##### SIGNAL GtkWidget::destroy-event ##### -->
1684 @widget: the object which received the signal.
1686 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1688 <!-- ##### SIGNAL GtkWidget::direction-changed ##### -->
1693 @widget: the object which received the signal.
1696 <!-- ##### SIGNAL GtkWidget::drag-begin ##### -->
1701 @widget: the object which received the signal.
1704 <!-- ##### SIGNAL GtkWidget::drag-data-delete ##### -->
1709 @widget: the object which received the signal.
1712 <!-- ##### SIGNAL GtkWidget::drag-data-get ##### -->
1717 @widget: the object which received the signal.
1722 <!-- # Unused Parameters # -->
1725 <!-- ##### SIGNAL GtkWidget::drag-data-received ##### -->
1730 @widget: the object which received the signal.
1737 <!-- # Unused Parameters # -->
1740 <!-- ##### SIGNAL GtkWidget::drag-drop ##### -->
1745 @widget: the object which received the signal.
1751 <!-- # Unused Parameters # -->
1754 <!-- ##### SIGNAL GtkWidget::drag-end ##### -->
1759 @widget: the object which received the signal.
1762 <!-- ##### SIGNAL GtkWidget::drag-leave ##### -->
1767 @widget: the object which received the signal.
1770 <!-- # Unused Parameters # -->
1773 <!-- ##### SIGNAL GtkWidget::drag-motion ##### -->
1778 @widget: the object which received the signal.
1784 <!-- # Unused Parameters # -->
1787 <!-- ##### SIGNAL GtkWidget::enter-notify-event ##### -->
1792 @widget: the object which received the signal.
1794 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1796 <!-- ##### SIGNAL GtkWidget::event ##### -->
1801 @widget: the object which received the signal.
1803 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1805 <!-- ##### SIGNAL GtkWidget::event-after ##### -->
1810 @widget: the object which received the signal.
1813 <!-- ##### SIGNAL GtkWidget::expose-event ##### -->
1818 @widget: the object which received the signal.
1820 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1822 <!-- ##### SIGNAL GtkWidget::focus ##### -->
1827 @widget: the object which received the signal.
1829 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1831 <!-- ##### SIGNAL GtkWidget::focus-in-event ##### -->
1836 @widget: the object which received the signal.
1838 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1840 <!-- ##### SIGNAL GtkWidget::focus-out-event ##### -->
1845 @widget: the object which received the signal.
1847 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1849 <!-- ##### SIGNAL GtkWidget::grab-focus ##### -->
1854 @widget: the object which received the signal.
1856 <!-- ##### SIGNAL GtkWidget::grab-notify ##### -->
1861 @widget: the object which received the signal.
1864 <!-- ##### SIGNAL GtkWidget::hide ##### -->
1869 @widget: the object which received the signal.
1871 <!-- ##### SIGNAL GtkWidget::hierarchy-changed ##### -->
1873 Emitted when there is a chance in the hierarchy to
1874 which a widget belong. More precisely, a widget is
1875 <firstterm>anchored</firstterm> when its toplevel
1876 ancestor is a #GtkWindow. This signal is emitted when
1877 a widget changes from un-anchored to anchored or vice-versa.
1880 @widget: the object which received the signal.
1883 <!-- ##### SIGNAL GtkWidget::key-press-event ##### -->
1888 @widget: the object which received the signal.
1890 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1892 <!-- ##### SIGNAL GtkWidget::key-release-event ##### -->
1897 @widget: the object which received the signal.
1899 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1901 <!-- ##### SIGNAL GtkWidget::leave-notify-event ##### -->
1906 @widget: the object which received the signal.
1908 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1910 <!-- ##### SIGNAL GtkWidget::map ##### -->
1915 @widget: the object which received the signal.
1917 <!-- ##### SIGNAL GtkWidget::map-event ##### -->
1922 @widget: the object which received the signal.
1924 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1926 <!-- ##### SIGNAL GtkWidget::mnemonic-activate ##### -->
1931 @widget: the object which received the signal.
1935 <!-- ##### SIGNAL GtkWidget::motion-notify-event ##### -->
1940 @widget: the object which received the signal.
1942 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1944 <!-- ##### SIGNAL GtkWidget::no-expose-event ##### -->
1949 @widget: the object which received the signal.
1951 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1953 <!-- ##### SIGNAL GtkWidget::parent-set ##### -->
1958 @widget: the object which received the signal.
1961 <!-- ##### SIGNAL GtkWidget::popup-menu ##### -->
1966 @widget: the object which received the signal.
1969 <!-- ##### SIGNAL GtkWidget::property-notify-event ##### -->
1974 @widget: the object which received the signal.
1976 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1978 <!-- ##### SIGNAL GtkWidget::proximity-in-event ##### -->
1983 @widget: the object which received the signal.
1985 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1987 <!-- ##### SIGNAL GtkWidget::proximity-out-event ##### -->
1992 @widget: the object which received the signal.
1994 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
1996 <!-- ##### SIGNAL GtkWidget::realize ##### -->
2001 @widget: the object which received the signal.
2003 <!-- ##### SIGNAL GtkWidget::screen-changed ##### -->
2008 @widget: the object which received the signal.
2011 <!-- ##### SIGNAL GtkWidget::scroll-event ##### -->
2016 @widget: the object which received the signal.
2018 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
2020 <!-- ##### SIGNAL GtkWidget::selection-clear-event ##### -->
2025 @widget: the object which received the signal.
2027 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
2029 <!-- ##### SIGNAL GtkWidget::selection-get ##### -->
2034 @widget: the object which received the signal.
2038 <!-- # Unused Parameters # -->
2041 <!-- ##### SIGNAL GtkWidget::selection-notify-event ##### -->
2046 @widget: the object which received the signal.
2048 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
2050 <!-- ##### SIGNAL GtkWidget::selection-received ##### -->
2055 @widget: the object which received the signal.
2058 <!-- # Unused Parameters # -->
2061 <!-- ##### SIGNAL GtkWidget::selection-request-event ##### -->
2066 @widget: the object which received the signal.
2068 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
2070 <!-- ##### SIGNAL GtkWidget::show ##### -->
2075 @widget: the object which received the signal.
2077 <!-- ##### SIGNAL GtkWidget::show-help ##### -->
2082 @widget: the object which received the signal.
2086 <!-- ##### SIGNAL GtkWidget::size-allocate ##### -->
2091 @widget: the object which received the signal.
2094 <!-- ##### SIGNAL GtkWidget::size-request ##### -->
2099 @widget: the object which received the signal.
2102 <!-- ##### SIGNAL GtkWidget::state-changed ##### -->
2107 @widget: the object which received the signal.
2110 <!-- ##### SIGNAL GtkWidget::style-set ##### -->
2115 @widget: the object which received the signal.
2118 <!-- ##### SIGNAL GtkWidget::unmap ##### -->
2123 @widget: the object which received the signal.
2125 <!-- ##### SIGNAL GtkWidget::unmap-event ##### -->
2130 @widget: the object which received the signal.
2132 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
2134 <!-- ##### SIGNAL GtkWidget::unrealize ##### -->
2139 @widget: the object which received the signal.
2141 <!-- ##### SIGNAL GtkWidget::visibility-notify-event ##### -->
2146 @widget: the object which received the signal.
2148 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
2150 <!-- ##### SIGNAL GtkWidget::window-state-event ##### -->
2155 @widget: the object which received the signal.
2157 @Returns: %TRUE to stop other handlers from being invoked for the event. %FALSE to propagate the event further.
2159 <!-- ##### ARG GtkWidget:app-paintable ##### -->
2164 <!-- ##### ARG GtkWidget:can-default ##### -->
2169 <!-- ##### ARG GtkWidget:can-focus ##### -->
2174 <!-- ##### ARG GtkWidget:composite-child ##### -->
2179 <!-- ##### ARG GtkWidget:events ##### -->
2184 <!-- ##### ARG GtkWidget:extension-events ##### -->
2189 <!-- ##### ARG GtkWidget:has-default ##### -->
2194 <!-- ##### ARG GtkWidget:has-focus ##### -->
2199 <!-- ##### ARG GtkWidget:height-request ##### -->
2204 <!-- ##### ARG GtkWidget:is-focus ##### -->
2209 <!-- ##### ARG GtkWidget:name ##### -->
2214 <!-- ##### ARG GtkWidget:parent ##### -->
2219 <!-- ##### ARG GtkWidget:receives-default ##### -->
2224 <!-- ##### ARG GtkWidget:sensitive ##### -->
2229 <!-- ##### ARG GtkWidget:style ##### -->
2234 <!-- ##### ARG GtkWidget:visible ##### -->
2239 <!-- ##### ARG GtkWidget:width-request ##### -->
2244 <!-- ##### ARG GtkWidget:cursor-aspect-ratio ##### -->
2249 <!-- ##### ARG GtkWidget:cursor-color ##### -->
2254 <!-- ##### ARG GtkWidget:focus-line-pattern ##### -->
2259 <!-- ##### ARG GtkWidget:focus-line-width ##### -->
2264 <!-- ##### ARG GtkWidget:focus-padding ##### -->
2269 <!-- ##### ARG GtkWidget:interior-focus ##### -->
2274 <!-- ##### ARG GtkWidget:secondary-cursor-color ##### -->