<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>gtkmm 2.4: Gtk::Dialog Class Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
</head>
<body bgcolor="#ffffff">
<table border="0" width="100%">
<tr>
<td width="10%" height="40"><img src="../../images/gtkmm_logo.gif" alt="logo" border="0" width="100%" height="100%"/></td>
<td width="90%" height="40"><img src="../../images/top.gif" alt="top" width="100%" height="40"/></td>
</tr>
</table>
<center>
<a class="qindex" href="../../index.html">Main Page</a>
<a href="group__Widgets.html">Widgets</a>
<a class="qindex" href="namespaces.html"> Namespaces</a>
<a href="../../tutorial/html/index.html"> Book</a>
</center>
<hr width="100%"/>
<!-- begin main content -->
<div id="content">
<!-- Generated by Doxygen 1.5.1 -->
<div class="nav">
<a class="el" href="namespaceGtk.html">Gtk</a>::<a class="el" href="classGtk_1_1Dialog.html">Dialog</a></div>
<h1>Gtk::Dialog Class Reference<br>
<small>
[<a class="el" href="group__Dialogs.html">Dialogs</a>]</small>
</h1><!-- doxytag: class="Gtk::Dialog" --><!-- doxytag: inherits="Gtk::Window" -->Inheritance diagram for Gtk::Dialog:<p><center><img src="classGtk_1_1Dialog__inherit__graph.png" border="0" usemap="#Gtk_1_1Dialog__inherit__map" alt="Inheritance graph"></center>
<map name="Gtk_1_1Dialog__inherit__map">
<area href="classGtk_1_1AboutDialog.html" shape="rect" coords="324,5,452,32" alt="">
<area href="classGtk_1_1ColorSelectionDialog.html" shape="rect" coords="296,56,480,82" alt="">
<area href="classGtk_1_1FileChooserDialog.html" shape="rect" coords="305,106,471,133" alt="">
<area href="classGtk_1_1FileSelection.html" shape="rect" coords="323,157,453,184" alt="">
<area href="classGtk_1_1FontSelectionDialog.html" shape="rect" coords="299,208,477,234" alt="">
<area href="classGtk_1_1InputDialog.html" shape="rect" coords="327,258,449,285" alt="">
<area href="classGtk_1_1MessageDialog.html" shape="rect" coords="315,309,461,336" alt="">
<area href="classGtk_1_1PageSetupUnixDialog.html" shape="rect" coords="293,360,483,386" alt="">
<area href="classGtk_1_1PrintUnixDialog.html" shape="rect" coords="315,410,461,437" alt="">
<area href="classGtk_1_1RecentChooserDialog.html" shape="rect" coords="295,461,481,488" alt="">
<area href="classGtk_1_1Window.html" shape="rect" coords="5,233,104,260" alt="">
</map>
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center><a href="classGtk_1_1Dialog-members.html">List of all members.</a><hr><a name="_details"></a><h2>Detailed Description</h2>
Create popup windows.
<p>
<a class="el" href="classGtk_1_1Dialog.html">Dialog</a> boxes are a convenient way to prompt the user for a small amount of input, eg. to display a message, ask a question, or anything else that does not require extensive effort on the user's part.<p>
gtkmm treats a dialog as a window split vertically. The top section is a <a class="el" href="classGtk_1_1VBox.html">Gtk::VBox</a>, and is where widgets such as a <a class="el" href="classGtk_1_1Label.html">Gtk::Label</a> or a <a class="el" href="classGtk_1_1Entry.html">Gtk::Entry</a> should be packed. The bottom area is known as the action_area. This is generally used for packing buttons into the dialog which may perform functions such as cancel, ok, or apply. The two areas are separated by a <a class="el" href="classGtk_1_1HSeparator.html">Gtk::HSeparator</a>.<p>
The dialog can be 'modal' (that is, one which freezes the rest of the application from user input) - this can be specified in the <a class="el" href="classGtk_1_1Dialog.html">Gtk::Dialog</a> constructor.<p>
When adding buttons using <a class="el" href="classGtk_1_1Dialog.html#ca037e133ab2a91c646f23b7b17afb9b">add_button()</a>, clicking the button will emit <a class="el" href="classGtk_1_1Dialog.html#813b36a938805498073e887b29126359">signal_response()</a> with a "response id" you specified. You are encouraged to use the <a class="el" href="group__gtkmmEnums.html#g407d25a7b827dbdb685077de442e9b38">Gtk::ResponseType</a> enum. If a dialog receives a delete event, the "response" signal will be emitted with a response id of <a class="el" href="group__gtkmmEnums.html#gg407d25a7b827dbdb685077de442e9b385dfe7c858a12744d418471de12a8b6a8">Gtk::RESPONSE_NONE</a>.<p>
If you want to block waiting for a dialog to return before returning control flow to your code, you can call <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6">run()</a>. This function enters a recursive main loop and waits for the user to respond to the dialog, returning the response ID corresponding to the button the user clicked.
<p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#096c1736344266e316dd31bbd5c43e19">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">Adds an activatable widget to the action area of a <a class="el" href="classGtk_1_1Dialog.html">Gtk::Dialog</a>, connecting a signal handler that will emit the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">Gtk::Dialog::response</a> signal on the dialog when the widget is activated. <a href="#096c1736344266e316dd31bbd5c43e19"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap 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_1Dialog.html#c2a99c5d26c1022c2d259448f5f179a7">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 <em>button_text</em> is a stock ID) and sets things up so that clicking the button will emit the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">Gtk::Dialog::response</a> signal with the given <em>response_id</em> . <a href="#c2a99c5d26c1022c2d259448f5f179a7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap 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_1Dialog.html#ca037e133ab2a91c646f23b7b17afb9b">add_button</a> (const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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 <em>button_text</em> is a stock ID) and sets things up so that clicking the button will emit the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">Gtk::Dialog::response</a> signal with the given <em>response_id</em> . <a href="#ca037e133ab2a91c646f23b7b17afb9b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#74ae53f24af2a2449c5add35fb6dc40b">Dialog</a> (const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& title, <a class="el" href="classGtk_1_1Window.html">Gtk::Window</a>& parent, bool modal=false, bool use_separator=false)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#36b72560ec3c1cd2f3ecce7eae0439d6">Dialog</a> (const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& title, bool modal=false, bool use_separator=false)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#7e746e77abaa67ccdc920ca97ad9b06e">Dialog</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classGtk_1_1HButtonBox.html">HButtonBox</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#4ccc20f12cd5448d3dff207de11366d8">get_action_area</a> () const</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1HButtonBox.html">HButtonBox</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#83564d23506990686d996abc8b5350d9">get_action_area</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#9c5979cf329841b184ee726d79f9044d">get_has_separator</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Accessor for whether the dialog has a separator. <a href="#9c5979cf329841b184ee726d79f9044d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#504f6dc09ef1933c06ce04ddd492d9ee">get_response_for_widget</a> (const <a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>& widget) const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the response id of a widget in the action area of a dialog. <a href="#504f6dc09ef1933c06ce04ddd492d9ee"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classGtk_1_1VBox.html">VBox</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#70af2da5538e8472ef570fa761e3acd5">get_vbox</a> () const</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1VBox.html">VBox</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#b667999656d5cdf5729d57d6eea879ce">get_vbox</a> ()</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const GtkDialog* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#788feeedb8034b6582a914bfe81deb6d">gobj</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#788feeedb8034b6582a914bfe81deb6d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">GtkDialog* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a3e8f3bdac15fac61128dc47c22ba4cd">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a3e8f3bdac15fac61128dc47c22ba4cd"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><<br>
bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ecc98b69a0ff63b428cc57e026643492">property_has_separator</a> () const</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The dialog has a separator bar above its buttons. <a href="#ecc98b69a0ff63b428cc57e026643492"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#9213b6718a78d180c7f1c77cd30b1b26">property_has_separator</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">The dialog has a separator bar above its buttons. <a href="#9213b6718a78d180c7f1c77cd30b1b26"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">response</a> (int response_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Emits the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">Gtk::Dialog::response</a> signal with the given response ID. <a href="#7cf451db55cadc3509f360f70d0e0ecb"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6">run</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Blocks in a recursive main loop until the <em>dialog</em> emits the response signal. <a href="#dc98a1e747613c9b6cb66c238f6f8da6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ae3b78426fbdd620c5a46166ba664146">set_alternative_button_order_from_array</a> (const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a><int>& new_order)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets an alternative button order. <a href="#ae3b78426fbdd620c5a46166ba664146"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#9a042edc1a83ae5d670305635d193fea">set_default_response</a> (int response_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the last widget in the dialog's action area with the given <em>response_id</em> as the default widget for the dialog. <a href="#9a042edc1a83ae5d670305635d193fea"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#c39df2f1035a441047d48c94d72315c6">set_has_separator</a> (bool setting=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets whether the dialog has a separator above the buttons. <a href="#c39df2f1035a441047d48c94d72315c6"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#04da02d509bf9c759a15cdb1dc544a5d">set_response_sensitive</a> (int response_id, bool setting=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Calls <code>gtk_widget_set_sensitive (widget, <em>setting</em> )</code> for each widget in the dialog's action area with the given <em>response_id</em> . <a href="#04da02d509bf9c759a15cdb1dc544a5d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void,<br>
int > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#813b36a938805498073e887b29126359">signal_response</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight"><dl class="user" compact><dt><b>Prototype:</b></dt><dd><code>void on_my_response(int response_id)</code> </dd></dl>
<a href="#813b36a938805498073e887b29126359"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#20ecf1401f15179073406bda2b766946">~Dialog</a> ()</td></tr>
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#da94684e77582514fcf9062585c64824">alternative_button_order</a> (const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classGdk_1_1Screen.html">Gdk::Screen</a>>& screen)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns: Whether the alternative button order should be used. <a href="#da94684e77582514fcf9062585c64824"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#e329b0fb53552267a5846e428fa1c84f">construct_</a> (bool modal, bool use_separator)</td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#9d3aab6c3ea727acab2af375e9ad3479">on_response</a> (int response_id)</td></tr>
<tr><td colspan="2"><br><h2>Related Functions</h2></td></tr>
<tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1Dialog.html">Gtk::Dialog</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#1f0f3f2840498099a768a81eafdca8f7">wrap</a> (GtkDialog* object, bool take_copy=false)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#1f0f3f2840498099a768a81eafdca8f7"></a><br></td></tr>
</table>
<hr><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" name="20ecf1401f15179073406bda2b766946"></a><!-- doxytag: member="Gtk::Dialog::~Dialog" ref="20ecf1401f15179073406bda2b766946" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual Gtk::Dialog::~Dialog </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="7e746e77abaa67ccdc920ca97ad9b06e"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="7e746e77abaa67ccdc920ca97ad9b06e" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Dialog::Dialog </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="36b72560ec3c1cd2f3ecce7eae0439d6"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="36b72560ec3c1cd2f3ecce7eae0439d6" args="(const Glib::ustring &title, bool modal=false, bool use_separator=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Dialog::Dialog </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"> <em>title</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>modal</em> = <code>false</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>use_separator</em> = <code>false</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="74ae53f24af2a2449c5add35fb6dc40b"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="74ae53f24af2a2449c5add35fb6dc40b" args="(const Glib::ustring &title, Gtk::Window &parent, bool modal=false, bool use_separator=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Gtk::Dialog::Dialog </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
<td class="paramname"> <em>title</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classGtk_1_1Window.html">Gtk::Window</a>& </td>
<td class="paramname"> <em>parent</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>modal</em> = <code>false</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>use_separator</em> = <code>false</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<hr><h2>Member Function Documentation</h2>
<a class="anchor" name="096c1736344266e316dd31bbd5c43e19"></a><!-- doxytag: member="Gtk::Dialog::add_action_widget" ref="096c1736344266e316dd31bbd5c43e19" args="(Widget &child, int response_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Dialog::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><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Adds an activatable widget to the action area of a <a class="el" href="classGtk_1_1Dialog.html">Gtk::Dialog</a>, connecting a signal handler that will emit the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">Gtk::Dialog::response</a> signal on the dialog when the widget is activated.
<p>
The widget is appended to the end of the dialog's action area. If you want to add a non-activatable widget, simply pack it into the <em>action_area</em> field of the <a class="el" href="classGtk_1_1Dialog.html">Gtk::Dialog</a> struct. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>child</em> </td><td>An activatable widget. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>response_id</em> </td><td>Response ID for <em>child</em> . </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="c2a99c5d26c1022c2d259448f5f179a7"></a><!-- doxytag: member="Gtk::Dialog::add_button" ref="c2a99c5d26c1022c2d259448f5f179a7" 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::Dialog::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><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Adds a button with the given text (or a stock button, if <em>button_text</em> is a stock ID) and sets things up so that clicking the button will emit the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">Gtk::Dialog::response</a> signal with the given <em>response_id</em> .
<p>
The button is appended to the end of the dialog's action area. The button widget is returned, but usually you don't need it. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>button_text</em> </td><td>Text of button, or stock ID. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>response_id</em> </td><td>Response ID for the button. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The button widget that was added. </dd></dl>
</div>
</div><p>
<a class="anchor" name="ca037e133ab2a91c646f23b7b17afb9b"></a><!-- doxytag: member="Gtk::Dialog::add_button" ref="ca037e133ab2a91c646f23b7b17afb9b" 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::Dialog::add_button </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/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><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Adds a button with the given text (or a stock button, if <em>button_text</em> is a stock ID) and sets things up so that clicking the button will emit the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">Gtk::Dialog::response</a> signal with the given <em>response_id</em> .
<p>
The button is appended to the end of the dialog's action area. The button widget is returned, but usually you don't need it. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>button_text</em> </td><td>Text of button, or stock ID. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>response_id</em> </td><td>Response ID for the button. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The button widget that was added. </dd></dl>
</div>
</div><p>
<a class="anchor" name="da94684e77582514fcf9062585c64824"></a><!-- doxytag: member="Gtk::Dialog::alternative_button_order" ref="da94684e77582514fcf9062585c64824" args="(const Glib::RefPtr< const Gdk::Screen > &screen)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool Gtk::Dialog::alternative_button_order </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classGdk_1_1Screen.html">Gdk::Screen</a>>& </td>
<td class="paramname"> <em>screen</em> </td>
<td> ) </td>
<td width="100%"><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns: Whether the alternative button order should be used.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>screen</em> </td><td>A <a class="el" href="classGdk_1_1Screen.html">Gdk::Screen</a>, or <code>0</code> to use the default screen. </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Whether the alternative button order should be used</dd></dl>
<dl compact><dt><b><a class="el" href="newin2p6s.html#_newin2p6s000070">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
</div>
</div><p>
<a class="anchor" name="e329b0fb53552267a5846e428fa1c84f"></a><!-- doxytag: member="Gtk::Dialog::construct_" ref="e329b0fb53552267a5846e428fa1c84f" args="(bool modal, bool use_separator)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Dialog::construct_ </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>modal</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>use_separator</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="4ccc20f12cd5448d3dff207de11366d8"></a><!-- doxytag: member="Gtk::Dialog::get_action_area" ref="4ccc20f12cd5448d3dff207de11366d8" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classGtk_1_1HButtonBox.html">HButtonBox</a>* Gtk::Dialog::get_action_area </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<p>
Reimplemented in <a class="el" href="classGtk_1_1FileSelection.html#a3fb6845157ff84ce7bfaf5e74c670a7">Gtk::FileSelection</a>.
</div>
</div><p>
<a class="anchor" name="83564d23506990686d996abc8b5350d9"></a><!-- doxytag: member="Gtk::Dialog::get_action_area" ref="83564d23506990686d996abc8b5350d9" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGtk_1_1HButtonBox.html">HButtonBox</a>* Gtk::Dialog::get_action_area </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<p>
Reimplemented in <a class="el" href="classGtk_1_1FileSelection.html#3eb51f01b118c49574a7915c3fbeca47">Gtk::FileSelection</a>.
</div>
</div><p>
<a class="anchor" name="9c5979cf329841b184ee726d79f9044d"></a><!-- doxytag: member="Gtk::Dialog::get_has_separator" ref="9c5979cf329841b184ee726d79f9044d" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool Gtk::Dialog::get_has_separator </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Accessor for whether the dialog has a separator.
<p>
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the dialog has a separator. </dd></dl>
</div>
</div><p>
<a class="anchor" name="504f6dc09ef1933c06ce04ddd492d9ee"></a><!-- doxytag: member="Gtk::Dialog::get_response_for_widget" ref="504f6dc09ef1933c06ce04ddd492d9ee" args="(const Gtk::Widget &widget) const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Gtk::Dialog::get_response_for_widget </td>
<td>(</td>
<td class="paramtype">const <a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>& </td>
<td class="paramname"> <em>widget</em> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Gets the response id of a widget in the action area of a dialog.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>widget</em> </td><td>A widget in the action area of <em>dialog</em> . </td></tr>
</table>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The response id of <em>widget</em> , or <a class="el" href="group__gtkmmEnums.html#gg407d25a7b827dbdb685077de442e9b385dfe7c858a12744d418471de12a8b6a8">Gtk::RESPONSE_NONE</a> if <em>widget</em> doesn't have a response id set.</dd></dl>
<dl compact><dt><b><a class="el" href="newin2p8s.html#_newin2p8s000012">Since gtkmm 2.8:</a></b></dt><dd></dd></dl>
</div>
</div><p>
<a class="anchor" name="70af2da5538e8472ef570fa761e3acd5"></a><!-- doxytag: member="Gtk::Dialog::get_vbox" ref="70af2da5538e8472ef570fa761e3acd5" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classGtk_1_1VBox.html">VBox</a>* Gtk::Dialog::get_vbox </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="b667999656d5cdf5729d57d6eea879ce"></a><!-- doxytag: member="Gtk::Dialog::get_vbox" ref="b667999656d5cdf5729d57d6eea879ce" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGtk_1_1VBox.html">VBox</a>* Gtk::Dialog::get_vbox </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="788feeedb8034b6582a914bfe81deb6d"></a><!-- doxytag: member="Gtk::Dialog::gobj" ref="788feeedb8034b6582a914bfe81deb6d" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const GtkDialog* Gtk::Dialog::gobj </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> 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_1Window.html#c3e302dafa3d1474738f55df906fe100">Gtk::Window</a>.
<p>
Reimplemented in <a class="el" href="classGtk_1_1AboutDialog.html#284788ef0e053eff6cb642a25738bd39">Gtk::AboutDialog</a>, <a class="el" href="classGtk_1_1ColorSelectionDialog.html#9cd10342991a6103d193b7e2c7679beb">Gtk::ColorSelectionDialog</a>, <a class="el" href="classGtk_1_1FileChooserDialog.html#623ab24c2cce13f1ea21776621b1c073">Gtk::FileChooserDialog</a>, <a class="el" href="classGtk_1_1FileSelection.html#7a1f2b2bbc9eb92013302a92e3b6fe6d">Gtk::FileSelection</a>, <a class="el" href="classGtk_1_1FontSelectionDialog.html#4e252f515c010c4e26eacd966199b20f">Gtk::FontSelectionDialog</a>, <a class="el" href="classGtk_1_1InputDialog.html#dc7112c4f7d635da4e0192e6b0405721">Gtk::InputDialog</a>, <a class="el" href="classGtk_1_1MessageDialog.html#f5ffd5b91e470911e1259c31021ffd1d">Gtk::MessageDialog</a>, <a class="el" href="classGtk_1_1PageSetupUnixDialog.html#c5e1e4a42b7deec06f9b3579affb2a24">Gtk::PageSetupUnixDialog</a>, <a class="el" href="classGtk_1_1PrintUnixDialog.html#55d69c442642a62635687146d861bb49">Gtk::PrintUnixDialog</a>, and <a class="el" href="classGtk_1_1RecentChooserDialog.html#b0a84cf3ef674f1bf1572aa0ab03828d">Gtk::RecentChooserDialog</a>.
</div>
</div><p>
<a class="anchor" name="a3e8f3bdac15fac61128dc47c22ba4cd"></a><!-- doxytag: member="Gtk::Dialog::gobj" ref="a3e8f3bdac15fac61128dc47c22ba4cd" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">GtkDialog* Gtk::Dialog::gobj </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"><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_1Window.html#467102527550b51eb4036390caeedb5c">Gtk::Window</a>.
<p>
Reimplemented in <a class="el" href="classGtk_1_1AboutDialog.html#154a7b18752a8770891c424aee419763">Gtk::AboutDialog</a>, <a class="el" href="classGtk_1_1ColorSelectionDialog.html#45caeb0d10a9100ddebd70beae235f89">Gtk::ColorSelectionDialog</a>, <a class="el" href="classGtk_1_1FileChooserDialog.html#8bcb702bdc16043f42481c8cebccae55">Gtk::FileChooserDialog</a>, <a class="el" href="classGtk_1_1FileSelection.html#03ebec3a61eaf4ef998efd9a4797a2cf">Gtk::FileSelection</a>, <a class="el" href="classGtk_1_1FontSelectionDialog.html#d5b39fcf3ce8f770bc2987267f46a12b">Gtk::FontSelectionDialog</a>, <a class="el" href="classGtk_1_1InputDialog.html#207e658e5dcd65c726fd626368b103c9">Gtk::InputDialog</a>, <a class="el" href="classGtk_1_1MessageDialog.html#6019fc42bcc8e891dfbcc6565939ec8e">Gtk::MessageDialog</a>, <a class="el" href="classGtk_1_1PageSetupUnixDialog.html#037e9e6f945a24d31cb2b16605eb1aab">Gtk::PageSetupUnixDialog</a>, <a class="el" href="classGtk_1_1PrintUnixDialog.html#e8d543407e309cd6e7e67cd0aa2f82b0">Gtk::PrintUnixDialog</a>, and <a class="el" href="classGtk_1_1RecentChooserDialog.html#a9037355630ec732629caf279a3012cf">Gtk::RecentChooserDialog</a>.
</div>
</div><p>
<a class="anchor" name="9d3aab6c3ea727acab2af375e9ad3479"></a><!-- doxytag: member="Gtk::Dialog::on_response" ref="9d3aab6c3ea727acab2af375e9ad3479" args="(int response_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">virtual void Gtk::Dialog::on_response </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>response_id</em> </td>
<td> ) </td>
<td width="100%"><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
</div>
</div><p>
<a class="anchor" name="ecc98b69a0ff63b428cc57e026643492"></a><!-- doxytag: member="Gtk::Dialog::property_has_separator" ref="ecc98b69a0ff63b428cc57e026643492" args="() const" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><bool> Gtk::Dialog::property_has_separator </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The dialog has a separator bar above its buttons.
<p>
You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><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><p>
<a class="anchor" name="9213b6718a78d180c7f1c77cd30b1b26"></a><!-- doxytag: member="Gtk::Dialog::property_has_separator" ref="9213b6718a78d180c7f1c77cd30b1b26" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> Gtk::Dialog::property_has_separator </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
The dialog has a separator bar above its buttons.
<p>
You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><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><p>
<a class="anchor" name="7cf451db55cadc3509f360f70d0e0ecb"></a><!-- doxytag: member="Gtk::Dialog::response" ref="7cf451db55cadc3509f360f70d0e0ecb" args="(int response_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Dialog::response </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>response_id</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Emits the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">Gtk::Dialog::response</a> signal with the given response ID.
<p>
Used to indicate that the user has responded to the dialog in some way; typically either you or <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6">run()</a> will be monitoring the response signal and take appropriate action. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>response_id</em> </td><td>Response ID. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="dc98a1e747613c9b6cb66c238f6f8da6"></a><!-- doxytag: member="Gtk::Dialog::run" ref="dc98a1e747613c9b6cb66c238f6f8da6" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int Gtk::Dialog::run </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Blocks in a recursive main loop until the <em>dialog</em> emits the response signal.
<p>
It returns the response ID from the "response" signal emission. Before entering the recursive main loop, <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6">run()</a> calls <a class="el" href="classGtk_1_1Widget.html#a791d86a0bb3658e378e81d731dd0121">Gtk::Widget::show()</a> on the dialog for you. Note that you still need to show any children of the dialog yourself.<p>
If the dialog receives "delete_event", <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6">Gtk::Dialog::run()</a> will return <a class="el" href="group__gtkmmEnums.html#gg407d25a7b827dbdb685077de442e9b389d8e23d86df7d0f4096c5842dd7ad832">Gtk::RESPONSE_DELETE_EVENT</a>. Also, during <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6">Gtk::Dialog::run()</a> the dialog will be modal. You can force <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6">Gtk::Dialog::run()</a> to return at any time by calling <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">Gtk::Dialog::response()</a> to emit the "response" signal.<p>
After <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6">Gtk::Dialog::run()</a> returns, you are responsible for hiding or destroying the dialog if you wish to do so.<p>
Typical usage of this function might be: <div class="fragment"><pre class="fragment"> <tt><span class="keywordtype">int</span></tt> result = dialog.run();
<span class="keywordflow">switch</span> (result)
{
<span class="keywordflow">case</span> GTK_RESPONSE_ACCEPT:
do_application_specific_something (&lt;!-- --&gt;);
<span class="keywordflow">break</span>;
<span class="keywordflow">default</span>:
do_nothing_since_dialog_was_cancelled (&lt;!-- --&gt;);
<span class="keywordflow">break</span>;
}
</pre></div> <dl class="return" compact><dt><b>Returns:</b></dt><dd>Response ID. </dd></dl>
</div>
</div><p>
<a class="anchor" name="ae3b78426fbdd620c5a46166ba664146"></a><!-- doxytag: member="Gtk::Dialog::set_alternative_button_order_from_array" ref="ae3b78426fbdd620c5a46166ba664146" args="(const Glib::ArrayHandle< int > &new_order)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Dialog::set_alternative_button_order_from_array </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>< int > & </td>
<td class="paramname"> <em>new_order</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets an alternative button order.
<p>
If the gtk-alternative-button-order setting is set to true, the dialog buttons are reordered according to the order of the response ids in <em>new_order</em>.<p>
By default, GTK+ dialogs use the button order advocated by the Gnome <ulink url="http://developer.gnome.org/projects/gup/hig/2.0/">Human Interface Guidelines</ulink> with the affirmative button at the far right, and the cancel button left of it. But the builtin GTK+ dialogs and GtkMessageDialogs do provide an alternative button order, which is more suitable on some platforms, e.g. Windows.<p>
Use this function after adding all the buttons to your dialog<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>new_order</em> </td><td>an array of response ids of the dialog's buttons.</td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="9a042edc1a83ae5d670305635d193fea"></a><!-- doxytag: member="Gtk::Dialog::set_default_response" ref="9a042edc1a83ae5d670305635d193fea" args="(int response_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Dialog::set_default_response </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>response_id</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets the last widget in the dialog's action area with the given <em>response_id</em> as the default widget for the dialog.
<p>
Pressing "Enter" normally activates the default widget. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>response_id</em> </td><td>A response ID. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="c39df2f1035a441047d48c94d72315c6"></a><!-- doxytag: member="Gtk::Dialog::set_has_separator" ref="c39df2f1035a441047d48c94d72315c6" args="(bool setting=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Dialog::set_has_separator </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>setting</em> = <code>true</code> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Sets whether the dialog has a separator above the buttons.
<p>
<code>true</code> by default. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>setting</em> </td><td><code>true</code> to have a separator. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="04da02d509bf9c759a15cdb1dc544a5d"></a><!-- doxytag: member="Gtk::Dialog::set_response_sensitive" ref="04da02d509bf9c759a15cdb1dc544a5d" args="(int response_id, bool setting=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void Gtk::Dialog::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><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Calls <code>gtk_widget_set_sensitive (widget, <em>setting</em> )</code> for each widget in the dialog's action area with the given <em>response_id</em> .
<p>
A convenient way to sensitize/desensitize dialog buttons. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>response_id</em> </td><td>A response ID. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>setting</em> </td><td><code>true</code> for sensitive. </td></tr>
</table>
</dl>
</div>
</div><p>
<a class="anchor" name="813b36a938805498073e887b29126359"></a><!-- doxytag: member="Gtk::Dialog::signal_response" ref="813b36a938805498073e887b29126359" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>< void,int > Gtk::Dialog::signal_response </td>
<td>(</td>
<td class="paramname"> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
<dl class="user" compact><dt><b>Prototype:</b></dt><dd><code>void on_my_response(int response_id)</code> </dd></dl>
<p>
</div>
</div><p>
<hr><h2>Friends And Related Function Documentation</h2>
<a class="anchor" name="1f0f3f2840498099a768a81eafdca8f7"></a><!-- doxytag: member="Gtk::Dialog::wrap" ref="1f0f3f2840498099a768a81eafdca8f7" args="(GtkDialog *object, bool take_copy=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGtk_1_1Dialog.html">Gtk::Dialog</a>* wrap </td>
<td>(</td>
<td class="paramtype">GtkDialog * </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><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"><code> [related]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
A <a class="elRef" doxygen="glibmm_doxygen_tags:../../../../glibmm-2.4/docs/reference/html/" href="../../../../glibmm-2.4/docs/reference/html/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>object</em> </td><td>The C instance. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>take_copy</em> </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>
</dl>
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
</div>
</div><p>
<hr>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="dialog_8h.html">dialog.h</a></ul>
</div>
<!-- end main content -->
<hr><address><small>
Generated for gtkmm 2.4 by <a href="http://www.doxygen.org/index.html">
Doxygen</a> 1.5.1 © 1997-2001</small></address>
</body>
</html>
distrib
>
Mandriva
>
2008.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
9411cff4bc6d4e61b29ae81cd24665af
>
files
>
343
