<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY version SYSTEM "version.xml">
]>
<!--ENTITY index-Objects-Grouped SYSTEM "objects_grouped.sgml"-->
<refentry id="GtkInfoBar">
<refmeta>
<refentrytitle role="top_of_page" id="GtkInfoBar.top_of_page">GtkInfoBar</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GTK Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GtkInfoBar</refname>
<refpurpose>Report important messages to the user</refpurpose>
</refnamediv>

<refsynopsisdiv id="GtkInfoBar.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>

#include &lt;gtk/gtk.h&gt;

                    <link linkend="GtkInfoBar-struct">GtkInfoBar</link>;
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-info-bar-new">gtk_info_bar_new</link>                    (void);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-info-bar-new-with-buttons">gtk_info_bar_new_with_buttons</link>       (const <link linkend="gchar">gchar</link> *first_button_text,
                                                         ...);
<link linkend="void">void</link>                <link linkend="gtk-info-bar-add-action-widget">gtk_info_bar_add_action_widget</link>      (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         <link linkend="GtkWidget">GtkWidget</link> *child,
                                                         <link linkend="gint">gint</link> response_id);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-info-bar-add-button">gtk_info_bar_add_button</link>             (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         const <link linkend="gchar">gchar</link> *button_text,
                                                         <link linkend="gint">gint</link> response_id);
<link linkend="void">void</link>                <link linkend="gtk-info-bar-add-buttons">gtk_info_bar_add_buttons</link>            (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         const <link linkend="gchar">gchar</link> *first_button_text,
                                                         ...);
<link linkend="void">void</link>                <link linkend="gtk-info-bar-set-response-sensitive">gtk_info_bar_set_response_sensitive</link> (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         <link linkend="gint">gint</link> response_id,
                                                         <link linkend="gboolean">gboolean</link> setting);
