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 (...)
       •   ... (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 (...)
       •   ... (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)
       •   $child (Gtk2::Widget)

       •   $response_id (Gtk2::ResponseType)

   widget = $info_bar->add_button ($button_text, $response_id)
       •   $button_text (string)

       •   $response_id (scalar)

   $info_bar->add_buttons (...)
       •   ... (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)
       •   $response_id (Gtk2::ResponseType)

   messagetype = $info_bar->get_message_type
   $info_bar->set_message_type ($type)
       •   $type (Gtk2::MessageType)

   $info_bar->response ($response_id)
       •   $response_id (Gtk2::ResponseType)

   $info_bar->set_response_sensitive ($response_id, $setting)
       •   $response_id (Gtk2::ResponseType)

       •   $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

       close (Gtk2::InfoBar)
       response (Gtk2::InfoBar, integer)

       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
       •   'info' / 'GTK_MESSAGE_INFO'

       •   'warning' / 'GTK_MESSAGE_WARNING'

       •   'question' / 'GTK_MESSAGE_QUESTION'

       •   'error' / 'GTK_MESSAGE_ERROR'

       •   '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.

       •   'none' / 'GTK_RESPONSE_NONE'

       •   'reject' / 'GTK_RESPONSE_REJECT'

       •   'accept' / 'GTK_RESPONSE_ACCEPT'

       •   'delete-event' / 'GTK_RESPONSE_DELETE_EVENT'

       •   'ok' / 'GTK_RESPONSE_OK'

       •   'cancel' / 'GTK_RESPONSE_CANCEL'

       •   'close' / 'GTK_RESPONSE_CLOSE'

       •   'yes' / 'GTK_RESPONSE_YES'

       •   'no' / 'GTK_RESPONSE_NO'

       •   'apply' / 'GTK_RESPONSE_APPLY'

       •   '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.