<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <title>gtkmm: Gtk::InfoBar Class Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <link href="doxygen.css" rel="stylesheet" type="text/css"/> </head> <body> <!-- Generated by Doxygen 1.7.3 --> <div id="top"> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">gtkmm <span id="projectnumber">2.24.4</span></div> </td> </tr> </tbody> </table> </div> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li class="current"><a href="annotated.html"><span>Classes</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="annotated.html"><span>Class List</span></a></li> <li><a href="classes.html"><span>Class Index</span></a></li> <li><a href="inherits.html"><span>Class Hierarchy</span></a></li> <li><a href="functions.html"><span>Class Members</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="namespaceGtk.html">Gtk</a> </li> <li class="navelem"><a class="el" href="classGtk_1_1InfoBar.html">InfoBar</a> </li> </ul> </div> </div> <div class="header"> <div class="summary"> <a href="#pub-methods">Public Member Functions</a> | <a href="#pro-methods">Protected Member Functions</a> | <a href="#related">Related Functions</a> </div> <div class="headertitle"> <h1>Gtk::InfoBar Class Reference<div class="ingroups"><a class="el" href="group__Widgets.html">Widgets</a></div></h1> </div> </div> <div class="contents"> <!-- doxytag: class="Gtk::InfoBar" --><!-- doxytag: inherits="Gtk::HBox" --> <p>This widget that can be used to show messages to the user without showing a dialog. <a href="#_details">More...</a></p> <div class="dynheader"> Inheritance diagram for Gtk::InfoBar:</div> <div class="dyncontent"> <div class="center"><img src="classGtk_1_1InfoBar__inherit__graph.png" border="0" usemap="#Gtk_1_1InfoBar_inherit__map" alt="Inheritance graph"/></div> <map name="Gtk_1_1InfoBar_inherit__map" id="Gtk_1_1InfoBar_inherit__map"> <area shape="rect" id="node2" href="classGtk_1_1HBox.html" title="Horizontal Box for laying widgets in a horizontal row." alt="" coords="93,547,179,576"/><area shape="rect" id="node4" href="classGtk_1_1Box.html" title="A base class for box containers." alt="" coords="99,469,173,499"/><area shape="rect" id="node6" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="79,392,193,421"/><area shape="rect" id="node8" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="89,315,183,344"/><area shape="rect" id="node10" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such as Gtk::Adjustme..." alt="" coords="21,237,115,267"/><area shape="rect" id="node12" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="21,160,115,189"/><area shape="rect" id="node14" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,83,131,112"/><area shape="rect" id="node16" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="11,5,125,35"/><area shape="rect" id="node18" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="139,237,272,267"/></map> <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div> <div class="dynheader"> Collaboration diagram for Gtk::InfoBar:</div> <div class="dyncontent"> <div class="center"><img src="classGtk_1_1InfoBar__coll__graph.png" border="0" usemap="#Gtk_1_1InfoBar_coll__map" alt="Collaboration graph"/></div> <map name="Gtk_1_1InfoBar_coll__map" id="Gtk_1_1InfoBar_coll__map"> <area shape="rect" id="node2" href="classGtk_1_1HBox.html" title="Horizontal Box for laying widgets in a horizontal row." alt="" coords="93,547,179,576"/><area shape="rect" id="node4" href="classGtk_1_1Box.html" title="A base class for box containers." alt="" coords="99,469,173,499"/><area shape="rect" id="node6" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="79,392,193,421"/><area shape="rect" id="node8" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="89,315,183,344"/><area shape="rect" id="node10" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such as Gtk::Adjustme..." alt="" coords="21,237,115,267"/><area shape="rect" id="node12" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="21,160,115,189"/><area shape="rect" id="node14" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,83,131,112"/><area shape="rect" id="node16" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="11,5,125,35"/><area shape="rect" id="node18" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="139,237,272,267"/></map> <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div> <p><a href="classGtk_1_1InfoBar-members.html">List of all members.</a></p> <table class="memberdecls"> <tr><td colspan="2"><h2><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a120102bad2c448215cd17ed7bae66fb7">~InfoBar</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top">GtkInfoBar* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a64d9affd6ae0c2db8176799e7f537c73">gobj</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a64d9affd6ae0c2db8176799e7f537c73"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">const GtkInfoBar* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a2eae151f9555eb6dd7b6d2cfe68527bd">gobj</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a2eae151f9555eb6dd7b6d2cfe68527bd"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#ae6d3b9ebcba99c59342d7e503e18bdf3">InfoBar</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Widget.html">Widget</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#afddb70300bb21fd9d985f1014be66a69">get_action_area</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the action area of <em>info_bar</em>. <a href="#afddb70300bb21fd9d985f1014be66a69"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classGtk_1_1Widget.html">Widget</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#adf98101fc79b5d671a0aa26ba63d4a62">get_action_area</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the action area of <em>info_bar</em>. <a href="#adf98101fc79b5d671a0aa26ba63d4a62"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Widget.html">Widget</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#aacd09015a4f4a2f96e4adc42da88c02f">get_content_area</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the content area of <em>info_bar</em>. <a href="#aacd09015a4f4a2f96e4adc42da88c02f"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classGtk_1_1Widget.html">Widget</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a0239b620ff0b78230cbc27667fa8d8be">get_content_area</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the content area of <em>info_bar</em>. <a href="#a0239b620ff0b78230cbc27667fa8d8be"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a91b61b0b09d281e916a144d1967f2118">add_action_widget</a> (<a class="el" href="classGtk_1_1Widget.html">Widget</a>& child, int response_id)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Add an activatable widget to the action area of a <a class="el" href="classGtk_1_1InfoBar.html" title="This widget that can be used to show messages to the user without showing a dialog.">Gtk::InfoBar</a>, connecting a signal handler that will emit the <a class="el" href="classGtk_1_1InfoBar.html#a291d5ee1d3476de76306df6d2c48d78d" title="Emits the 'response' signal with the given response_id.">Gtk::InfoBar::response</a> signal on the message area when the widget is activated. <a href="#a91b61b0b09d281e916a144d1967f2118"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Button.html">Button</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a03b9a985be0b8e56e529c8559ba95c7f">add_button</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& button_text, int response_id)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">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. <a href="#a03b9a985be0b8e56e529c8559ba95c7f"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Button.html">Button</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a9cbc253d36236449628ee3270cb8728c">add_button</a> (const <a class="el" href="classGtk_1_1StockID.html">Gtk::StockID</a>& stock_id, int response_id)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">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. <a href="#a9cbc253d36236449628ee3270cb8728c"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a4268bfa2cc6998a1b103b5ab0eb7cf0a">set_response_sensitive</a> (int response_id, bool setting=true)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Calls gtk_widget_set_sensitive (widget, setting) for each widget in the info bars's action area with the given response_id. <a href="#a4268bfa2cc6998a1b103b5ab0eb7cf0a"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a8f1e615b675b31f01b07172f6ad7dc52">set_default_response</a> (int response_id)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the last widget in the info bar's action area with the given response_id as the default widget for the dialog. <a href="#a8f1e615b675b31f01b07172f6ad7dc52"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a291d5ee1d3476de76306df6d2c48d78d">response</a> (int response_id)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Emits the 'response' signal with the given <em>response_id</em>. <a href="#a291d5ee1d3476de76306df6d2c48d78d"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a118aee05364b0c0f4ee50f5fd8f9d304">set_message_type</a> (<a class="el" href="group__gtkmmEnums.html#ga8698319d7eb64b1f297b04e4e5c7809b">MessageType</a> message_type)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the message type of the message area. <a href="#a118aee05364b0c0f4ee50f5fd8f9d304"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__gtkmmEnums.html#ga8698319d7eb64b1f297b04e4e5c7809b">MessageType</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#ad4983833fe92d98fa9eac7438ea48661">get_message_type</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the message type of the message area. <a href="#ad4983833fe92d98fa9eac7438ea48661"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void, int > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a63ad844b70c72d4feb1e696a23e500a2">signal_response</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< <a class="el" href="group__gtkmmEnums.html#ga8698319d7eb64b1f297b04e4e5c7809b">MessageType</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#ab7e0bf11104cde54f6e7215633e448d9">property_message_type</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">The type of message. <a href="#ab7e0bf11104cde54f6e7215633e448d9"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/> < <a class="el" href="group__gtkmmEnums.html#ga8698319d7eb64b1f297b04e4e5c7809b">MessageType</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a8163189c88385da33410a03d86d9874f">property_message_type</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">The type of message. <a href="#a8163189c88385da33410a03d86d9874f"></a><br/></td></tr> <tr><td colspan="2"><h2><a name="pro-methods"></a> Protected Member Functions</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#aec677447b9fce30e6f154d631770b016">on_response</a> (int response_id)</td></tr> <tr><td colspan="2"><h2><a name="related"></a> Related Functions</h2></td></tr> <tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1InfoBar.html">Gtk::InfoBar</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1InfoBar.html#a4a1c7856c1c8b30910df3495787c5876">wrap</a> (GtkInfoBar* object, bool take_copy=false)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a4a1c7856c1c8b30910df3495787c5876"></a><br/></td></tr> </table> <hr/><a name="_details"></a><h2>Detailed Description</h2> <div class="textblock"><p>This widget that can be used to show messages to the user without showing a dialog. </p> <p>It is often temporarily shown at the top or bottom of a document. In contrast to <a class="el" href="classGtk_1_1Dialog.html" title="Create popup windows.">Dialog</a>, which has a horizontal action area at the bottom, <a class="el" href="classGtk_1_1InfoBar.html" title="This widget that can be used to show messages to the user without showing a dialog.">InfoBar</a> has a vertical action area at the side.</p> <p>The API is very similar to <a class="el" href="classGtk_1_1Dialog.html" title="Create popup windows.">Dialog</a>, allowing you to add buttons to the action area with <a class="el" href="classGtk_1_1InfoBar.html#a03b9a985be0b8e56e529c8559ba95c7f" title="Adds a button with the given text (or a stock button, if button_text is a stock ID) and sets things u...">add_button()</a>. The sensitivity of action widgets can be controlled with <a class="el" href="classGtk_1_1InfoBar.html#a4268bfa2cc6998a1b103b5ab0eb7cf0a" title="Calls gtk_widget_set_sensitive (widget, setting) for each widget in the info bars's action area w...">set_response_sensitive()</a>. To add widgets to the main content area, use <a class="el" href="classGtk_1_1InfoBar.html#aacd09015a4f4a2f96e4adc42da88c02f" title="Returns the content area of info_bar.">get_content_area()</a> and add your widgets to the container.</p> <p>Similar to <a class="el" href="classGtk_1_1MessageDialog.html" title="Convenient message window.">MessageDialog</a>, the contents can by classified as error message, warning, informational message, etc, by using <a class="el" href="classGtk_1_1InfoBar.html#a118aee05364b0c0f4ee50f5fd8f9d304" title="Sets the message type of the message area.">set_message_type()</a>. This determines the background color of the message area.</p> <p>The <a class="el" href="classGtk_1_1InfoBar.html" title="This widget that can be used to show messages to the user without showing a dialog.">InfoBar</a> widget looks like </p> <div align="center"> <img src="infobar1.png" alt="infobar1.png"/> </div> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000034">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> </div><hr/><h2>Constructor & Destructor Documentation</h2> <a class="anchor" id="a120102bad2c448215cd17ed7bae66fb7"></a><!-- doxytag: member="Gtk::InfoBar::~InfoBar" ref="a120102bad2c448215cd17ed7bae66fb7" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">virtual Gtk::InfoBar::~InfoBar </td> <td>(</td> <td class="paramname"></td><td>)</td> <td><code> [virtual]</code></td> </tr> </table> </div> <div class="memdoc"> </div> </div> <a class="anchor" id="ae6d3b9ebcba99c59342d7e503e18bdf3"></a><!-- doxytag: member="Gtk::InfoBar::InfoBar" ref="ae6d3b9ebcba99c59342d7e503e18bdf3" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">Gtk::InfoBar::InfoBar </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> </div> </div> <hr/><h2>Member Function Documentation</h2> <a class="anchor" id="a91b61b0b09d281e916a144d1967f2118"></a><!-- doxytag: member="Gtk::InfoBar::add_action_widget" ref="a91b61b0b09d281e916a144d1967f2118" args="(Widget &child, int response_id)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::InfoBar::add_action_widget </td> <td>(</td> <td class="paramtype"><a class="el" href="classGtk_1_1Widget.html">Widget</a>& </td> <td class="paramname"><em>child</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>response_id</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div> <div class="memdoc"> <p>Add an activatable widget to the action area of a <a class="el" href="classGtk_1_1InfoBar.html" title="This widget that can be used to show messages to the user without showing a dialog.">Gtk::InfoBar</a>, connecting a signal handler that will emit the <a class="el" href="classGtk_1_1InfoBar.html#a291d5ee1d3476de76306df6d2c48d78d" title="Emits the 'response' signal with the given response_id.">Gtk::InfoBar::response</a> signal on the message area when the widget is activated. </p> <p>The widget is appended to the end of the message areas action area.</p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000039">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">child</td><td>An activatable widget. </td></tr> <tr><td class="paramname">response_id</td><td>Response ID for <em>child</em>. </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a03b9a985be0b8e56e529c8559ba95c7f"></a><!-- doxytag: member="Gtk::InfoBar::add_button" ref="a03b9a985be0b8e56e529c8559ba95c7f" args="(const Glib::ustring &button_text, int response_id)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classGtk_1_1Button.html">Button</a>* Gtk::InfoBar::add_button </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"><em>button_text</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>response_id</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div> <div class="memdoc"> <p>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. </p> <p>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.</p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000040">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">button_text</td><td>Text of button, or stock ID. </td></tr> <tr><td class="paramname">response_id</td><td>Response ID for the button. </td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>The button widget that was added. </dd></dl> </div> </div> <a class="anchor" id="a9cbc253d36236449628ee3270cb8728c"></a><!-- doxytag: member="Gtk::InfoBar::add_button" ref="a9cbc253d36236449628ee3270cb8728c" args="(const Gtk::StockID &stock_id, int response_id)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classGtk_1_1Button.html">Button</a>* Gtk::InfoBar::add_button </td> <td>(</td> <td class="paramtype">const <a class="el" href="classGtk_1_1StockID.html">Gtk::StockID</a>& </td> <td class="paramname"><em>stock_id</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>response_id</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div> <div class="memdoc"> <p>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. </p> <p>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.</p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000041">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">button_text</td><td>Text of button, or stock ID. </td></tr> <tr><td class="paramname">response_id</td><td>Response ID for the button. </td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>The button widget that was added. </dd></dl> </div> </div> <a class="anchor" id="afddb70300bb21fd9d985f1014be66a69"></a><!-- doxytag: member="Gtk::InfoBar::get_action_area" ref="afddb70300bb21fd9d985f1014be66a69" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classGtk_1_1Widget.html">Widget</a>* Gtk::InfoBar::get_action_area </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Returns the action area of <em>info_bar</em>. </p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000035">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl class="return"><dt><b>Returns:</b></dt><dd>The action area. </dd></dl> </div> </div> <a class="anchor" id="adf98101fc79b5d671a0aa26ba63d4a62"></a><!-- doxytag: member="Gtk::InfoBar::get_action_area" ref="adf98101fc79b5d671a0aa26ba63d4a62" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const <a class="el" href="classGtk_1_1Widget.html">Widget</a>* Gtk::InfoBar::get_action_area </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Returns the action area of <em>info_bar</em>. </p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000036">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl class="return"><dt><b>Returns:</b></dt><dd>The action area. </dd></dl> </div> </div> <a class="anchor" id="aacd09015a4f4a2f96e4adc42da88c02f"></a><!-- doxytag: member="Gtk::InfoBar::get_content_area" ref="aacd09015a4f4a2f96e4adc42da88c02f" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classGtk_1_1Widget.html">Widget</a>* Gtk::InfoBar::get_content_area </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Returns the content area of <em>info_bar</em>. </p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000037">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl class="return"><dt><b>Returns:</b></dt><dd>The content area. </dd></dl> </div> </div> <a class="anchor" id="a0239b620ff0b78230cbc27667fa8d8be"></a><!-- doxytag: member="Gtk::InfoBar::get_content_area" ref="a0239b620ff0b78230cbc27667fa8d8be" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const <a class="el" href="classGtk_1_1Widget.html">Widget</a>* Gtk::InfoBar::get_content_area </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Returns the content area of <em>info_bar</em>. </p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000038">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl class="return"><dt><b>Returns:</b></dt><dd>The content area. </dd></dl> </div> </div> <a class="anchor" id="ad4983833fe92d98fa9eac7438ea48661"></a><!-- doxytag: member="Gtk::InfoBar::get_message_type" ref="ad4983833fe92d98fa9eac7438ea48661" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="group__gtkmmEnums.html#ga8698319d7eb64b1f297b04e4e5c7809b">MessageType</a> Gtk::InfoBar::get_message_type </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Returns the message type of the message area. </p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000046">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl class="return"><dt><b>Returns:</b></dt><dd>The message type of the message area. </dd></dl> </div> </div> <a class="anchor" id="a2eae151f9555eb6dd7b6d2cfe68527bd"></a><!-- doxytag: member="Gtk::InfoBar::gobj" ref="a2eae151f9555eb6dd7b6d2cfe68527bd" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const GtkInfoBar* Gtk::InfoBar::gobj </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const<code> [inline]</code></td> </tr> </table> </div> <div class="memdoc"> <p>Provides access to the underlying C GtkObject. </p> <p>Reimplemented from <a class="el" href="classGtk_1_1HBox.html#a200e7083acf10d6075633a5bb2eef9d0">Gtk::HBox</a>.</p> </div> </div> <a class="anchor" id="a64d9affd6ae0c2db8176799e7f537c73"></a><!-- doxytag: member="Gtk::InfoBar::gobj" ref="a64d9affd6ae0c2db8176799e7f537c73" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">GtkInfoBar* Gtk::InfoBar::gobj </td> <td>(</td> <td class="paramname"></td><td>)</td> <td><code> [inline]</code></td> </tr> </table> </div> <div class="memdoc"> <p>Provides access to the underlying C GtkObject. </p> <p>Reimplemented from <a class="el" href="classGtk_1_1HBox.html#a276c36213ef878a34ab3a16a6f2dc94b">Gtk::HBox</a>.</p> </div> </div> <a class="anchor" id="aec677447b9fce30e6f154d631770b016"></a><!-- doxytag: member="Gtk::InfoBar::on_response" ref="aec677447b9fce30e6f154d631770b016" args="(int response_id)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">virtual void Gtk::InfoBar::on_response </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>response_id</em></td><td>)</td> <td><code> [protected, virtual]</code></td> </tr> </table> </div> <div class="memdoc"> </div> </div> <a class="anchor" id="ab7e0bf11104cde54f6e7215633e448d9"></a><!-- doxytag: member="Gtk::InfoBar::property_message_type" ref="ab7e0bf11104cde54f6e7215633e448d9" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><<a class="el" href="group__gtkmmEnums.html#ga8698319d7eb64b1f297b04e4e5c7809b">MessageType</a>> Gtk::InfoBar::property_message_type </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>The type of message. </p> <p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p> <dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl> </div> </div> <a class="anchor" id="a8163189c88385da33410a03d86d9874f"></a><!-- doxytag: member="Gtk::InfoBar::property_message_type" ref="a8163189c88385da33410a03d86d9874f" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<a class="el" href="group__gtkmmEnums.html#ga8698319d7eb64b1f297b04e4e5c7809b">MessageType</a>> Gtk::InfoBar::property_message_type </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>The type of message. </p> <p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p> <dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl> </div> </div> <a class="anchor" id="a291d5ee1d3476de76306df6d2c48d78d"></a><!-- doxytag: member="Gtk::InfoBar::response" ref="a291d5ee1d3476de76306df6d2c48d78d" args="(int response_id)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::InfoBar::response </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>response_id</em></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Emits the 'response' signal with the given <em>response_id</em>. </p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000044">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">response_id</td><td>A response ID. </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a8f1e615b675b31f01b07172f6ad7dc52"></a><!-- doxytag: member="Gtk::InfoBar::set_default_response" ref="a8f1e615b675b31f01b07172f6ad7dc52" args="(int response_id)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::InfoBar::set_default_response </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>response_id</em></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Sets the last widget in the info bar's action area with the given response_id as the default widget for the dialog. </p> <p>Pressing "Enter" normally activates the default widget.</p> <p>Note that this function currently requires <em>info_bar</em> to be added to a widget hierarchy.</p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000043">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">response_id</td><td>A response ID. </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a118aee05364b0c0f4ee50f5fd8f9d304"></a><!-- doxytag: member="Gtk::InfoBar::set_message_type" ref="a118aee05364b0c0f4ee50f5fd8f9d304" args="(MessageType message_type)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::InfoBar::set_message_type </td> <td>(</td> <td class="paramtype"><a class="el" href="group__gtkmmEnums.html#ga8698319d7eb64b1f297b04e4e5c7809b">MessageType</a> </td> <td class="paramname"><em>message_type</em></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Sets the message type of the message area. </p> <p>GTK+ uses this type to determine what color to use when drawing the message area.</p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000045">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">message_type</td><td>A Gtk::MessageType. </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a4268bfa2cc6998a1b103b5ab0eb7cf0a"></a><!-- doxytag: member="Gtk::InfoBar::set_response_sensitive" ref="a4268bfa2cc6998a1b103b5ab0eb7cf0a" args="(int response_id, bool setting=true)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::InfoBar::set_response_sensitive </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>response_id</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>setting</em> = <code>true</code> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div> <div class="memdoc"> <p>Calls gtk_widget_set_sensitive (widget, setting) for each widget in the info bars's action area with the given response_id. </p> <p>A convenient way to sensitize/desensitize dialog buttons.</p> <dl class="since_2_18"><dt><b><a class="el" href="since_2_18.html#_since_2_18000042">Since gtkmm 2.18:</a></b></dt><dd></dd></dl> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">response_id</td><td>A response ID. </td></tr> <tr><td class="paramname">setting</td><td><code>true</code> for sensitive. </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a63ad844b70c72d4feb1e696a23e500a2"></a><!-- doxytag: member="Gtk::InfoBar::signal_response" ref="a63ad844b70c72d4feb1e696a23e500a2" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void,int > Gtk::InfoBar::signal_response </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_response(int response_id)</code> </dd></dl> </div> </div> <hr/><h2>Friends And Related Function Documentation</h2> <a class="anchor" id="a4a1c7856c1c8b30910df3495787c5876"></a><!-- doxytag: member="Gtk::InfoBar::wrap" ref="a4a1c7856c1c8b30910df3495787c5876" args="(GtkInfoBar *object, bool take_copy=false)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classGtk_1_1InfoBar.html">Gtk::InfoBar</a>* wrap </td> <td>(</td> <td class="paramtype">GtkInfoBar * </td> <td class="paramname"><em>object</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>take_copy</em> = <code>false</code> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td><code> [related]</code></td> </tr> </table> </div> <div class="memdoc"> <p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">object</td><td>The C instance. </td></tr> <tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl> </div> </div> <hr/>The documentation for this class was generated from the following file:<ul> <li>gtkmm/infobar.h</li> </ul> </div> <hr class="footer"/><address class="footer"><small>Generated on Tue Jun 25 2013 for gtkmm by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address> </body> </html>