<link linkend="void">void</link>                <link linkend="gtk-info-bar-set-default-response">gtk_info_bar_set_default_response</link>   (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         <link linkend="gint">gint</link> response_id);
<link linkend="void">void</link>                <link linkend="gtk-info-bar-response">gtk_info_bar_response</link>               (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         <link linkend="gint">gint</link> response_id);
<link linkend="void">void</link>                <link linkend="gtk-info-bar-set-message-type">gtk_info_bar_set_message_type</link>       (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         <link linkend="GtkMessageType">GtkMessageType</link> message_type);
<link linkend="GtkMessageType">GtkMessageType</link>      <link linkend="gtk-info-bar-get-message-type">gtk_info_bar_get_message_type</link>       (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-info-bar-get-action-area">gtk_info_bar_get_action_area</link>        (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar);
<link linkend="GtkWidget">GtkWidget</link> *         <link linkend="gtk-info-bar-get-content-area">gtk_info_bar_get_content_area</link>       (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar);
</synopsis>
</refsynopsisdiv>

<refsect1 id="GtkInfoBar.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----<link linkend="GInitiallyUnowned">GInitiallyUnowned</link>
         +----<link linkend="GtkObject">GtkObject</link>
               +----<link linkend="GtkWidget">GtkWidget</link>
                     +----<link linkend="GtkContainer">GtkContainer</link>
                           +----<link linkend="GtkBox">GtkBox</link>
                                 +----<link linkend="GtkHBox">GtkHBox</link>
                                       +----GtkInfoBar
</synopsis>
</refsect1>



<refsect1 id="GtkInfoBar.implemented-interfaces" role="impl_interfaces">
<title role="impl_interfaces.title">Implemented Interfaces</title>
<para>
GtkInfoBar implements
 <link linkend="AtkImplementorIface">AtkImplementorIface</link>,  <link linkend="GtkBuildable">GtkBuildable</link> and  <link linkend="GtkOrientable">GtkOrientable</link>.</para>
</refsect1>


<refsect1 id="GtkInfoBar.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="GtkInfoBar--message-type">message-type</link>&quot;             <link linkend="GtkMessageType">GtkMessageType</link>        : Read / Write / Construct
</synopsis>
</refsect1>
<refsect1 id="GtkInfoBar.style-properties" role="style_properties">
<title role="style_properties.title">Style Properties</title>
<synopsis>
  &quot;<link linkend="GtkInfoBar--s-action-area-border">action-area-border</link>&quot;       <link linkend="gint">gint</link>                  : Read
  &quot;<link linkend="GtkInfoBar--s-button-spacing">button-spacing</link>&quot;           <link linkend="gint">gint</link>                  : Read
  &quot;<link linkend="GtkInfoBar--s-content-area-border">content-area-border</link>&quot;      <link linkend="gint">gint</link>                  : Read
  &quot;<link linkend="GtkInfoBar--s-content-area-spacing">content-area-spacing</link>&quot;     <link linkend="gint">gint</link>                  : Read
</synopsis>
</refsect1>

<refsect1 id="GtkInfoBar.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="GtkInfoBar-close">close</link>&quot;                                          : Run Last / Action
  &quot;<link linkend="GtkInfoBar-response">response</link>&quot;                                       : Run Last
</synopsis>
</refsect1>


<refsect1 id="GtkInfoBar.description" role="desc">
<title role="desc.title">Description</title>
<para>
<link linkend="GtkInfoBar"><type>GtkInfoBar</type></link> is a widget that can be used to show messages to
the user without showing a dialog. It is often temporarily shown
at the top or bottom of a document. In contrast to <link linkend="GtkDialog"><type>GtkDialog</type></link>, which
has a horizontal action area at the bottom, <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link> has a
vertical action area at the side.
</para>
<para>
The API of <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link> is very similar to <link linkend="GtkDialog"><type>GtkDialog</type></link>, allowing you
to add buttons to the action area with <link linkend="gtk-info-bar-add-button"><function>gtk_info_bar_add_button()</function></link> or
<link linkend="gtk-info-bar-new-with-buttons"><function>gtk_info_bar_new_with_buttons()</function></link>. The sensitivity of action widgets
can be controlled with <link linkend="gtk-info-bar-set-response-sensitive"><function>gtk_info_bar_set_response_sensitive()</function></link>.
To add widgets to the main content area of a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>, use
<link linkend="gtk-info-bar-get-content-area"><function>gtk_info_bar_get_content_area()</function></link> and add your widgets to the container.
</para>
<para>
Similar to <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link>, the contents of a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link> can by
classified as error message, warning, informational message, etc,
by using <link linkend="gtk-info-bar-set-message-type"><function>gtk_info_bar_set_message_type()</function></link>. GTK+ uses the message type
to determine the background color of the message area.
</para>
<para>
<example>
<title>Simple GtkInfoBar usage.</title>
<programlisting>
/&ast; set up info bar &ast;/
info_bar = gtk_info_bar_new ();
gtk_widget_set_no_show_all (info_bar, TRUE);
message_label = gtk_label_new ("");
gtk_widget_show (message_label);
content_area = gtk_info_bar_get_content_area (GTK_INFO_BAR (info_bar));
gtk_container_add (GTK_CONTAINER (content_area), message_label);
gtk_info_bar_add_button (GTK_INFO_BAR (info_bar),
                         GTK_STOCK_OK, GTK_RESPONSE_OK);
g_signal_connect (info_bar, "response",
                  G_CALLBACK (gtk_widget_hide), NULL);
gtk_table_attach (GTK_TABLE (table),
                  info_bar,
                  0, 1, 2, 3,
                  GTK_EXPAND | GTK_FILL,  0,
                  0,                      0);

/&ast; ... &ast;/

/&ast; show an error message &ast;/
gtk_label_set_text (GTK_LABEL (message_label), error_message);
gtk_info_bar_set_message_type (GTK_INFO_BAR (info_bar),
                               GTK_MESSAGE_ERROR);
gtk_widget_show (info_bar);
</programlisting>
</example>
</para>
<para>
<refsect2 id="GtkInfoBar-BUILDER-UI">
<title>GtkInfoBar as GtkBuildable</title>
<para>
The GtkInfoBar implementation of the GtkBuildable interface exposes
the content area and action area as internal children with the names
"content_area" and "action_area".
</para>
<para>
GtkInfoBar supports a custom &lt;action-widgets&gt; element, which
can contain multiple &lt;action-widget&gt; elements. The "response"
attribute specifies a numeric response, and the content of the element
is the id of widget (which should be a child of the dialogs <parameter>action_area</parameter>).
</para>
</refsect2></para>
<para>
</para>
</refsect1>

<refsect1 id="GtkInfoBar.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="GtkInfoBar-struct" role="struct">
<title>GtkInfoBar</title>
<indexterm zone="GtkInfoBar-struct"><primary sortas="InfoBar">GtkInfoBar</primary></indexterm><programlisting>typedef struct _GtkInfoBar GtkInfoBar;</programlisting>
<para>
</para></refsect2>
<refsect2 id="gtk-info-bar-new" role="function" condition="since:2.18">
<title>gtk_info_bar_new ()</title>
<indexterm zone="gtk-info-bar-new" role="2.18"><primary sortas="info_bar_new">gtk_info_bar_new</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_info_bar_new                    (void);</programlisting>
<para>
Creates a new <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link> object.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link> object

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-info-bar-new-with-buttons" role="function">
<title>gtk_info_bar_new_with_buttons ()</title>
<indexterm zone="gtk-info-bar-new-with-buttons"><primary sortas="info_bar_new_with_buttons">gtk_info_bar_new_with_buttons</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_info_bar_new_with_buttons       (const <link linkend="gchar">gchar</link> *first_button_text,
                                                         ...);</programlisting>
<para>
Creates a new <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link> with buttons. Button text/response ID
pairs should be listed, with a <link linkend="NULL--CAPS"><literal>NULL</literal></link> pointer ending the list.
Button text can be either a stock ID such as <link linkend="GTK-STOCK-OK--CAPS"><literal>GTK_STOCK_OK</literal></link>, or
some arbitrary text. A response ID can be any positive number,
or one of the values in the <link linkend="GtkResponseType"><type>GtkResponseType</type></link> enumeration. If the
user clicks one of these dialog buttons, GtkInfoBar will emit
the "response" signal with the corresponding response ID.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>first_button_text</parameter>&#160;:</term>
<listitem><simpara> stock ID or text to go in first button, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara> response ID for first button, then additional buttons, ending
   with <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="gtk-info-bar-add-action-widget" role="function" condition="since:2.18">
<title>gtk_info_bar_add_action_widget ()</title>
<indexterm zone="gtk-info-bar-add-action-widget" role="2.18"><primary sortas="info_bar_add_action_widget">gtk_info_bar_add_action_widget</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_info_bar_add_action_widget      (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         <link linkend="GtkWidget">GtkWidget</link> *child,
                                                         <link linkend="gint">gint</link> response_id);</programlisting>
<para>
Add an activatable widget to the action area of a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>,
connecting a signal handler that will emit the <link linkend="GtkInfoBar-response"><type>"response"</type></link>
signal on the message area when the widget is activated. The widget
is appended to the end of the message areas action area.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>child</parameter>&#160;:</term>
<listitem><simpara> an activatable widget
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>response_id</parameter>&#160;:</term>
<listitem><simpara> response ID for <parameter>child</parameter>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-info-bar-add-button" role="function" condition="since:2.18">
<title>gtk_info_bar_add_button ()</title>
<indexterm zone="gtk-info-bar-add-button" role="2.18"><primary sortas="info_bar_add_button">gtk_info_bar_add_button</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_info_bar_add_button             (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         const <link linkend="gchar">gchar</link> *button_text,
                                                         <link linkend="gint">gint</link> response_id);</programlisting>
<para>
Adds a button with the given text (or a stock button, if button_text
is a stock ID) and sets things up so that clicking the button will emit
the "response" signal with the given response_id. The button is appended
to the end of the info bars's action area. The button widget is
returned, but usually you don't need it.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>button_text</parameter>&#160;:</term>
<listitem><simpara> text of button, or stock ID
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>response_id</parameter>&#160;:</term>
<listitem><simpara> response ID for the button
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the button widget that was added

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-info-bar-add-buttons" role="function" condition="since:2.18">
<title>gtk_info_bar_add_buttons ()</title>
<indexterm zone="gtk-info-bar-add-buttons" role="2.18"><primary sortas="info_bar_add_buttons">gtk_info_bar_add_buttons</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_info_bar_add_buttons            (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         const <link linkend="gchar">gchar</link> *first_button_text,
                                                         ...);</programlisting>
<para>
Adds more buttons, same as calling <link linkend="gtk-info-bar-add-button"><function>gtk_info_bar_add_button()</function></link>
repeatedly. The variable argument list should be <link linkend="NULL--CAPS"><literal>NULL</literal></link>-terminated
as with <link linkend="gtk-info-bar-new-with-buttons"><function>gtk_info_bar_new_with_buttons()</function></link>. Each button must have both
text and response ID.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>first_button_text</parameter>&#160;:</term>
<listitem><simpara> button text or stock ID
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>...</parameter>&#160;:</term>
<listitem><simpara> response ID for first button, then more text-response_id pairs,
    ending with <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-info-bar-set-response-sensitive" role="function" condition="since:2.18">
<title>gtk_info_bar_set_response_sensitive ()</title>
<indexterm zone="gtk-info-bar-set-response-sensitive" role="2.18"><primary sortas="info_bar_set_response_sensitive">gtk_info_bar_set_response_sensitive</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_info_bar_set_response_sensitive (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         <link linkend="gint">gint</link> response_id,
                                                         <link linkend="gboolean">gboolean</link> setting);</programlisting>
<para>
Calls gtk_widget_set_sensitive (widget, setting) for each
widget in the info bars's action area with the given response_id.
A convenient way to sensitize/desensitize dialog buttons.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>response_id</parameter>&#160;:</term>
<listitem><simpara> a response ID
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>setting</parameter>&#160;:</term>
<listitem><simpara> TRUE for sensitive
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-info-bar-set-default-response" role="function" condition="since:2.18">
<title>gtk_info_bar_set_default_response ()</title>
<indexterm zone="gtk-info-bar-set-default-response" role="2.18"><primary sortas="info_bar_set_default_response">gtk_info_bar_set_default_response</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_info_bar_set_default_response   (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         <link linkend="gint">gint</link> response_id);</programlisting>
<para>
Sets the last widget in the info bar's action area with
the given response_id as the default widget for the dialog.
Pressing "Enter" normally activates the default widget.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>response_id</parameter>&#160;:</term>
<listitem><simpara> a response ID
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-info-bar-response" role="function" condition="since:2.18">
<title>gtk_info_bar_response ()</title>
<indexterm zone="gtk-info-bar-response" role="2.18"><primary sortas="info_bar_response">gtk_info_bar_response</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_info_bar_response               (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         <link linkend="gint">gint</link> response_id);</programlisting>
<para>
Emits the 'response' signal with the given <parameter>response_id</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>response_id</parameter>&#160;:</term>
<listitem><simpara> a response ID
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-info-bar-set-message-type" role="function" condition="since:2.18">
<title>gtk_info_bar_set_message_type ()</title>
<indexterm zone="gtk-info-bar-set-message-type" role="2.18"><primary sortas="info_bar_set_message_type">gtk_info_bar_set_message_type</primary></indexterm><programlisting><link linkend="void">void</link>                gtk_info_bar_set_message_type       (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                         <link linkend="GtkMessageType">GtkMessageType</link> message_type);</programlisting>
<para>
Sets the message type of the message area.
GTK+ uses this type to determine what color to use
when drawing the message area.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>message_type</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkMessageType"><type>GtkMessageType</type></link>
</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-info-bar-get-message-type" role="function" condition="since:2.18">
<title>gtk_info_bar_get_message_type ()</title>
<indexterm zone="gtk-info-bar-get-message-type" role="2.18"><primary sortas="info_bar_get_message_type">gtk_info_bar_get_message_type</primary></indexterm><programlisting><link linkend="GtkMessageType">GtkMessageType</link>      gtk_info_bar_get_message_type       (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar);</programlisting>
<para>
Returns the message type of the message area.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the message type of the message area.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-info-bar-get-action-area" role="function" condition="since:2.18">
<title>gtk_info_bar_get_action_area ()</title>
<indexterm zone="gtk-info-bar-get-action-area" role="2.18"><primary sortas="info_bar_get_action_area">gtk_info_bar_get_action_area</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_info_bar_get_action_area        (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar);</programlisting>
<para>
Returns the action area of <parameter>info_bar</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the action area.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>
<refsect2 id="gtk-info-bar-get-content-area" role="function" condition="since:2.18">
<title>gtk_info_bar_get_content_area ()</title>
<indexterm zone="gtk-info-bar-get-content-area" role="2.18"><primary sortas="info_bar_get_content_area">gtk_info_bar_get_content_area</primary></indexterm><programlisting><link linkend="GtkWidget">GtkWidget</link> *         gtk_info_bar_get_content_area       (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar);</programlisting>
<para>
Returns the content area of <parameter>info_bar</parameter>.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GtkInfoBar"><type>GtkInfoBar</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the content area.

</simpara></listitem></varlistentry>
</variablelist><para role="since">Since 2.18</para></refsect2>

</refsect1>
<refsect1 id="GtkInfoBar.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="GtkInfoBar--message-type" role="property"><title>The <literal>&quot;message-type&quot;</literal> property</title>
<indexterm zone="GtkInfoBar--message-type" role="2.18"><primary sortas="InfoBar:message-type">GtkInfoBar:message-type</primary></indexterm><programlisting>  &quot;message-type&quot;             <link linkend="GtkMessageType">GtkMessageType</link>        : Read / Write / Construct</programlisting>
<para>
The type of the message.
</para>
<para>
The type is used to determine the colors to use in the info bar.
The following symbolic color names can by used to customize
these colors:
"info_fg_color", "info_bg_color",
"warning_fg_color", "warning_bg_color",
"question_fg_color", "question_bg_color",
"error_fg_color", "error_bg_color".
"other_fg_color", "other_bg_color".
</para>
<para>
If the type is <link linkend="GTK-MESSAGE-OTHER--CAPS"><type>GTK_MESSAGE_OTHER</type></link>, no info bar is painted but the
colors are still set.</para>
<para>
</para><para>Default value: GTK_MESSAGE_INFO</para>
<para>Since 2.18</para>
</refsect2>
</refsect1>
<refsect1 id="GtkInfoBar.style-property-details" role="style_properties_details">
<title role="style_properties_details.title">Style Property Details</title>
<refsect2 id="GtkInfoBar--s-action-area-border" role="property"><title>The <literal>&quot;action-area-border&quot;</literal> style property</title>
<indexterm zone="GtkInfoBar--s-action-area-border" role="2.18"><primary sortas="InfoBar:action-area-border">GtkInfoBar:action-area-border</primary></indexterm><programlisting>  &quot;action-area-border&quot;       <link linkend="gint">gint</link>                  : Read</programlisting>
<para>
Width of the border around the action area of the info bar.</para>
<para>
</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 5</para>
<para>Since 2.18</para>
</refsect2>
<refsect2 id="GtkInfoBar--s-button-spacing" role="property"><title>The <literal>&quot;button-spacing&quot;</literal> style property</title>
<indexterm zone="GtkInfoBar--s-button-spacing" role="2.18"><primary sortas="InfoBar:button-spacing">GtkInfoBar:button-spacing</primary></indexterm><programlisting>  &quot;button-spacing&quot;           <link linkend="gint">gint</link>                  : Read</programlisting>
<para>
Spacing between buttons in the action area of the info bar.</para>
<para>
</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 6</para>
<para>Since 2.18</para>
</refsect2>
<refsect2 id="GtkInfoBar--s-content-area-border" role="property"><title>The <literal>&quot;content-area-border&quot;</literal> style property</title>
<indexterm zone="GtkInfoBar--s-content-area-border" role="2.18"><primary sortas="InfoBar:content-area-border">GtkInfoBar:content-area-border</primary></indexterm><programlisting>  &quot;content-area-border&quot;      <link linkend="gint">gint</link>                  : Read</programlisting>
<para>
The width of the border around the content
content area of the info bar.</para>
<para>
</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 8</para>
<para>Since 2.18</para>
</refsect2>
<refsect2 id="GtkInfoBar--s-content-area-spacing" role="property"><title>The <literal>&quot;content-area-spacing&quot;</literal> style property</title>
<indexterm zone="GtkInfoBar--s-content-area-spacing" role="2.18"><primary sortas="InfoBar:content-area-spacing">GtkInfoBar:content-area-spacing</primary></indexterm><programlisting>  &quot;content-area-spacing&quot;     <link linkend="gint">gint</link>                  : Read</programlisting>
<para>
The default spacing used between elements of the
content area of the info bar.</para>
<para>
</para><para>Allowed values: &gt;= 0</para>
<para>Default value: 16</para>
<para>Since 2.18</para>
</refsect2>
</refsect1>

<refsect1 id="GtkInfoBar.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="GtkInfoBar-close" role="signal"><title>The <literal>&quot;close&quot;</literal> signal</title>
<indexterm zone="GtkInfoBar-close" role="2.18"><primary sortas="InfoBar::close">GtkInfoBar::close</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkInfoBar">GtkInfoBar</link> *arg0,
                                                        <link linkend="gpointer">gpointer</link>    user_data)      : Run Last / Action</programlisting>
