Gtk2::InfoBar(3pm) User Contributed Perl Documentation Gtk2::InfoBar(3pm)
NAME
Gtk2::InfoBar - wrapper for GtkInfoBar
HIERARCHY
Glib::Object
+----Glib::InitiallyUnowned
+----Gtk2::Object
+----Gtk2::Widget
+----Gtk2::Container
+----Gtk2::Box
+----Gtk2::HBox
+----Gtk2::InfoBar
INTERFACES
Glib::Object::_Unregistered::AtkImplementorIface
Gtk2::Buildable
Gtk2::Orientable
METHODS
$widget = Gtk2::InfoBar->new;
$widget = Gtk2::InfoBar->new (...)
o ... (list) of button-text => response-id pairs.
The multi-argument form takes the same list of text => response-id pairs as "$infobar->add_buttons". Do not pack widgets directly into the
infobar; add them to "$infobar->get_content_area ()".
Here's a simple example:
$infobar = Gtk2::InfoBar->new ('gtk-ok' => 'accept',
'gtk-cancel' => 'reject');
$widget = Gtk2::InfoBar->new_with_buttons (...)
o ... (list) of button-text => response-id pairs.
Alias for the multi-argument version of "Gtk2::InfoBar->new".
widget = $info_bar->get_action_area
$info_bar->add_action_widget ($child, $response_id)
o $child (Gtk2::Widget)
o $response_id (Gtk2::ResponseType)
widget = $info_bar->add_button ($button_text, $response_id)
o $button_text (string)
o $response_id (scalar)
$info_bar->add_buttons (...)
o ... (list) of button-text => response-id pairs
Like calling "$infobar->add_button" repeatedly, except you don't get the created widgets back. The buttons go from left to right, so the
first button added will be the left-most one.
widget = $info_bar->get_content_area
$info_bar->set_default_response ($response_id)
o $response_id (Gtk2::ResponseType)
messagetype = $info_bar->get_message_type
$info_bar->set_message_type ($type)
o $type (Gtk2::MessageType)
$info_bar->response ($response_id)
o $response_id (Gtk2::ResponseType)
$info_bar->set_response_sensitive ($response_id, $setting)
o $response_id (Gtk2::ResponseType)
o $setting (boolean)
Enable or disable an action button by its $response_id.
PROPERTIES
'message-type' (Gtk2::MessageType : default "info" : readable / writable / construct / private)
The type of message
STYLE PROPERTIES
'action-area-border' (integer : default 5 : readable / private)
Width of border around the action area
'button-spacing' (integer : default 6 : readable / private)
Spacing between buttons
'content-area-border' (integer : default 8 : readable / private)
Width of border around the content area
'content-area-spacing' (integer : default 16 : readable / private)
Spacing between elements of the area
SIGNALS
response (Gtk2::InfoBar, integer)
close (Gtk2::InfoBar)
Note that currently in a Perl subclass of "Gtk2::InfoBar" a class closure, ie. class default signal handler, for the "response" signal will
be called with the response ID just as an integer, it's not turned into an enum string like "ok" the way a handler setup with
"signal_connect" receives.
Hopefully this will change in the future, so don't count on it. In the interim the easiest thing to do is install your default handler in
"INIT_INSTANCE" with a "signal_connect". (The subtleties of what order handlers are called in will differ, but often that doesn't matter.)
ENUMS AND FLAGS
enum Gtk2::MessageType
o 'info' / 'GTK_MESSAGE_INFO'
o 'warning' / 'GTK_MESSAGE_WARNING'
o 'question' / 'GTK_MESSAGE_QUESTION'
o 'error' / 'GTK_MESSAGE_ERROR'
o 'other' / 'GTK_MESSAGE_OTHER'
enum Gtk2::ResponseType
The response type is somewhat abnormal as far as gtk2-perl enums go. In C, this enum lists named, predefined integer values for a field
that is other composed of whatever integer values you like. In Perl, we allow this to be either one of the string constants listed here or
any positive integer value. For example, 'ok', 'cancel', 4, and 42 are all valid response ids. You cannot use arbitrary string values,
they must be integers. Be careful, because unknown string values tend to be mapped to 0.
o 'none' / 'GTK_RESPONSE_NONE'
o 'reject' / 'GTK_RESPONSE_REJECT'
o 'accept' / 'GTK_RESPONSE_ACCEPT'
o 'delete-event' / 'GTK_RESPONSE_DELETE_EVENT'
o 'ok' / 'GTK_RESPONSE_OK'
o 'cancel' / 'GTK_RESPONSE_CANCEL'
o 'close' / 'GTK_RESPONSE_CLOSE'
o 'yes' / 'GTK_RESPONSE_YES'
o 'no' / 'GTK_RESPONSE_NO'
o 'apply' / 'GTK_RESPONSE_APPLY'
o 'help' / 'GTK_RESPONSE_HELP'
SEE ALSO
Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Box, Gtk2::HBox
COPYRIGHT
Copyright (C) 2003-2011 by the gtk2-perl team.
This software is licensed under the LGPL. See Gtk2 for a full notice.
perl v5.14.2 2012-05-27 Gtk2::InfoBar(3pm)