<!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::Dialog 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.6.1 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<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 class="tabs">
<ul>
<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="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="namespaceGtk.html">Gtk</a>::<a class="el" href="classGtk_1_1Dialog.html">Dialog</a>
</div>
</div>
<div class="contents">
<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" -->
<p>Create popup windows. <a href="#_details">More...</a></p>
<p>Inherits <a class="el" href="classGtk_1_1Window.html">Gtk::Window</a>.</p>
<p>Inherited by <a class="el" href="classGtk_1_1AboutDialog.html">Gtk::AboutDialog</a>, <a class="el" href="classGtk_1_1ColorSelectionDialog.html">Gtk::ColorSelectionDialog</a>, <a class="el" href="classGtk_1_1FileChooserDialog.html">Gtk::FileChooserDialog</a>, <a class="el" href="classGtk_1_1FileSelection.html">Gtk::FileSelection</a>, <a class="el" href="classGtk_1_1FontSelectionDialog.html">Gtk::FontSelectionDialog</a>, <a class="el" href="classGtk_1_1InputDialog.html">Gtk::InputDialog</a>, <a class="el" href="classGtk_1_1MessageDialog.html">Gtk::MessageDialog</a>, <a class="el" href="classGtk_1_1PageSetupUnixDialog.html">Gtk::PageSetupUnixDialog</a>, <a class="el" href="classGtk_1_1PrintUnixDialog.html">Gtk::PrintUnixDialog</a>, and <a class="el" href="classGtk_1_1RecentChooserDialog.html">Gtk::RecentChooserDialog</a>.</p>
<div class="dynheader">
Collaboration diagram for Gtk::Dialog:</div>
<div class="dynsection">
<div class="center"><img src="classGtk_1_1Dialog__coll__graph.png" border="0" usemap="#Gtk_1_1Dialog_coll__map" alt="Collaboration graph"/></div>
<map name="Gtk_1_1Dialog_coll__map" id="Gtk_1_1Dialog_coll__map">
<area shape="rect" href="classGtk_1_1Window.html" title="Toplevel Window This represents all widgets which are physical windows controlled..." alt="" coords="143,597,239,627"/><area shape="rect" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="63,501,132,531"/><area shape="rect" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="37,405,141,435"/><area shape="rect" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)." alt="" coords="44,325,135,355"/><area shape="rect" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such..." alt="" coords="5,245,93,275"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="8,165,99,195"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="64,85,184,115"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="123,165,227,195"/><area shape="rect" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="71,5,177,35"/><area shape="rect" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="117,245,237,275"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html" title="Glib::RefPtr\< AccelGroup \>" alt="" coords="167,501,348,531"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html" title="Glib::RefPtr\< T_CppObject \>" alt="" coords="165,405,355,435"/></map>
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
<p><a href="classGtk_1_1Dialog-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>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_1Dialog.html#a20ecf1401f15179073406bda2b766946">~Dialog</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">GtkDialog* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#aa3e8f3bdac15fac61128dc47c22ba4cd">gobj</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#aa3e8f3bdac15fac61128dc47c22ba4cd"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const GtkDialog* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a534ffd24e55400a26aef733a7f588856">gobj</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a534ffd24e55400a26aef733a7f588856"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a7e746e77abaa67ccdc920ca97ad9b06e">Dialog</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a36b72560ec3c1cd2f3ecce7eae0439d6">Dialog</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& title, bool modal=false, bool use_separator=false)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a74ae53f24af2a2449c5add35fb6dc40b">Dialog</a> (const <a class="elRef" href="../../../glibmm-2.4/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" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a096c1736344266e316dd31bbd5c43e19">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" title="Create popup windows.">Gtk::Dialog</a>, connecting a signal handler that will emit the <a class="el" href="classGtk_1_1Dialog.html#a7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response</a> signal on the dialog when the widget is activated. <a href="#a096c1736344266e316dd31bbd5c43e19"></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_1Dialog.html#aca037e133ab2a91c646f23b7b17afb9b">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 <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#a7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response</a> signal with the given <em>response_id</em>. <a href="#aca037e133ab2a91c646f23b7b17afb9b"></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_1Dialog.html#ac2a99c5d26c1022c2d259448f5f179a7">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#a7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response</a> signal with the given <em>response_id</em>. <a href="#ac2a99c5d26c1022c2d259448f5f179a7"></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_1Dialog.html#a04da02d509bf9c759a15cdb1dc544a5d">set_response_sensitive</a> (int response_id, bool setting=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Calls <literal>gtk_widget_set_sensitive (widget, <em>setting</em>)</literal> for each widget in the dialog's action area with the given <em>response_id</em>. <a href="#a04da02d509bf9c759a15cdb1dc544a5d"></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_1Dialog.html#a9a042edc1a83ae5d670305635d193fea">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="#a9a042edc1a83ae5d670305635d193fea"></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_1Dialog.html#af259947b29ba1dc093bc1d112400c03c">get_widget_for_response</a> (int response_id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the widget button that uses the given response ID in the action area of a dialog. <a href="#af259947b29ba1dc093bc1d112400c03c"></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_1Dialog.html#a9b5ed8769cb9d318ea376aabdd373376">get_widget_for_response</a> (int response_id) const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the widget button that uses the given response ID in the action area of a dialog. <a href="#a9b5ed8769cb9d318ea376aabdd373376"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a1340388130eede2edf63404c0e27f79d">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="#a1340388130eede2edf63404c0e27f79d"></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_1Dialog.html#ac39df2f1035a441047d48c94d72315c6">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="#ac39df2f1035a441047d48c94d72315c6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a15197791803d5fcb49134e3c56e04ee1">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="#a15197791803d5fcb49134e3c56e04ee1"></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_1Dialog.html#aae3b78426fbdd620c5a46166ba664146">set_alternative_button_order_from_array</a> (const <a class="elRef" href="../../../glibmm-2.4/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="#aae3b78426fbdd620c5a46166ba664146"></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_1Dialog.html#a7cf451db55cadc3509f360f70d0e0ecb">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#a7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response</a> signal with the given response ID. <a href="#a7cf451db55cadc3509f360f70d0e0ecb"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#adc98a1e747613c9b6cb66c238f6f8da6">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="#adc98a1e747613c9b6cb66c238f6f8da6"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1ButtonBox.html">ButtonBox</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ae56668b63a4f134c7135e98b74f2acab">get_action_area</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the action area of <em>dialog</em>. <a href="#ae56668b63a4f134c7135e98b74f2acab"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classGtk_1_1ButtonBox.html">ButtonBox</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ae16b393cc1e6b11bab611f8aa5e694fb">get_action_area</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the action area of <em>dialog</em>. <a href="#ae16b393cc1e6b11bab611f8aa5e694fb"></a><br/></td></tr>
<tr><td class="memItemLeft" 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#ab667999656d5cdf5729d57d6eea879ce">get_vbox</a> ()</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the content area of <em>dialog</em>. <a href="#ab667999656d5cdf5729d57d6eea879ce"></a><br/></td></tr>
<tr><td class="memItemLeft" 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#a44e309c56deb37a92d2df1458cd859b1">get_vbox</a> () const </td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the content area of <em>dialog</em>. <a href="#a44e309c56deb37a92d2df1458cd859b1"></a><br/></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>< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a9213b6718a78d180c7f1c77cd30b1b26">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="#a9213b6718a78d180c7f1c77cd30b1b26"></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"/>
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ab8aec40cb36275b0d38cad8f0c251515">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="#ab8aec40cb36275b0d38cad8f0c251515"></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_1Dialog.html#a813b36a938805498073e887b29126359">signal_response</a> ()</td></tr>
<tr><td colspan="2"><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ada94684e77582514fcf9062585c64824">alternative_button_order</a> (const <a class="elRef" href="../../../glibmm-2.4/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 <code>true</code> if dialogs are expected to use an alternative button order on the screen <em>screen</em>. <a href="#ada94684e77582514fcf9062585c64824"></a><br/></td></tr>
<tr><td colspan="2"><h2>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_1Dialog.html#a9d3aab6c3ea727acab2af375e9ad3479">on_response</a> (int response_id)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ae329b0fb53552267a5846e428fa1c84f">construct_</a> (bool modal, bool use_separator)</td></tr>
<tr><td colspan="2"><h2>Related Functions</h2></td></tr>
<tr><td colspan="2"><p>(Note that these are not member functions.) </p>
<br/><br/></td></tr>
<tr><td class="memItemLeft" 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#a1f0f3f2840498099a768a81eafdca8f7">wrap</a> (GtkDialog* 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="#a1f0f3f2840498099a768a81eafdca8f7"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>Create popup windows. </p>
<p><a class="el" href="classGtk_1_1Dialog.html" title="Create popup windows.">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>
<p>gtkmm treats a dialog as a window split vertically. The top section is a <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>, and is where widgets such as a <a class="el" href="classGtk_1_1Label.html" title="A widget that displays a small to medium amount of text.">Gtk::Label</a> or a <a class="el" href="classGtk_1_1Entry.html" title="A single line text entry field.">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" title="Horizontal line widget.">Gtk::HSeparator</a>.</p>
<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" title="Create popup windows.">Gtk::Dialog</a> constructor.</p>
<p>When adding buttons using <a class="el" href="classGtk_1_1Dialog.html#aca037e133ab2a91c646f23b7b17afb9b" title="Adds a button with the given text (or a stock button, if button_text is a stock ID)...">add_button()</a>, clicking the button will emit <a class="el" href="classGtk_1_1Dialog.html#a813b36a938805498073e887b29126359">signal_response()</a> with a "response id" you specified. You are encouraged to use the <a class="el" href="group__gtkmmEnums.html#ga407d25a7b827dbdb685077de442e9b38">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#gga407d25a7b827dbdb685077de442e9b38a5dfe7c858a12744d418471de12a8b6a8">Gtk::RESPONSE_NONE</a>.</p>
<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#adc98a1e747613c9b6cb66c238f6f8da6" title="Blocks in a recursive main loop until the dialog emits the response signal.">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>
<hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a20ecf1401f15179073406bda2b766946"></a><!-- doxytag: member="Gtk::Dialog::~Dialog" ref="a20ecf1401f15179073406bda2b766946" 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><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a7e746e77abaa67ccdc920ca97ad9b06e"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="a7e746e77abaa67ccdc920ca97ad9b06e" 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></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a36b72560ec3c1cd2f3ecce7eae0439d6"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="a36b72560ec3c1cd2f3ecce7eae0439d6" 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" href="../../../glibmm-2.4/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><code> [explicit]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="a74ae53f24af2a2449c5add35fb6dc40b"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="a74ae53f24af2a2449c5add35fb6dc40b" 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" href="../../../glibmm-2.4/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></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a096c1736344266e316dd31bbd5c43e19"></a><!-- doxytag: member="Gtk::Dialog::add_action_widget" ref="a096c1736344266e316dd31bbd5c43e19" 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></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" title="Create popup windows.">Gtk::Dialog</a>, connecting a signal handler that will emit the <a class="el" href="classGtk_1_1Dialog.html#a7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response</a> signal on the dialog when the widget is activated. </p>
<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" title="Create popup windows.">Gtk::Dialog</a> struct. </p>
<dl><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>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ac2a99c5d26c1022c2d259448f5f179a7"></a><!-- doxytag: member="Gtk::Dialog::add_button" ref="ac2a99c5d26c1022c2d259448f5f179a7" 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></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#a7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response</a> signal with the given <em>response_id</em>. </p>
<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. </p>
<dl><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>
</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="aca037e133ab2a91c646f23b7b17afb9b"></a><!-- doxytag: member="Gtk::Dialog::add_button" ref="aca037e133ab2a91c646f23b7b17afb9b" 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" 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><td> </td>
</tr>
<tr>
<td></td>
<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 <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#a7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response</a> signal with the given <em>response_id</em>. </p>
<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. </p>
<dl><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>
</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="ada94684e77582514fcf9062585c64824"></a><!-- doxytag: member="Gtk::Dialog::alternative_button_order" ref="ada94684e77582514fcf9062585c64824" 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" href="../../../glibmm-2.4/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><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns <code>true</code> if dialogs are expected to use an alternative button order on the screen <em>screen</em>. </p>
<p>See Gtk::Dialog::set_alternative_button_order() for more details about alternative button order.</p>
<p>If you need to use this function, you should probably connect to the notify:gtk-alternative-button-order signal on the <a class="el" href="classGtk_1_1Settings.html" title="Sharing settings between applications.">Gtk::Settings</a> object associated to <em>screen</em>, in order to be notified if the button order setting changes.</p>
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000066">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
<dl><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" title="Object representing a physical screen Gdk::Screen objects are the GDK representation...">Gdk::Screen</a>, or <code>0</code> to use the default screen. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>Whether the alternative button order should be used. </dd></dl>
</div>
</div>
<a class="anchor" id="ae329b0fb53552267a5846e428fa1c84f"></a><!-- doxytag: member="Gtk::Dialog::construct_" ref="ae329b0fb53552267a5846e428fa1c84f" 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><code> [protected]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="ae16b393cc1e6b11bab611f8aa5e694fb"></a><!-- doxytag: member="Gtk::Dialog::get_action_area" ref="ae16b393cc1e6b11bab611f8aa5e694fb" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const <a class="el" href="classGtk_1_1ButtonBox.html">ButtonBox</a>* Gtk::Dialog::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>dialog</em>. </p>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000051">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The action area. </dd></dl>
<p>Reimplemented in <a class="el" href="classGtk_1_1FileSelection.html#ac6569b3ae5884837df55cdd654ca52d3">Gtk::FileSelection</a>.</p>
</div>
</div>
<a class="anchor" id="ae56668b63a4f134c7135e98b74f2acab"></a><!-- doxytag: member="Gtk::Dialog::get_action_area" ref="ae56668b63a4f134c7135e98b74f2acab" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGtk_1_1ButtonBox.html">ButtonBox</a>* Gtk::Dialog::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>dialog</em>. </p>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000050">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The action area. </dd></dl>
<p>Reimplemented in <a class="el" href="classGtk_1_1FileSelection.html#a3eb51f01b118c49574a7915c3fbeca47">Gtk::FileSelection</a>.</p>
</div>
</div>
<a class="anchor" id="a15197791803d5fcb49134e3c56e04ee1"></a><!-- doxytag: member="Gtk::Dialog::get_has_separator" ref="a15197791803d5fcb49134e3c56e04ee1" 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> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Accessor for whether the dialog has a separator. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the dialog has a separator. </dd></dl>
</div>
</div>
<a class="anchor" id="a1340388130eede2edf63404c0e27f79d"></a><!-- doxytag: member="Gtk::Dialog::get_response_for_widget" ref="a1340388130eede2edf63404c0e27f79d" 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> 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 class="since_2_8"><dt><b><a class="el" href="since_2_8.html#_since_2_8000012">Since gtkmm 2.8:</a></b></dt><dd></dd></dl>
<dl><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>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The response id of <em>widget</em>, or <a class="el" href="group__gtkmmEnums.html#gga407d25a7b827dbdb685077de442e9b38a5dfe7c858a12744d418471de12a8b6a8">Gtk::RESPONSE_NONE</a> if <em>widget</em> doesn't have a response id set. </dd></dl>
</div>
</div>
<a class="anchor" id="a44e309c56deb37a92d2df1458cd859b1"></a><!-- doxytag: member="Gtk::Dialog::get_vbox" ref="a44e309c56deb37a92d2df1458cd859b1" 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> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the content area of <em>dialog</em>. </p>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000053">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The content area <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>. </dd></dl>
</div>
</div>
<a class="anchor" id="ab667999656d5cdf5729d57d6eea879ce"></a><!-- doxytag: member="Gtk::Dialog::get_vbox" ref="ab667999656d5cdf5729d57d6eea879ce" 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></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the content area of <em>dialog</em>. </p>
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000052">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The content area <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>. </dd></dl>
</div>
</div>
<a class="anchor" id="a9b5ed8769cb9d318ea376aabdd373376"></a><!-- doxytag: member="Gtk::Dialog::get_widget_for_response" ref="a9b5ed8769cb9d318ea376aabdd373376" args="(int response_id) 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::Dialog::get_widget_for_response </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>response_id</em></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Gets the widget button that uses the given response ID in the action area of a dialog. </p>
<dl class="since_2_20"><dt><b><a class="el" href="since_2_20.html#_since_2_20000005">Since gtkmm 2.20:</a></b></dt><dd></dd></dl>
<dl><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>The response ID used by the <em>dialog</em> widget. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The <em>widget</em> button that uses the given <em>response_id</em>, or <code>0</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="af259947b29ba1dc093bc1d112400c03c"></a><!-- doxytag: member="Gtk::Dialog::get_widget_for_response" ref="af259947b29ba1dc093bc1d112400c03c" args="(int response_id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="classGtk_1_1Widget.html">Widget</a>* Gtk::Dialog::get_widget_for_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>Gets the widget button that uses the given response ID in the action area of a dialog. </p>
<dl class="since_2_20"><dt><b><a class="el" href="since_2_20.html#_since_2_20000004">Since gtkmm 2.20:</a></b></dt><dd></dd></dl>
<dl><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>The response ID used by the <em>dialog</em> widget. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The <em>widget</em> button that uses the given <em>response_id</em>, or <code>0</code>. </dd></dl>
</div>
</div>
<a class="anchor" id="a534ffd24e55400a26aef733a7f588856"></a><!-- doxytag: member="Gtk::Dialog::gobj" ref="a534ffd24e55400a26aef733a7f588856" 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> 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#afe314a1e65505be026688060dc98ad3a">Gtk::Window</a>.</p>
<p>Reimplemented in <a class="el" href="classGtk_1_1AboutDialog.html#a72c054536026167d3c2b5fbb5773faff">Gtk::AboutDialog</a>, <a class="el" href="classGtk_1_1ColorSelectionDialog.html#af9859a5abd76a8f07cb7a7b151cec160">Gtk::ColorSelectionDialog</a>, <a class="el" href="classGtk_1_1FileChooserDialog.html#a0e990ba2ed1af83d23126725aa0fa6bf">Gtk::FileChooserDialog</a>, <a class="el" href="classGtk_1_1FileSelection.html#ac859d39ad6a48392c7b7ebba019c71be">Gtk::FileSelection</a>, <a class="el" href="classGtk_1_1FontSelectionDialog.html#ab036ff001acbc16468acf1c7009026fc">Gtk::FontSelectionDialog</a>, <a class="el" href="classGtk_1_1MessageDialog.html#a53ab4665373026c6c78782520ab3596d">Gtk::MessageDialog</a>, <a class="el" href="classGtk_1_1RecentChooserDialog.html#a58dd5a2e883b2b4888a78257af12deac">Gtk::RecentChooserDialog</a>, <a class="el" href="classGtk_1_1PageSetupUnixDialog.html#aee73bd66a347d42840347afd1a747e0b">Gtk::PageSetupUnixDialog</a>, <a class="el" href="classGtk_1_1PrintUnixDialog.html#a6f350b2c32507e663c640a4217068155">Gtk::PrintUnixDialog</a>, and <a class="el" href="classGtk_1_1InputDialog.html#afc77a70cbff7baced0095b03ea1b7ee0">Gtk::InputDialog</a>.</p>
</div>
</div>
<a class="anchor" id="aa3e8f3bdac15fac61128dc47c22ba4cd"></a><!-- doxytag: member="Gtk::Dialog::gobj" ref="aa3e8f3bdac15fac61128dc47c22ba4cd" 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><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#a467102527550b51eb4036390caeedb5c">Gtk::Window</a>.</p>
<p>Reimplemented in <a class="el" href="classGtk_1_1AboutDialog.html#a154a7b18752a8770891c424aee419763">Gtk::AboutDialog</a>, <a class="el" href="classGtk_1_1ColorSelectionDialog.html#a45caeb0d10a9100ddebd70beae235f89">Gtk::ColorSelectionDialog</a>, <a class="el" href="classGtk_1_1FileChooserDialog.html#a8bcb702bdc16043f42481c8cebccae55">Gtk::FileChooserDialog</a>, <a class="el" href="classGtk_1_1FileSelection.html#a03ebec3a61eaf4ef998efd9a4797a2cf">Gtk::FileSelection</a>, <a class="el" href="classGtk_1_1FontSelectionDialog.html#ad5b39fcf3ce8f770bc2987267f46a12b">Gtk::FontSelectionDialog</a>, <a class="el" href="classGtk_1_1MessageDialog.html#a6019fc42bcc8e891dfbcc6565939ec8e">Gtk::MessageDialog</a>, <a class="el" href="classGtk_1_1RecentChooserDialog.html#aa9037355630ec732629caf279a3012cf">Gtk::RecentChooserDialog</a>, <a class="el" href="classGtk_1_1PageSetupUnixDialog.html#a037e9e6f945a24d31cb2b16605eb1aab">Gtk::PageSetupUnixDialog</a>, <a class="el" href="classGtk_1_1PrintUnixDialog.html#ae8d543407e309cd6e7e67cd0aa2f82b0">Gtk::PrintUnixDialog</a>, and <a class="el" href="classGtk_1_1InputDialog.html#a207e658e5dcd65c726fd626368b103c9">Gtk::InputDialog</a>.</p>
</div>
</div>
<a class="anchor" id="a9d3aab6c3ea727acab2af375e9ad3479"></a><!-- doxytag: member="Gtk::Dialog::on_response" ref="a9d3aab6c3ea727acab2af375e9ad3479" 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><code> [protected, virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<a class="anchor" id="ab8aec40cb36275b0d38cad8f0c251515"></a><!-- doxytag: member="Gtk::Dialog::property_has_separator" ref="ab8aec40cb36275b0d38cad8f0c251515" 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><bool> Gtk::Dialog::property_has_separator </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The dialog has a separator bar above its buttons. </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="a9213b6718a78d180c7f1c77cd30b1b26"></a><!-- doxytag: member="Gtk::Dialog::property_has_separator" ref="a9213b6718a78d180c7f1c77cd30b1b26" 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><bool> Gtk::Dialog::property_has_separator </td>
<td>(</td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>The dialog has a separator bar above its buttons. </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="a7cf451db55cadc3509f360f70d0e0ecb"></a><!-- doxytag: member="Gtk::Dialog::response" ref="a7cf451db55cadc3509f360f70d0e0ecb" 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></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Emits the <a class="el" href="classGtk_1_1Dialog.html#a7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response</a> signal with the given response ID. </p>
<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#adc98a1e747613c9b6cb66c238f6f8da6" title="Blocks in a recursive main loop until the dialog emits the response signal.">run()</a> will be monitoring the response signal and take appropriate action. </p>
<dl><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>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="adc98a1e747613c9b6cb66c238f6f8da6"></a><!-- doxytag: member="Gtk::Dialog::run" ref="adc98a1e747613c9b6cb66c238f6f8da6" 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></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Blocks in a recursive main loop until the <em>dialog</em> emits the response signal. </p>
<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#adc98a1e747613c9b6cb66c238f6f8da6" title="Blocks in a recursive main loop until the dialog emits the response signal.">run()</a> calls <a class="el" href="classGtk_1_1Widget.html#aa791d86a0bb3658e378e81d731dd0121" title="Flags a widget to be displayed.">Gtk::Widget::show()</a> on the dialog for you. Note that you still need to show any children of the dialog yourself.</p>
<p>If the dialog receives "delete_event", <a class="el" href="classGtk_1_1Dialog.html#adc98a1e747613c9b6cb66c238f6f8da6" title="Blocks in a recursive main loop until the dialog emits the response signal.">Gtk::Dialog::run()</a> will return <a class="el" href="group__gtkmmEnums.html#gga407d25a7b827dbdb685077de442e9b38a9d8e23d86df7d0f4096c5842dd7ad832">Gtk::RESPONSE_DELETE_EVENT</a>. Also, during <a class="el" href="classGtk_1_1Dialog.html#adc98a1e747613c9b6cb66c238f6f8da6" title="Blocks in a recursive main loop until the dialog emits the response signal.">Gtk::Dialog::run()</a> the dialog will be modal. You can force <a class="el" href="classGtk_1_1Dialog.html#adc98a1e747613c9b6cb66c238f6f8da6" title="Blocks in a recursive main loop until the dialog emits the response signal.">Gtk::Dialog::run()</a> to return at any time by calling <a class="el" href="classGtk_1_1Dialog.html#a7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response()</a> to emit the "response" signal.</p>
<p>After <a class="el" href="classGtk_1_1Dialog.html#adc98a1e747613c9b6cb66c238f6f8da6" title="Blocks in a recursive main loop until the dialog emits the response signal.">Gtk::Dialog::run()</a> returns, you are responsible for hiding or destroying the dialog if you wish to do so.</p>
<p>Typical usage of this function might be: </p>
<div class="fragment"><pre class="fragment"> <span class="keywordtype">int</span> result = dialog.run();
<span class="keywordflow">switch</span> (result)
{
<span class="keywordflow">case</span> <a class="code" href="group__gtkmmEnums.html#gga407d25a7b827dbdb685077de442e9b38ad61a3fd00662c4f7e5f9915fdcb02454">Gtk::RESPONSE_ACCEPT</a>:
do_application_specific_something();
<span class="keywordflow">break</span>;
<span class="keywordflow">default</span>:
do_nothing_since_dialog_was_cancelled();
<span class="keywordflow">break</span>;
}
</pre></div> <dl class="return"><dt><b>Returns:</b></dt><dd>Response ID. </dd></dl>
</div>
</div>
<a class="anchor" id="aae3b78426fbdd620c5a46166ba664146"></a><!-- doxytag: member="Gtk::Dialog::set_alternative_button_order_from_array" ref="aae3b78426fbdd620c5a46166ba664146" 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" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>< int > & </td>
<td class="paramname"> <em>new_order</em></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets an alternative button order. </p>
<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>
<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>
<p>Use this function after adding all the buttons to your dialog</p>
<dl><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>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a9a042edc1a83ae5d670305635d193fea"></a><!-- doxytag: member="Gtk::Dialog::set_default_response" ref="a9a042edc1a83ae5d670305635d193fea" 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></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>
<p>Pressing "Enter" normally activates the default widget. </p>
<dl><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>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ac39df2f1035a441047d48c94d72315c6"></a><!-- doxytag: member="Gtk::Dialog::set_has_separator" ref="ac39df2f1035a441047d48c94d72315c6" 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></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Sets whether the dialog has a separator above the buttons. </p>
<p><code>true</code> by default. </p>
<dl><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>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a04da02d509bf9c759a15cdb1dc544a5d"></a><!-- doxytag: member="Gtk::Dialog::set_response_sensitive" ref="a04da02d509bf9c759a15cdb1dc544a5d" 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></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Calls <literal>gtk_widget_set_sensitive (widget, <em>setting</em>)</literal> for each widget in the dialog's action area with the given <em>response_id</em>. </p>
<p>A convenient way to sensitize/desensitize dialog buttons. </p>
<dl><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>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a813b36a938805498073e887b29126359"></a><!-- doxytag: member="Gtk::Dialog::signal_response" ref="a813b36a938805498073e887b29126359" 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::Dialog::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="a1f0f3f2840498099a768a81eafdca8f7"></a><!-- doxytag: member="Gtk::Dialog::wrap" ref="a1f0f3f2840498099a768a81eafdca8f7" 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><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 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>
</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/dialog.h</li>
</ul>
</div>
<hr size="1"/><address style="text-align: right;"><small>Generated on Tue May 4 13:21:50 2010 for gtkmm by 
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2010.1
>
x86_64
>
media
>
main-release
>
by-pkgid
>
22e237efd6851989a23adf3360bb53d0
>
files
>
306
