GtkObject::set_flags
This method allows you to set any of the flags defined by the
GtkWidgetFlags enumerated values. These
flags share the flags space in GtkObject;
the first four bits are taken by
GtkObjectFlags, and derived objects use
the remaining bitfields. The GtkWidgetFlags
settings determine the capabilities of a widget; e.g the flag
GTK_NO_WINDOW is set on certain widgets during
their creation in the GTK source, reversing the generic widget
property of $widget->window; - such widgets
are not able to respond unilaterally to GDK events. (Use a
GtkEventBox to capture events on windowless
widgets.)
You would use set_flags()
in a situation where the widget needs capabilities it does not
have at base; setting for instance
GTK_CAN_DEFAULT on a
GtkButton you want to have keyboard grab
by default will cause that button to be drawn in such a way that
space is allowed for it to be displayed with default status.
Although all the flag bitfields are reversible in this way, it is
not always sane to alter them, given that the chief
characteristics of a widget are controlled by them. For example,
unsetting the GTK_NO_WINDOW flag on a
GtkLabel widget will prevent the label from
displaying its current text.
See also: flags() ,
unset_flags() , and a whole
host of GtkWidget methods such as
set_sensitive() and
grab_default() which
either act as wrappers for the
set_flags() function or
need to work in tandem with GtkWidgetFlags
values set in this way.
