1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
<html xmlns="http://www.w3.org/1999/xhtml">
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
<title>gtkmm: Gtk::Dialog Class Reference</title>
6
<link href="tabs.css" rel="stylesheet" type="text/css"/>
7
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
10
<!-- Generated by Doxygen 1.7.3 -->
13
<table cellspacing="0" cellpadding="0">
15
<tr style="height: 56px;">
16
<td style="padding-left: 0.5em;">
17
<div id="projectname">gtkmm <span id="projectnumber">2.24.2</span></div>
23
<div id="navrow1" class="tabs">
25
<li><a href="index.html"><span>Main Page</span></a></li>
26
<li><a href="pages.html"><span>Related Pages</span></a></li>
27
<li><a href="modules.html"><span>Modules</span></a></li>
28
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
29
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
32
<div id="navrow2" class="tabs2">
34
<li><a href="annotated.html"><span>Class List</span></a></li>
35
<li><a href="classes.html"><span>Class Index</span></a></li>
36
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
37
<li><a href="functions.html"><span>Class Members</span></a></li>
40
<div id="nav-path" class="navpath">
42
<li class="navelem"><a class="el" href="namespaceGtk.html">Gtk</a> </li>
43
<li class="navelem"><a class="el" href="classGtk_1_1Dialog.html">Dialog</a> </li>
49
<a href="#pub-methods">Public Member Functions</a> |
50
<a href="#pub-static-methods">Static Public Member Functions</a> |
51
<a href="#pro-methods">Protected Member Functions</a> |
52
<a href="#related">Related Functions</a> </div>
53
<div class="headertitle">
54
<h1>Gtk::Dialog Class Reference<div class="ingroups"><a class="el" href="group__Dialogs.html">Dialogs</a></div></h1> </div>
56
<div class="contents">
57
<!-- doxytag: class="Gtk::Dialog" --><!-- doxytag: inherits="Gtk::Window" -->
58
<p>Create popup windows. <a href="#_details">More...</a></p>
59
<div class="dynheader">
60
Inheritance diagram for Gtk::Dialog:</div>
61
<div class="dyncontent">
62
<div class="center"><img src="classGtk_1_1Dialog__inherit__graph.png" border="0" usemap="#Gtk_1_1Dialog_inherit__map" alt="Inheritance graph"/></div>
63
<map name="Gtk_1_1Dialog_inherit__map" id="Gtk_1_1Dialog_inherit__map">
64
<area shape="rect" id="node21" href="classGtk_1_1AboutDialog.html" title="The AboutDialog offers a simple way to display information about a program like its logo..." alt="" coords="1361,5,1481,35"/><area shape="rect" id="node23" href="classGtk_1_1ColorSelectionDialog.html" title="This dialog allows the user to select a color." alt="" coords="1336,58,1507,89"/><area shape="rect" id="node25" href="classGtk_1_1FileChooserDialog.html" title="Convenient file chooser window." alt="" coords="1344,111,1499,142"/><area shape="rect" id="node27" href="classGtk_1_1FileSelection.html" title="Prompt the user for a file or directory name." alt="" coords="1359,165,1484,195"/><area shape="rect" id="node29" href="classGtk_1_1FontSelectionDialog.html" title="A dialog box for selecting fonts." alt="" coords="1339,218,1504,249"/><area shape="rect" id="node31" href="classGtk_1_1InputDialog.html" title="Gtk::InputDialog" alt="" coords="1364,271,1479,302"/><area shape="rect" id="node33" href="classGtk_1_1MessageDialog.html" title="Convenient message window." alt="" coords="1352,325,1491,355"/><area shape="rect" id="node35" href="classGtk_1_1PageSetupUnixDialog.html" title="PageSetupUnixDialog implements a page setup dialog for platforms which don't provide a native pag..." alt="" coords="1333,378,1509,409"/><area shape="rect" id="node37" href="classGtk_1_1PrintUnixDialog.html" title="PrintUnixDialog implements a print dialog for platforms which don't provide a native print dialog..." alt="" coords="1352,431,1491,462"/><area shape="rect" id="node39" href="classGtk_1_1RecentChooserDialog.html" title="RecentChooserDialog is a dialog box suitable for displaying the recently used documents." alt="" coords="1333,485,1509,515"/><area shape="rect" id="node2" href="classGtk_1_1Window.html" title="Toplevel Window This represents all widgets which are physical windows controlled by the window manag..." alt="" coords="1053,245,1149,275"/><area shape="rect" id="node4" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="935,245,1004,275"/><area shape="rect" id="node6" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="779,245,885,275"/><area shape="rect" id="node8" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="640,245,731,275"/><area shape="rect" id="node10" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such as Gtk::Adjustme..." alt="" coords="487,218,575,249"/><area shape="rect" id="node12" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="331,218,421,249"/><area shape="rect" id="node14" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="161,218,281,249"/><area shape="rect" id="node16" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="5,218,112,249"/><area shape="rect" id="node18" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="469,271,592,302"/></map>
65
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
66
<div class="dynheader">
67
Collaboration diagram for Gtk::Dialog:</div>
68
<div class="dyncontent">
69
<div class="center"><img src="classGtk_1_1Dialog__coll__graph.png" border="0" usemap="#Gtk_1_1Dialog_coll__map" alt="Collaboration graph"/></div>
70
<map name="Gtk_1_1Dialog_coll__map" id="Gtk_1_1Dialog_coll__map">
71
<area shape="rect" id="node2" href="classGtk_1_1Window.html" title="Toplevel Window This represents all widgets which are physical windows controlled by the window manag..." alt="" coords="216,617,312,647"/><area shape="rect" id="node4" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="136,518,205,549"/><area shape="rect" id="node6" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="108,419,215,450"/><area shape="rect" id="node8" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="116,337,207,367"/><area shape="rect" id="node10" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such as Gtk::Adjustme..." alt="" coords="21,254,109,285"/><area shape="rect" id="node12" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,171,111,202"/><area shape="rect" id="node14" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,89,125,119"/><area shape="rect" id="node16" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,6,119,37"/><area shape="rect" id="node18" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="133,254,256,285"/><area shape="rect" id="node20" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html" title="Glib::RefPtr\< AccelGroup \>" alt="" coords="240,518,421,549"/><area shape="rect" id="node22" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html" title="Glib::RefPtr\< T_CppObject \>" alt="" coords="239,419,428,450"/></map>
72
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
74
<p><a href="classGtk_1_1Dialog-members.html">List of all members.</a></p>
75
<table class="memberdecls">
76
<tr><td colspan="2"><h2><a name="pub-methods"></a>
77
Public Member Functions</h2></td></tr>
78
<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>
79
<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>
80
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#aa3e8f3bdac15fac61128dc47c22ba4cd"></a><br/></td></tr>
81
<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>
82
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a534ffd24e55400a26aef733a7f588856"></a><br/></td></tr>
83
<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>
84
<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>
85
<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>
86
<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>
87
<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>
88
<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>
89
<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>
90
<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>
91
<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>
92
<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>
93
<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="#a04da02d509bf9c759a15cdb1dc544a5d"></a><br/></td></tr>
94
<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>
95
<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>
96
<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>
97
<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>
98
<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>
99
<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>
100
<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>
101
<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>
102
<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>
103
<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>
104
<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>
105
<tr><td class="mdescLeft"> </td><td class="mdescRight">Accessor for whether the dialog has a separator. <a href="#a15197791803d5fcb49134e3c56e04ee1"></a><br/></td></tr>
106
<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>
107
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets an alternative button order. <a href="#aae3b78426fbdd620c5a46166ba664146"></a><br/></td></tr>
108
<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>
109
<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>
110
<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>
111
<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>
112
<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>
113
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the action area of <em>dialog</em>. <a href="#ae56668b63a4f134c7135e98b74f2acab"></a><br/></td></tr>
114
<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>
115
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the action area of <em>dialog</em>. <a href="#ae16b393cc1e6b11bab611f8aa5e694fb"></a><br/></td></tr>
116
<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>
117
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the content area of <em>dialog</em>. <a href="#ab667999656d5cdf5729d57d6eea879ce"></a><br/></td></tr>
118
<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>
119
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the content area of <em>dialog</em>. <a href="#a44e309c56deb37a92d2df1458cd859b1"></a><br/></td></tr>
120
<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>
121
<tr><td class="mdescLeft"> </td><td class="mdescRight">The dialog has a separator bar above its buttons. <a href="#a9213b6718a78d180c7f1c77cd30b1b26"></a><br/></td></tr>
122
<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"/>
123
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ab8aec40cb36275b0d38cad8f0c251515">property_has_separator</a> () const </td></tr>
124
<tr><td class="mdescLeft"> </td><td class="mdescRight">The dialog has a separator bar above its buttons. <a href="#ab8aec40cb36275b0d38cad8f0c251515"></a><br/></td></tr>
125
<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>
126
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
127
Static Public Member Functions</h2></td></tr>
128
<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>
129
<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>
130
<tr><td colspan="2"><h2><a name="pro-methods"></a>
131
Protected Member Functions</h2></td></tr>
132
<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>
133
<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>
134
<tr><td colspan="2"><h2><a name="related"></a>
135
Related Functions</h2></td></tr>
136
<tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr>
137
<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>
138
<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>
140
<hr/><a name="_details"></a><h2>Detailed Description</h2>
141
<div class="textblock"><p>Create popup windows. </p>
142
<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>
143
<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>
144
<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>
145
<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) and sets things u...">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 Gtk::ResponseType enum. If a dialog receives a delete event, the "response" signal will be emitted with a response id of Gtk::RESPONSE_NONE.</p>
146
<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>
147
</div><hr/><h2>Constructor & Destructor Documentation</h2>
148
<a class="anchor" id="a20ecf1401f15179073406bda2b766946"></a><!-- doxytag: member="Gtk::Dialog::~Dialog" ref="a20ecf1401f15179073406bda2b766946" args="()" -->
149
<div class="memitem">
150
<div class="memproto">
151
<table class="memname">
153
<td class="memname">virtual Gtk::Dialog::~Dialog </td>
155
<td class="paramname"></td><td>)</td>
156
<td><code> [virtual]</code></td>
164
<a class="anchor" id="a7e746e77abaa67ccdc920ca97ad9b06e"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="a7e746e77abaa67ccdc920ca97ad9b06e" args="()" -->
165
<div class="memitem">
166
<div class="memproto">
167
<table class="memname">
169
<td class="memname">Gtk::Dialog::Dialog </td>
171
<td class="paramname"></td><td>)</td>
180
<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)" -->
181
<div class="memitem">
182
<div class="memproto">
183
<table class="memname">
185
<td class="memname">Gtk::Dialog::Dialog </td>
187
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
188
<td class="paramname"><em>title</em>, </td>
191
<td class="paramkey"></td>
193
<td class="paramtype">bool </td>
194
<td class="paramname"><em>modal</em> = <code>false</code>, </td>
197
<td class="paramkey"></td>
199
<td class="paramtype">bool </td>
200
<td class="paramname"><em>use_separator</em> = <code>false</code> </td>
205
<td></td><td><code> [explicit]</code></td>
213
<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)" -->
214
<div class="memitem">
215
<div class="memproto">
216
<table class="memname">
218
<td class="memname">Gtk::Dialog::Dialog </td>
220
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
221
<td class="paramname"><em>title</em>, </td>
224
<td class="paramkey"></td>
226
<td class="paramtype"><a class="el" href="classGtk_1_1Window.html">Gtk::Window</a>& </td>
227
<td class="paramname"><em>parent</em>, </td>
230
<td class="paramkey"></td>
232
<td class="paramtype">bool </td>
233
<td class="paramname"><em>modal</em> = <code>false</code>, </td>
236
<td class="paramkey"></td>
238
<td class="paramtype">bool </td>
239
<td class="paramname"><em>use_separator</em> = <code>false</code> </td>
252
<hr/><h2>Member Function Documentation</h2>
253
<a class="anchor" id="a096c1736344266e316dd31bbd5c43e19"></a><!-- doxytag: member="Gtk::Dialog::add_action_widget" ref="a096c1736344266e316dd31bbd5c43e19" args="(Widget &child, int response_id)" -->
254
<div class="memitem">
255
<div class="memproto">
256
<table class="memname">
258
<td class="memname">void Gtk::Dialog::add_action_widget </td>
260
<td class="paramtype"><a class="el" href="classGtk_1_1Widget.html">Widget</a>& </td>
261
<td class="paramname"><em>child</em>, </td>
264
<td class="paramkey"></td>
266
<td class="paramtype">int </td>
267
<td class="paramname"><em>response_id</em> </td>
278
<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>
279
<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>
280
<dl><dt><b>Parameters:</b></dt><dd>
281
<table class="params">
282
<tr><td class="paramname">child</td><td>An activatable widget. </td></tr>
283
<tr><td class="paramname">response_id</td><td>Response ID for <em>child</em>. </td></tr>
290
<a class="anchor" id="aca037e133ab2a91c646f23b7b17afb9b"></a><!-- doxytag: member="Gtk::Dialog::add_button" ref="aca037e133ab2a91c646f23b7b17afb9b" args="(const Glib::ustring &button_text, int response_id)" -->
291
<div class="memitem">
292
<div class="memproto">
293
<table class="memname">
295
<td class="memname"><a class="el" href="classGtk_1_1Button.html">Button</a>* Gtk::Dialog::add_button </td>
297
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
298
<td class="paramname"><em>button_text</em>, </td>
301
<td class="paramkey"></td>
303
<td class="paramtype">int </td>
304
<td class="paramname"><em>response_id</em> </td>
315
<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>
316
<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>
317
<dl><dt><b>Parameters:</b></dt><dd>
318
<table class="params">
319
<tr><td class="paramname">button_text</td><td>Text of button, or stock ID. </td></tr>
320
<tr><td class="paramname">response_id</td><td>Response ID for the button. </td></tr>
324
<dl class="return"><dt><b>Returns:</b></dt><dd>The button widget that was added. </dd></dl>
328
<a class="anchor" id="ac2a99c5d26c1022c2d259448f5f179a7"></a><!-- doxytag: member="Gtk::Dialog::add_button" ref="ac2a99c5d26c1022c2d259448f5f179a7" args="(const Gtk::StockID &stock_id, int response_id)" -->
329
<div class="memitem">
330
<div class="memproto">
331
<table class="memname">
333
<td class="memname"><a class="el" href="classGtk_1_1Button.html">Button</a>* Gtk::Dialog::add_button </td>
335
<td class="paramtype">const <a class="el" href="classGtk_1_1StockID.html">Gtk::StockID</a>& </td>
336
<td class="paramname"><em>stock_id</em>, </td>
339
<td class="paramkey"></td>
341
<td class="paramtype">int </td>
342
<td class="paramname"><em>response_id</em> </td>
353
<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>
354
<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>
355
<dl><dt><b>Parameters:</b></dt><dd>
356
<table class="params">
357
<tr><td class="paramname">button_text</td><td>Text of button, or stock ID. </td></tr>
358
<tr><td class="paramname">response_id</td><td>Response ID for the button. </td></tr>
362
<dl class="return"><dt><b>Returns:</b></dt><dd>The button widget that was added. </dd></dl>
366
<a class="anchor" id="ada94684e77582514fcf9062585c64824"></a><!-- doxytag: member="Gtk::Dialog::alternative_button_order" ref="ada94684e77582514fcf9062585c64824" args="(const Glib::RefPtr< const Gdk::Screen > &screen)" -->
367
<div class="memitem">
368
<div class="memproto">
369
<table class="memname">
371
<td class="memname">static bool Gtk::Dialog::alternative_button_order </td>
373
<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>
374
<td class="paramname"><em>screen</em></td><td>)</td>
375
<td><code> [static]</code></td>
381
<p>Returns <code>true</code> if dialogs are expected to use an alternative button order on the screen <em>screen</em>. </p>
382
<p>See Gtk::Dialog::set_alternative_button_order() for more details about alternative button order.</p>
383
<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>
384
<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>
385
<dl><dt><b>Parameters:</b></dt><dd>
386
<table class="params">
387
<tr><td class="paramname">screen</td><td>A <a class="el" href="classGdk_1_1Screen.html" title="Object representing a physical screen Gdk::Screen objects are the GDK representation of a physical sc...">Gdk::Screen</a>, or <code>0</code> to use the default screen. </td></tr>
391
<dl class="return"><dt><b>Returns:</b></dt><dd>Whether the alternative button order should be used. </dd></dl>
395
<a class="anchor" id="ae329b0fb53552267a5846e428fa1c84f"></a><!-- doxytag: member="Gtk::Dialog::construct_" ref="ae329b0fb53552267a5846e428fa1c84f" args="(bool modal, bool use_separator)" -->
396
<div class="memitem">
397
<div class="memproto">
398
<table class="memname">
400
<td class="memname">void Gtk::Dialog::construct_ </td>
402
<td class="paramtype">bool </td>
403
<td class="paramname"><em>modal</em>, </td>
406
<td class="paramkey"></td>
408
<td class="paramtype">bool </td>
409
<td class="paramname"><em>use_separator</em> </td>
414
<td></td><td><code> [protected]</code></td>
422
<a class="anchor" id="ae56668b63a4f134c7135e98b74f2acab"></a><!-- doxytag: member="Gtk::Dialog::get_action_area" ref="ae56668b63a4f134c7135e98b74f2acab" args="()" -->
423
<div class="memitem">
424
<div class="memproto">
425
<table class="memname">
427
<td class="memname"><a class="el" href="classGtk_1_1ButtonBox.html">ButtonBox</a>* Gtk::Dialog::get_action_area </td>
429
<td class="paramname"></td><td>)</td>
436
<p>Returns the action area of <em>dialog</em>. </p>
437
<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>
438
<dl class="return"><dt><b>Returns:</b></dt><dd>The action area. </dd></dl>
440
<p>Reimplemented in <a class="el" href="classGtk_1_1FileSelection.html#a3eb51f01b118c49574a7915c3fbeca47">Gtk::FileSelection</a>.</p>
444
<a class="anchor" id="ae16b393cc1e6b11bab611f8aa5e694fb"></a><!-- doxytag: member="Gtk::Dialog::get_action_area" ref="ae16b393cc1e6b11bab611f8aa5e694fb" args="() const " -->
445
<div class="memitem">
446
<div class="memproto">
447
<table class="memname">
449
<td class="memname">const <a class="el" href="classGtk_1_1ButtonBox.html">ButtonBox</a>* Gtk::Dialog::get_action_area </td>
451
<td class="paramname"></td><td>)</td>
458
<p>Returns the action area of <em>dialog</em>. </p>
459
<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>
460
<dl class="return"><dt><b>Returns:</b></dt><dd>The action area. </dd></dl>
462
<p>Reimplemented in <a class="el" href="classGtk_1_1FileSelection.html#ac6569b3ae5884837df55cdd654ca52d3">Gtk::FileSelection</a>.</p>
466
<a class="anchor" id="a15197791803d5fcb49134e3c56e04ee1"></a><!-- doxytag: member="Gtk::Dialog::get_has_separator" ref="a15197791803d5fcb49134e3c56e04ee1" args="() const " -->
467
<div class="memitem">
468
<div class="memproto">
469
<table class="memname">
471
<td class="memname">bool Gtk::Dialog::get_has_separator </td>
473
<td class="paramname"></td><td>)</td>
480
<p>Accessor for whether the dialog has a separator. </p>
481
<p>Deprecated: 2.22: This function will be removed in GTK+ 3 </p>
482
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the dialog has a separator. </dd></dl>
486
<a class="anchor" id="a1340388130eede2edf63404c0e27f79d"></a><!-- doxytag: member="Gtk::Dialog::get_response_for_widget" ref="a1340388130eede2edf63404c0e27f79d" args="(const Gtk::Widget &widget) const " -->
487
<div class="memitem">
488
<div class="memproto">
489
<table class="memname">
491
<td class="memname">int Gtk::Dialog::get_response_for_widget </td>
493
<td class="paramtype">const <a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>& </td>
494
<td class="paramname"><em>widget</em></td><td>)</td>
501
<p>Gets the response id of a widget in the action area of a dialog. </p>
502
<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>
503
<dl><dt><b>Parameters:</b></dt><dd>
504
<table class="params">
505
<tr><td class="paramname">widget</td><td>A widget in the action area of <em>dialog</em>. </td></tr>
509
<dl class="return"><dt><b>Returns:</b></dt><dd>The response id of <em>widget</em>, or Gtk::RESPONSE_NONE if <em>widget</em> doesn't have a response id set. </dd></dl>
513
<a class="anchor" id="a44e309c56deb37a92d2df1458cd859b1"></a><!-- doxytag: member="Gtk::Dialog::get_vbox" ref="a44e309c56deb37a92d2df1458cd859b1" args="() const " -->
514
<div class="memitem">
515
<div class="memproto">
516
<table class="memname">
518
<td class="memname">const <a class="el" href="classGtk_1_1VBox.html">VBox</a>* Gtk::Dialog::get_vbox </td>
520
<td class="paramname"></td><td>)</td>
527
<p>Returns the content area of <em>dialog</em>. </p>
528
<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>
529
<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>
533
<a class="anchor" id="ab667999656d5cdf5729d57d6eea879ce"></a><!-- doxytag: member="Gtk::Dialog::get_vbox" ref="ab667999656d5cdf5729d57d6eea879ce" args="()" -->
534
<div class="memitem">
535
<div class="memproto">
536
<table class="memname">
538
<td class="memname"><a class="el" href="classGtk_1_1VBox.html">VBox</a>* Gtk::Dialog::get_vbox </td>
540
<td class="paramname"></td><td>)</td>
547
<p>Returns the content area of <em>dialog</em>. </p>
548
<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>
549
<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>
553
<a class="anchor" id="af259947b29ba1dc093bc1d112400c03c"></a><!-- doxytag: member="Gtk::Dialog::get_widget_for_response" ref="af259947b29ba1dc093bc1d112400c03c" args="(int response_id)" -->
554
<div class="memitem">
555
<div class="memproto">
556
<table class="memname">
558
<td class="memname"><a class="el" href="classGtk_1_1Widget.html">Widget</a>* Gtk::Dialog::get_widget_for_response </td>
560
<td class="paramtype">int </td>
561
<td class="paramname"><em>response_id</em></td><td>)</td>
568
<p>Gets the widget button that uses the given response ID in the action area of a dialog. </p>
569
<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>
570
<dl><dt><b>Parameters:</b></dt><dd>
571
<table class="params">
572
<tr><td class="paramname">response_id</td><td>The response ID used by the <em>dialog</em> widget. </td></tr>
576
<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>
580
<a class="anchor" id="a9b5ed8769cb9d318ea376aabdd373376"></a><!-- doxytag: member="Gtk::Dialog::get_widget_for_response" ref="a9b5ed8769cb9d318ea376aabdd373376" args="(int response_id) const " -->
581
<div class="memitem">
582
<div class="memproto">
583
<table class="memname">
585
<td class="memname">const <a class="el" href="classGtk_1_1Widget.html">Widget</a>* Gtk::Dialog::get_widget_for_response </td>
587
<td class="paramtype">int </td>
588
<td class="paramname"><em>response_id</em></td><td>)</td>
595
<p>Gets the widget button that uses the given response ID in the action area of a dialog. </p>
596
<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>
597
<dl><dt><b>Parameters:</b></dt><dd>
598
<table class="params">
599
<tr><td class="paramname">response_id</td><td>The response ID used by the <em>dialog</em> widget. </td></tr>
603
<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>
607
<a class="anchor" id="a534ffd24e55400a26aef733a7f588856"></a><!-- doxytag: member="Gtk::Dialog::gobj" ref="a534ffd24e55400a26aef733a7f588856" args="() const " -->
608
<div class="memitem">
609
<div class="memproto">
610
<table class="memname">
612
<td class="memname">const GtkDialog* Gtk::Dialog::gobj </td>
614
<td class="paramname"></td><td>)</td>
615
<td> const<code> [inline]</code></td>
621
<p>Provides access to the underlying C GtkObject. </p>
623
<p>Reimplemented from <a class="el" href="classGtk_1_1Window.html#afe314a1e65505be026688060dc98ad3a">Gtk::Window</a>.</p>
625
<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>
629
<a class="anchor" id="aa3e8f3bdac15fac61128dc47c22ba4cd"></a><!-- doxytag: member="Gtk::Dialog::gobj" ref="aa3e8f3bdac15fac61128dc47c22ba4cd" args="()" -->
630
<div class="memitem">
631
<div class="memproto">
632
<table class="memname">
634
<td class="memname">GtkDialog* Gtk::Dialog::gobj </td>
636
<td class="paramname"></td><td>)</td>
637
<td><code> [inline]</code></td>
643
<p>Provides access to the underlying C GtkObject. </p>
645
<p>Reimplemented from <a class="el" href="classGtk_1_1Window.html#a467102527550b51eb4036390caeedb5c">Gtk::Window</a>.</p>
647
<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>
651
<a class="anchor" id="a9d3aab6c3ea727acab2af375e9ad3479"></a><!-- doxytag: member="Gtk::Dialog::on_response" ref="a9d3aab6c3ea727acab2af375e9ad3479" args="(int response_id)" -->
652
<div class="memitem">
653
<div class="memproto">
654
<table class="memname">
656
<td class="memname">virtual void Gtk::Dialog::on_response </td>
658
<td class="paramtype">int </td>
659
<td class="paramname"><em>response_id</em></td><td>)</td>
660
<td><code> [protected, virtual]</code></td>
668
<a class="anchor" id="a9213b6718a78d180c7f1c77cd30b1b26"></a><!-- doxytag: member="Gtk::Dialog::property_has_separator" ref="a9213b6718a78d180c7f1c77cd30b1b26" args="()" -->
669
<div class="memitem">
670
<div class="memproto">
671
<table class="memname">
673
<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>
675
<td class="paramname"></td><td>)</td>
682
<p>The dialog has a separator bar above its buttons. </p>
683
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
684
<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>
688
<a class="anchor" id="ab8aec40cb36275b0d38cad8f0c251515"></a><!-- doxytag: member="Gtk::Dialog::property_has_separator" ref="ab8aec40cb36275b0d38cad8f0c251515" args="() const " -->
689
<div class="memitem">
690
<div class="memproto">
691
<table class="memname">
693
<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>
695
<td class="paramname"></td><td>)</td>
702
<p>The dialog has a separator bar above its buttons. </p>
703
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
704
<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>
708
<a class="anchor" id="a7cf451db55cadc3509f360f70d0e0ecb"></a><!-- doxytag: member="Gtk::Dialog::response" ref="a7cf451db55cadc3509f360f70d0e0ecb" args="(int response_id)" -->
709
<div class="memitem">
710
<div class="memproto">
711
<table class="memname">
713
<td class="memname">void Gtk::Dialog::response </td>
715
<td class="paramtype">int </td>
716
<td class="paramname"><em>response_id</em></td><td>)</td>
723
<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>
724
<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>
725
<dl><dt><b>Parameters:</b></dt><dd>
726
<table class="params">
727
<tr><td class="paramname">response_id</td><td>Response ID. </td></tr>
734
<a class="anchor" id="adc98a1e747613c9b6cb66c238f6f8da6"></a><!-- doxytag: member="Gtk::Dialog::run" ref="adc98a1e747613c9b6cb66c238f6f8da6" args="()" -->
735
<div class="memitem">
736
<div class="memproto">
737
<table class="memname">
739
<td class="memname">int Gtk::Dialog::run </td>
741
<td class="paramname"></td><td>)</td>
748
<p>Blocks in a recursive main loop until the <em>dialog</em> emits the response signal. </p>
749
<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>
750
<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 Gtk::RESPONSE_DELETE_EVENT. 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>
751
<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>
752
<p>Typical usage of this function might be: <informalexample><programlisting> int result = dialog.run(); switch (result) { case Gtk::RESPONSE_ACCEPT: do_application_specific_something(); break; default: do_nothing_since_dialog_was_cancelled(); break; } </programlisting></informalexample> </p>
753
<dl class="return"><dt><b>Returns:</b></dt><dd>Response ID. </dd></dl>
757
<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)" -->
758
<div class="memitem">
759
<div class="memproto">
760
<table class="memname">
762
<td class="memname">void Gtk::Dialog::set_alternative_button_order_from_array </td>
764
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>< int > & </td>
765
<td class="paramname"><em>new_order</em></td><td>)</td>
772
<p>Sets an alternative button order. </p>
773
<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>
774
<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>
775
<p>Use this function after adding all the buttons to your dialog</p>
776
<dl><dt><b>Parameters:</b></dt><dd>
777
<table class="params">
778
<tr><td class="paramname">new_order</td><td>an array of response ids of the dialog's buttons.</td></tr>
785
<a class="anchor" id="a9a042edc1a83ae5d670305635d193fea"></a><!-- doxytag: member="Gtk::Dialog::set_default_response" ref="a9a042edc1a83ae5d670305635d193fea" args="(int response_id)" -->
786
<div class="memitem">
787
<div class="memproto">
788
<table class="memname">
790
<td class="memname">void Gtk::Dialog::set_default_response </td>
792
<td class="paramtype">int </td>
793
<td class="paramname"><em>response_id</em></td><td>)</td>
800
<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>
801
<p>Pressing "Enter" normally activates the default widget. </p>
802
<dl><dt><b>Parameters:</b></dt><dd>
803
<table class="params">
804
<tr><td class="paramname">response_id</td><td>A response ID. </td></tr>
811
<a class="anchor" id="ac39df2f1035a441047d48c94d72315c6"></a><!-- doxytag: member="Gtk::Dialog::set_has_separator" ref="ac39df2f1035a441047d48c94d72315c6" args="(bool setting=true)" -->
812
<div class="memitem">
813
<div class="memproto">
814
<table class="memname">
816
<td class="memname">void Gtk::Dialog::set_has_separator </td>
818
<td class="paramtype">bool </td>
819
<td class="paramname"><em>setting</em> = <code>true</code></td><td>)</td>
826
<p>Sets whether the dialog has a separator above the buttons. </p>
827
<p>Deprecated: 2.22: This function will be removed in GTK+ 3 </p>
828
<dl><dt><b>Parameters:</b></dt><dd>
829
<table class="params">
830
<tr><td class="paramname">setting</td><td><code>true</code> to have a separator. </td></tr>
837
<a class="anchor" id="a04da02d509bf9c759a15cdb1dc544a5d"></a><!-- doxytag: member="Gtk::Dialog::set_response_sensitive" ref="a04da02d509bf9c759a15cdb1dc544a5d" args="(int response_id, bool setting=true)" -->
838
<div class="memitem">
839
<div class="memproto">
840
<table class="memname">
842
<td class="memname">void Gtk::Dialog::set_response_sensitive </td>
844
<td class="paramtype">int </td>
845
<td class="paramname"><em>response_id</em>, </td>
848
<td class="paramkey"></td>
850
<td class="paramtype">bool </td>
851
<td class="paramname"><em>setting</em> = <code>true</code> </td>
862
<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>
863
<p>A convenient way to sensitize/desensitize dialog buttons. </p>
864
<dl><dt><b>Parameters:</b></dt><dd>
865
<table class="params">
866
<tr><td class="paramname">response_id</td><td>A response ID. </td></tr>
867
<tr><td class="paramname">setting</td><td><code>true</code> for sensitive. </td></tr>
874
<a class="anchor" id="a813b36a938805498073e887b29126359"></a><!-- doxytag: member="Gtk::Dialog::signal_response" ref="a813b36a938805498073e887b29126359" args="()" -->
875
<div class="memitem">
876
<div class="memproto">
877
<table class="memname">
879
<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>
881
<td class="paramname"></td><td>)</td>
887
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_response(int response_id)</code> </dd></dl>
891
<hr/><h2>Friends And Related Function Documentation</h2>
892
<a class="anchor" id="a1f0f3f2840498099a768a81eafdca8f7"></a><!-- doxytag: member="Gtk::Dialog::wrap" ref="a1f0f3f2840498099a768a81eafdca8f7" args="(GtkDialog *object, bool take_copy=false)" -->
893
<div class="memitem">
894
<div class="memproto">
895
<table class="memname">
897
<td class="memname"><a class="el" href="classGtk_1_1Dialog.html">Gtk::Dialog</a>* wrap </td>
899
<td class="paramtype">GtkDialog * </td>
900
<td class="paramname"><em>object</em>, </td>
903
<td class="paramkey"></td>
905
<td class="paramtype">bool </td>
906
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
911
<td></td><td><code> [related]</code></td>
917
<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
918
<dl><dt><b>Parameters:</b></dt><dd>
919
<table class="params">
920
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
921
<tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr>
925
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
929
<hr/>The documentation for this class was generated from the following file:<ul>
930
<li>gtkmm/dialog.h</li>
933
<hr class="footer"/><address class="footer"><small>Generated on Fri Jul 8 2011 13:31:45 for gtkmm by 
934
<a href="http://www.doxygen.org/index.html">
935
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
added
removed
share/doc/gtkmm-2.4/reference/html/classGtk_1_1Dialog.html