<para>
The ::close signal is a
<link linkend="keybinding-signals">keybinding signal</link>
which gets emitted when the user uses a keybinding to dismiss
the info bar.
</para>
<para>
The default binding for this signal is the Escape key.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist><para>Since 2.18</para></refsect2><refsect2 id="GtkInfoBar-response" role="signal"><title>The <literal>&quot;response&quot;</literal> signal</title>
<indexterm zone="GtkInfoBar-response" role="2.18"><primary sortas="InfoBar::response">GtkInfoBar::response</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GtkInfoBar">GtkInfoBar</link> *info_bar,
                                                        <link linkend="gint">gint</link>        response_id,
                                                        <link linkend="gpointer">gpointer</link>    user_data)        : Run Last</programlisting>
<para>
Emitted when an action widget is clicked or the application programmer
calls <link linkend="gtk-dialog-response"><function>gtk_dialog_response()</function></link>. The <parameter>response_id</parameter> depends on which action
widget was clicked.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>info_bar</parameter>&#160;:</term>
<listitem><simpara> the object on which the signal is emitted
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>response_id</parameter>&#160;:</term>
<listitem><simpara> the response ID
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist><para>Since 2.18</para></refsect2>
</refsect1>


<refsect1 id="GtkInfoBar.see-also">
<title>See Also</title>
#GtkStatusbar, <link linkend="GtkMessageDialog"><type>GtkMessageDialog</type></link>
</refsect1>

</refentry>
