<!-- ##### ENUM GtkWidgetFlags ##### -->
<para>
-
+Tells about certain properties of the widget.
</para>
@GTK_TOPLEVEL:
+ widgets without a real parent, as there are #GtkWindow<!>s and
+ #GtkMenu<!>s have this flag set throughout their lifetime.
+ Toplevel widgets always contain their own #GdkWindow.
@GTK_NO_WINDOW:
+ Indicative for a widget that does not provide its own #GdkWindow.
+ Visible action (e.g. drawing) is performed on the parent's #GdkWindow.
@GTK_REALIZED:
+ Set by gtk_widget_realize(), unset by gtk_widget_unrealize().
+ A realized widget has an associated #GdkWindow.
@GTK_MAPPED:
+ Set by gtk_widget_map(), unset by gtk_widget_unmap().
+ Only realized widgets can be mapped. It means that gdk_window_show()
+ has been called on the widgets window(s).
@GTK_VISIBLE:
+ Set by gtk_widget_show(), unset by gtk_widget_hide(). Implies that a
+ widget will be mapped as soon as its parent is mapped.
@GTK_SENSITIVE:
+ Set and unset by gtk_widget_set_sensitive().
+ The sensitivity of a widget determines whether it will receive
+ certain events (e.g. button or key presses). One premise for
+ the widgets sensitivity is to have this flag set.
@GTK_PARENT_SENSITIVE:
+ Set and unset by gtk_widget_set_sensitive() operations on the
+ parents of the widget.
+ This is the second premise for the widgets sensitivity. Once
+ it has %GTK_SENSITIVE and %GTK_PARENT_SENSITIVE set, its state is
+ effectively sensitive. This is expressed (and can be examined) by
+ the #GTK_WIDGET_IS_SENSITIVE macro.
@GTK_CAN_FOCUS:
+ Determines whether a widget is able to handle focus grabs.
@GTK_HAS_FOCUS:
+ Set by gtk_widget_grab_focus() for widgets that also
+ have %GTK_CAN_FOCUS set. The flag will be unset once another widget
+ grabs the focus.
@GTK_CAN_DEFAULT:
+ The widget is allowed to receive the default action via
+ gtk_widget_grab_default().
@GTK_HAS_DEFAULT:
+ The widget currently is receiving the default action.
@GTK_HAS_GRAB:
+ Set by gtk_grab_add(), unset by gtk_grab_remove(). It means that the
+ widget is in the grab_widgets stack, and will be the preferred one for
+ receiving events other than ones of cosmetic value.
@GTK_RC_STYLE:
+ Indicates that the widgets style has been looked up through the rc
+ mechanism. It does not imply that the widget actually had a style
+ defined through the rc mechanism.
@GTK_COMPOSITE_CHILD:
+ Indicates that the widget is a composite child of its parent; see
+ gtk_widget_push_composite_child(), gtk_widget_pop_composite_child().
@GTK_NO_REPARENT:
+ Unused since before GTK+ 1.2, will be removed in a future version.
@GTK_APP_PAINTABLE:
+ Set and unset by gtk_widget_set_app_paintable().
+ Must be set on widgets whose window the application directly draws on,
+ in order to keep GTK+ from overwriting the drawn stuff.
@GTK_RECEIVES_DEFAULT:
+ The widget when focused will receive the default action and have
+ %GTK_HAS_DEFAULT set even if there is a different widget set as default.
@GTK_DOUBLE_BUFFERED:
+ Set and unset by gtk_widget_set_double_buffered().
+ Indicates that exposes done on the widget should be double-buffered.
<!-- ##### MACRO GTK_WIDGET_TYPE ##### -->
<para>
-
+Gets the type of a widget.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_STATE ##### -->
<para>
-
+Returns the current state of the widget, as a #GtkStateType.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_SAVED_STATE ##### -->
<para>
-
+Returns the saved state of the widget, as a #GtkStateType.
+</para>
+<para>
+The saved state will be restored when a widget gets sensitive
+again, after it has been made insensitive with gtk_widget_set_state()
+or gtk_widget_set_sensitive().
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_FLAGS ##### -->
<para>
-
+Returns the widget flags from @wid.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_TOPLEVEL ##### -->
<para>
-
+Evaluates to %TRUE if the widget is a toplevel widget.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_NO_WINDOW ##### -->
<para>
-
+Evaluates to %TRUE if the widget doesn't have an own #GdkWindow.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_REALIZED ##### -->
<para>
-
+Evaluates to %TRUE if the widget is realized.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_MAPPED ##### -->
<para>
-
+Evaluates to %TRUE if the widget is mapped.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_VISIBLE ##### -->
<para>
-
+Evaluates to %TRUE if the widget is visible.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_DRAWABLE ##### -->
<para>
-
+Evaluates to %TRUE if the widget is mapped and visible.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_SENSITIVE ##### -->
<para>
-
+Evaluates to %TRUE if the #GTK_SENSITIVE flag has be set on the widget.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_PARENT_SENSITIVE ##### -->
<para>
-
+Evaluates to %TRUE if the #GTK_PARENT_SENSITIVE flag has be set on the widget.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_IS_SENSITIVE ##### -->
<para>
-
+Evaluates to %TRUE if the widget is effectively sensitive.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_CAN_FOCUS ##### -->
<para>
-
+Evaluates to %TRUE if the widget is able to handle focus grabs.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_HAS_FOCUS ##### -->
<para>
-
+Evaluates to %TRUE if the widget has grabbed the focus and no other
+widget has done so more recently.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_CAN_DEFAULT ##### -->
<para>
-
+Evaluates to %TRUE if the widget is allowed to receive the default action
+via gtk_widget_grab_default().
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_RECEIVES_DEFAULT ##### -->
<para>
-
+Evaluates to %TRUE if the widget when focused will receive the default action
+even if there is a different widget set as default.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_HAS_DEFAULT ##### -->
<para>
-
+Evaluates to %TRUE if the widget currently is receiving the default action.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_HAS_GRAB ##### -->
<para>
-
+Evaluates to %TRUE if the widget is in the grab_widgets stack, and will be
+the preferred one for receiving events other than ones of cosmetic value.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_RC_STYLE ##### -->
<para>
-
+Evaluates to %TRUE if the widgets style has been looked up through the rc
+mechanism.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_COMPOSITE_CHILD ##### -->
<para>
-
+Evaluates to %TRUE if the widget is a composite child of its parent.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_APP_PAINTABLE ##### -->
<para>
-
+Evaluates to %TRUE if the #GTK_APP_PAINTABLE flag has been set on the widget.
</para>
-@wid:
+@wid: a #GtkWidget.
<!-- ##### MACRO GTK_WIDGET_DOUBLE_BUFFERED ##### -->
<para>
-
+Evaluates to %TRUE if the #GTK_DOUBLE_BUFFERED flag has been set on the widget.
</para>
@wid:
<!-- ##### MACRO GTK_WIDGET_SET_FLAGS ##### -->
<para>
-
+Turns on certain widget flags.
</para>
-@wid:
-@flag:
+@wid: a #GtkWidget.
+@flag: the flags to set.
<!-- ##### MACRO GTK_WIDGET_UNSET_FLAGS ##### -->
<para>
-
+Turns off certain widget flags.
</para>
-@wid:
-@flag:
+@wid: a #GtkWidget.
+@flag: the flags to unset.
<!-- ##### USER_FUNCTION GtkCallback ##### -->
@y:
@width:
@height:
+@x_set:
+@y_set:
<!-- ##### STRUCT GtkWidgetShapeInfo ##### -->
<para>
@offset_y:
@shape_mask:
+<!-- ##### ENUM GtkWidgetHelpType ##### -->
+<para>
+
+</para>
+
+@GTK_WIDGET_HELP_TOOLTIP:
+@GTK_WIDGET_HELP_WHATS_THIS:
+
<!-- ##### FUNCTION gtk_widget_new ##### -->
<para>
@accel_group:
@accel_key:
@accel_mods:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_remove_accelerators ##### -->
+<!-- ##### FUNCTION gtk_widget_set_accel_path ##### -->
<para>
</para>
@widget:
-@accel_signal:
-@visible_only:
+@accel_path:
+@accel_group:
-<!-- ##### FUNCTION gtk_widget_accelerator_signal ##### -->
+<!-- ##### FUNCTION gtk_widget_list_accel_closures ##### -->
<para>
</para>
@widget:
-@accel_group:
-@accel_key:
-@accel_mods:
@Returns:
@new_parent:
-<!-- ##### FUNCTION gtk_widget_popup ##### -->
-<para>
-
-</para>
-
-@widget:
-@x:
-@y:
-
-
<!-- ##### FUNCTION gtk_widget_intersect ##### -->
<para>
@Returns:
+<!-- ##### FUNCTION gtk_widget_translate_coordinates ##### -->
+<para>
+
+</para>
+
+@src_widget:
+@dest_widget:
+@src_x:
+@src_y:
+@dest_x:
+@dest_y:
+@Returns:
+
+
<!-- ##### FUNCTION gtk_widget_hide_on_delete ##### -->
<para>
@style:
-<!-- ##### FUNCTION gtk_widget_set_rc_style ##### -->
+<!-- ##### MACRO gtk_widget_set_rc_style ##### -->
<para>
-
+Equivalent to <literal>gtk_widget_set_style (widget, NULL)</literal>.
</para>
-@widget:
+@widget: a #GtkWidget.
<!-- ##### FUNCTION gtk_widget_ensure_style ##### -->
@Returns:
-<!-- ##### FUNCTION gtk_widget_restore_default_style ##### -->
+<!-- ##### MACRO gtk_widget_restore_default_style ##### -->
<para>
-
+Equivalent to <literal>gtk_widget_set_style (widget, NULL)</literal>.
</para>
-@widget:
+@widget: a #GtkWidget.
<!-- ##### FUNCTION gtk_widget_reset_rc_styles ##### -->
<para>
-
+Calls gtk_widget_set_rc_style() recursively on all descendants.
</para>
-@widget:
-
-
-<!-- ##### FUNCTION gtk_widget_push_style ##### -->
-<para>
-
-</para>
-
-@style:
+@widget: a #GtkWidget.
<!-- ##### FUNCTION gtk_widget_push_colormap ##### -->
@cmap:
-<!-- ##### FUNCTION gtk_widget_pop_style ##### -->
-<para>
-
-</para>
-
-
-
<!-- ##### FUNCTION gtk_widget_pop_colormap ##### -->
<para>
-<!-- ##### FUNCTION gtk_widget_set_default_style ##### -->
-<para>
-
-</para>
-
-@style:
-
-
<!-- ##### FUNCTION gtk_widget_set_default_colormap ##### -->
<para>
@Returns:
-<!-- ##### FUNCTION gtk_widget_lock_accelerators ##### -->
-<para>
-
-</para>
-
-@widget:
-
-
<!-- ##### FUNCTION gtk_widget_modify_style ##### -->
<para>
@double_buffered:
+<!-- ##### FUNCTION gtk_widget_set_redraw_on_allocate ##### -->
+<para>
+
+</para>
+
+@widget:
+@redraw_on_allocate:
+
+
<!-- ##### FUNCTION gtk_widget_set_composite_name ##### -->
<para>
@Returns:
-<!-- ##### FUNCTION gtk_widget_unlock_accelerators ##### -->
+<!-- ##### FUNCTION gtk_widget_mnemonic_activate ##### -->
+<para>
+
+</para>
+
+@widget:
+@group_cycling:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_widget_class_install_style_property ##### -->
+<para>
+
+</para>
+
+@klass:
+@pspec:
+<!-- # Unused Parameters # -->
+@class:
+
+
+<!-- ##### FUNCTION gtk_widget_class_install_style_property_parser ##### -->
+<para>
+
+</para>
+
+@klass:
+@pspec:
+@parser:
+<!-- # Unused Parameters # -->
+@class:
+
+
+<!-- ##### FUNCTION gtk_widget_region_intersect ##### -->
+<para>
+
+</para>
+
+@widget:
+@region:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_widget_send_expose ##### -->
+<para>
+
+</para>
+
+@widget:
+@event:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_widget_style_get ##### -->
+<para>
+
+</para>
+
+@widget:
+@first_property_name:
+@Varargs:
+
+
+<!-- ##### FUNCTION gtk_widget_style_get_property ##### -->
+<para>
+
+</para>
+
+@widget:
+@property_name:
+@value:
+
+
+<!-- ##### FUNCTION gtk_widget_style_get_valist ##### -->
+<para>
+
+</para>
+
+@widget:
+@first_property_name:
+@var_args:
+
+
+<!-- ##### FUNCTION gtk_widget_get_accessible ##### -->
+<para>
+
+</para>
+
+@widget:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_widget_child_focus ##### -->
+<para>
+
+</para>
+
+@widget:
+@direction:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_widget_child_notify ##### -->
+<para>
+
+</para>
+
+@widget:
+@child_property:
+
+
+<!-- ##### FUNCTION gtk_widget_freeze_child_notify ##### -->
+<para>
+
+</para>
+
+@widget:
+
+
+<!-- ##### FUNCTION gtk_widget_get_child_visible ##### -->
+<para>
+
+</para>
+
+@widget:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_widget_get_parent ##### -->
<para>
</para>
@widget:
+@Returns:
-<!-- ##### FUNCTION gtk_widget_accelerators_locked ##### -->
+<!-- ##### FUNCTION gtk_widget_get_settings ##### -->
<para>
</para>
@Returns:
-<!-- ##### SIGNAL GtkWidget::add-accelerator ##### -->
+<!-- ##### FUNCTION gtk_widget_get_size_request ##### -->
+<para>
+
+</para>
+
+@widget:
+@width:
+@height:
+
+
+<!-- ##### MACRO gtk_widget_pop_visual ##### -->
+<para>
+This function is deprecated; it does nothing.
+</para>
+
+
+
+<!-- ##### MACRO gtk_widget_push_visual ##### -->
+<para>
+This function is deprecated; it does nothing.
+</para>
+
+@visual:
+
+
+<!-- ##### FUNCTION gtk_widget_set_child_visible ##### -->
+<para>
+
+</para>
+
+@widget:
+@is_visible:
+
+
+<!-- ##### MACRO gtk_widget_set_default_visual ##### -->
+<para>
+This function is deprecated; it does nothing.
+</para>
+
+@visual:
+
+
+<!-- ##### FUNCTION gtk_widget_set_size_request ##### -->
+<para>
+
+</para>
+
+@widget:
+@width:
+@height:
+
+
+<!-- ##### MACRO gtk_widget_set_visual ##### -->
+<para>
+This function is deprecated; it does nothing.
+</para>
+
+@widget:
+@visual:
+
+
+<!-- ##### FUNCTION gtk_widget_thaw_child_notify ##### -->
+<para>
+
+</para>
+
+@widget:
+
+
+<!-- ##### FUNCTION gtk_requisition_copy ##### -->
+<para>
+
+</para>
+
+@requisition:
+@Returns:
+
+
+<!-- ##### FUNCTION gtk_requisition_free ##### -->
+<para>
+
+</para>
+
+@requisition:
+
+
+<!-- ##### SIGNAL GtkWidget::accel-closures-changed ##### -->
<para>
</para>
@widget: the object which received the signal.
-@accel_signal_id:
-@accel_group:
-@accel_key:
-@accel_mods:
-@accel_flags:
<!-- ##### SIGNAL GtkWidget::button-press-event ##### -->
<para>
@event:
@Returns:
+<!-- ##### SIGNAL GtkWidget::child-notify ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@arg1:
+
<!-- ##### SIGNAL GtkWidget::client-event ##### -->
<para>
@event:
@Returns:
+<!-- ##### SIGNAL GtkWidget::event-after ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@event:
+
<!-- ##### SIGNAL GtkWidget::expose-event ##### -->
<para>
@event:
@Returns:
+<!-- ##### SIGNAL GtkWidget::focus ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@arg1:
+@Returns:
+
<!-- ##### SIGNAL GtkWidget::focus-in-event ##### -->
<para>
@widget: the object which received the signal.
+<!-- ##### SIGNAL GtkWidget::grab-notify ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@arg1:
+
<!-- ##### SIGNAL GtkWidget::hide ##### -->
<para>
@widget: the object which received the signal.
+<!-- ##### SIGNAL GtkWidget::hierarchy-changed ##### -->
+<para>
+Emitted when there is a chance in the hierarchy to
+which a widget belong. More precisely, a widget is
+<firstterm>anchored</firstterm> when its toplevel
+ancestor is a #GtkWindow. This signal is emitted when
+a widget changes from un-anchored to anchored or vice-versa.
+</para>
+
+@widget: the object which received the signal.
+@widget:
+
<!-- ##### SIGNAL GtkWidget::key-press-event ##### -->
<para>
@event:
@Returns:
+<!-- ##### SIGNAL GtkWidget::mnemonic-activate ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@arg1:
+@Returns:
+
<!-- ##### SIGNAL GtkWidget::motion-notify-event ##### -->
<para>
@widget: the object which received the signal.
@old_parent:
-<!-- ##### SIGNAL GtkWidget::property-notify-event ##### -->
+<!-- ##### SIGNAL GtkWidget::popup-menu ##### -->
<para>
</para>
@widget: the object which received the signal.
-@event:
-@Returns:
-<!-- ##### SIGNAL GtkWidget::proximity-in-event ##### -->
+<!-- ##### SIGNAL GtkWidget::property-notify-event ##### -->
<para>
</para>
@event:
@Returns:
-<!-- ##### SIGNAL GtkWidget::proximity-out-event ##### -->
+<!-- ##### SIGNAL GtkWidget::proximity-in-event ##### -->
<para>
</para>
@event:
@Returns:
-<!-- ##### SIGNAL GtkWidget::realize ##### -->
+<!-- ##### SIGNAL GtkWidget::proximity-out-event ##### -->
<para>
</para>
@widget: the object which received the signal.
+@event:
+@Returns:
-<!-- ##### SIGNAL GtkWidget::remove-accelerator ##### -->
+<!-- ##### SIGNAL GtkWidget::realize ##### -->
<para>
</para>
@widget: the object which received the signal.
-@accel_group:
-@accel_key:
-@accel_mods:
<!-- ##### SIGNAL GtkWidget::scroll-event ##### -->
<para>
@widget: the object which received the signal.
+<!-- ##### SIGNAL GtkWidget::show-help ##### -->
+<para>
+
+</para>
+
+@widget: the object which received the signal.
+@arg1:
+
<!-- ##### SIGNAL GtkWidget::size-allocate ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:x ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWidget:y ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkWidget:width ##### -->
+<!-- ##### ARG GtkWidget:width-request ##### -->
<para>
</para>
-<!-- ##### ARG GtkWidget:height ##### -->
+<!-- ##### ARG GtkWidget:height-request ##### -->
<para>
</para>
projects / ~andy / gtk / blobdiff