CONSTANTS

EVENT_STOP and EVENT_PROPAGATE are designed for the return from widget event signal handlers and similar, being true to stop or false to propagate. The names can help you avoid confusion over which way is true and which is false. (You can also remember the return as meaning "handled", which is the jargon in a few other signal handler types.)

Gtk2::EVENT_STOP         # true
Gtk2::EVENT_PROPAGATE    # false

The returned requisition object points into $widget and can only be used as long as $widget exists.

The returned rect object points into $widget and can only be used as long as $widget exists.

You can also call this function from an application, with some caveats. Most notably, getting a size request requires the widget to be associated with a screen, because font information may be needed. Multihead-aware applications should keep this in mind.

Also remember that the size request is not necessarily the size a widget will actually be allocated.

See also get_child_requisition ()

This function differs from size_request() in that it retrieves the last size request value from $widget->requisition, while size_request() actually calls the size_request virtual method (that is, emits the "size-request" signal) on the $widget to compute the size request and fill in $widget->requisition, and only then returns $widget->requisition.

Because this function does not call the size_request method, it can only be used when you know that $widget->requisition is up-to-date. In general, only container implementations have this information; applications should use size_request ().

Currently if you make a widget subclass in Perl there's no way to nominate a signal to be emitted by $widget->activate. A signal merely named activate is not automatically hooked up.

If you make a widget subclass in Perl and create a signal in it called set-scroll-adjustments taking two Gtk2::Adjustment parameters then the subclassing automatically hooks that up to be emitted by $widget->set_scroll_adjustments. (Your "class closure" default handler code should then store the adjustment objects somewhere.)

Gets the size request that was explicitly set for the widget using set_size_request(). A value of -1 for width or height indicates that the dimension has not been explicitly set and the natural requisition of the widget will be used instead. See set_size_request(). To get the size a widget will actually use, call size_request() instead of this function.

This is a helper function intended to be used as the callback for the delete-event signal:

$wiget->signal_connect (
  delete_event => \&Gtk2::Widget::hide_on_delete);