~ubuntu-branches/ubuntu/karmic/gtkmm2.4/karmic

« back to all changes in this revision

Viewing changes to docs/reference/html/classGtk_1_1Dialog.html

  • Committer: Bazaar Package Importer
  • Author(s): Robert Ancell
  • Date: 2009-09-22 10:14:59 UTC
  • mfrom: (1.2.42 upstream)
  • Revision ID: james.westby@ubuntu.com-20090922101459-pespb00fbm1mlqbd
Tags: 1:2.18.1-0ubuntu1
* New upstream release: (LP: #434355)
  - RecentManager: Undeprecate get_default().
  - Clipboard: wait_for_targets): Fix a crash.
  - Window: Added set_icon_name().
  - Require a recent pangomm.
  - Style: Fix a compiler error with the Intel C++ compiler.
  - Fix recently-introduced problems with disable-deprecated options.
* debian/control.in:
  - Bump libpangomm-1.4-dev depends and build-depends

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
 
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
 
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">
 
3
<head>
 
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
3
5
<title>gtkmm: Gtk::Dialog Class Reference</title>
4
 
<link href="tabs.css" rel="stylesheet" type="text/css">
5
 
<link href="doxygen.css" rel="stylesheet" type="text/css">
6
 
</head><body>
7
 
<!-- Generated by Doxygen 1.5.8 -->
 
6
<link href="tabs.css" rel="stylesheet" type="text/css"/>
 
7
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
 
8
</head>
 
9
<body>
 
10
<!-- Generated by Doxygen 1.6.1 -->
8
11
<div class="navigation" id="top">
9
12
  <div class="tabs">
10
13
    <ul>
27
30
  </div>
28
31
</div>
29
32
<div class="contents">
30
 
<h1>Gtk::Dialog Class Reference<br>
 
33
<h1>Gtk::Dialog Class Reference<br/>
31
34
<small>
32
35
[<a class="el" href="group__Dialogs.html">Dialogs</a>]</small>
33
 
</h1><!-- doxytag: class="Gtk::Dialog" --><!-- doxytag: inherits="Gtk::Window" -->Create popup windows. <a href="#_details">More...</a>
34
 
<p>
35
 
Inherits <a class="el" href="classGtk_1_1Window.html">Gtk::Window</a>.
36
 
<p>
37
 
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>.
38
 
<p>
 
36
</h1><!-- doxytag: class="Gtk::Dialog" --><!-- doxytag: inherits="Gtk::Window" -->
 
37
<p>Create popup windows. <a href="#_details">More...</a></p>
 
38
 
 
39
<p>Inherits <a class="el" href="classGtk_1_1Window.html">Gtk::Window</a>.</p>
 
40
 
 
41
<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>
39
42
<div class="dynheader">
40
43
Collaboration diagram for Gtk::Dialog:</div>
41
44
<div class="dynsection">
42
 
<p><center><img src="classGtk_1_1Dialog__coll__graph.png" border="0" usemap="#Gtk_1_1Dialog__coll__map" alt="Collaboration graph"></center>
43
 
<map name="Gtk_1_1Dialog__coll__map">
44
 
<area shape="rect" href="classGtk_1_1Window.html" title="Toplevel Window This represents all widgets which are physical windows controlled..." alt="" coords="143,573,239,600"><area shape="rect" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="63,483,132,509"><area shape="rect" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="37,392,141,419"><area shape="rect" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)." alt="" coords="44,315,135,341"><area shape="rect" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non&#45;widget objects such..." alt="" coords="5,237,93,264"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="8,160,99,187"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="64,83,184,109"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="123,160,227,187"><area shape="rect" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="71,5,177,32"><area shape="rect" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="117,237,237,264"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html" title="Glib::RefPtr\&lt; AccelGroup \&gt;" alt="" coords="167,483,348,509"><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html" title="Glib::RefPtr\&lt; T_CppObject \&gt;" alt="" coords="165,392,355,419"></map>
45
 
<center><font size="2">[<a href="graph_legend.html">legend</a>]</font></center></div>
46
 
 
47
 
<p>
48
 
<a href="classGtk_1_1Dialog-members.html">List of all members.</a><table border="0" cellpadding="0" cellspacing="0">
49
 
<tr><td></td></tr>
50
 
<tr><td colspan="2"><br><h2>Public Member Functions</h2></td></tr>
51
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#20ecf1401f15179073406bda2b766946">~Dialog</a> ()</td></tr>
52
 
 
53
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">GtkDialog*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a3e8f3bdac15fac61128dc47c22ba4cd">gobj</a> ()</td></tr>
54
 
 
55
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a3e8f3bdac15fac61128dc47c22ba4cd"></a><br></td></tr>
56
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">const GtkDialog*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#534ffd24e55400a26aef733a7f588856">gobj</a> () const </td></tr>
57
 
 
58
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#534ffd24e55400a26aef733a7f588856"></a><br></td></tr>
59
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#7e746e77abaa67ccdc920ca97ad9b06e">Dialog</a> ()</td></tr>
60
 
 
61
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#36b72560ec3c1cd2f3ecce7eae0439d6">Dialog</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; title, bool modal=false, bool use_separator=false)</td></tr>
62
 
 
63
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#74ae53f24af2a2449c5add35fb6dc40b">Dialog</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; title, <a class="el" href="classGtk_1_1Window.html">Gtk::Window</a>&amp; parent, bool modal=false, bool use_separator=false)</td></tr>
64
 
 
65
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#096c1736344266e316dd31bbd5c43e19">add_action_widget</a> (<a class="el" href="classGtk_1_1Widget.html">Widget</a>&amp; child, int response_id)</td></tr>
66
 
 
67
 
<tr><td class="mdescLeft">&#160;</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#7cf451db55cadc3509f360f70d0e0ecb" 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="#096c1736344266e316dd31bbd5c43e19"></a><br></td></tr>
68
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1Button.html">Button</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ca037e133ab2a91c646f23b7b17afb9b">add_button</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; button_text, int response_id)</td></tr>
69
 
 
70
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Adds a button with the given text (or a stock button, if <em>button_text</em> is a stock ID) and sets things up so that clicking the button will emit the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb" 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="#ca037e133ab2a91c646f23b7b17afb9b"></a><br></td></tr>
71
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1Button.html">Button</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#c2a99c5d26c1022c2d259448f5f179a7">add_button</a> (const <a class="el" href="classGtk_1_1StockID.html">Gtk::StockID</a>&amp; stock_id, int response_id)</td></tr>
72
 
 
73
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Adds a button with the given text (or a stock button, if <em>button_text</em> is a stock ID) and sets things up so that clicking the button will emit the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb" 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="#c2a99c5d26c1022c2d259448f5f179a7"></a><br></td></tr>
74
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#04da02d509bf9c759a15cdb1dc544a5d">set_response_sensitive</a> (int response_id, bool setting=true)</td></tr>
75
 
 
76
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Calls &lt;literal&gt;gtk_widget_set_sensitive (widget, <em>setting</em>)&lt;/literal&gt; for each widget in the dialog's action area with the given <em>response_id</em>. <a href="#04da02d509bf9c759a15cdb1dc544a5d"></a><br></td></tr>
77
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#9a042edc1a83ae5d670305635d193fea">set_default_response</a> (int response_id)</td></tr>
78
 
 
79
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the last widget in the dialog's action area with the given <em>response_id</em> as the default widget for the dialog. <a href="#9a042edc1a83ae5d670305635d193fea"></a><br></td></tr>
80
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#1340388130eede2edf63404c0e27f79d">get_response_for_widget</a> (const <a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>&amp; widget) const </td></tr>
81
 
 
82
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Gets the response id of a widget in the action area of a dialog. <a href="#1340388130eede2edf63404c0e27f79d"></a><br></td></tr>
83
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#c39df2f1035a441047d48c94d72315c6">set_has_separator</a> (bool setting=true)</td></tr>
84
 
 
85
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets whether the dialog has a separator above the buttons. <a href="#c39df2f1035a441047d48c94d72315c6"></a><br></td></tr>
86
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#15197791803d5fcb49134e3c56e04ee1">get_has_separator</a> () const </td></tr>
87
 
 
88
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Accessor for whether the dialog has a separator. <a href="#15197791803d5fcb49134e3c56e04ee1"></a><br></td></tr>
89
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ae3b78426fbdd620c5a46166ba664146">set_alternative_button_order_from_array</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>&lt; int &gt;&amp; new_order)</td></tr>
90
 
 
91
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets an alternative button order. <a href="#ae3b78426fbdd620c5a46166ba664146"></a><br></td></tr>
92
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb">response</a> (int response_id)</td></tr>
93
 
 
94
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Emits the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response</a> signal with the given response ID. <a href="#7cf451db55cadc3509f360f70d0e0ecb"></a><br></td></tr>
95
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6">run</a> ()</td></tr>
96
 
 
97
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Blocks in a recursive main loop until the <em>dialog</em> emits the response signal. <a href="#dc98a1e747613c9b6cb66c238f6f8da6"></a><br></td></tr>
98
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1HButtonBox.html">HButtonBox</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#83564d23506990686d996abc8b5350d9">get_action_area</a> ()</td></tr>
99
 
 
100
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: the action area. <a href="#83564d23506990686d996abc8b5350d9"></a><br></td></tr>
101
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classGtk_1_1HButtonBox.html">HButtonBox</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#3b0d222d04a2d413dc11f78c0dfd7cff">get_action_area</a> () const </td></tr>
102
 
 
103
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: the action area. <a href="#3b0d222d04a2d413dc11f78c0dfd7cff"></a><br></td></tr>
104
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1VBox.html">VBox</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#b667999656d5cdf5729d57d6eea879ce">get_vbox</a> ()</td></tr>
105
 
 
106
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: the content area <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>. <a href="#b667999656d5cdf5729d57d6eea879ce"></a><br></td></tr>
107
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">const <a class="el" href="classGtk_1_1VBox.html">VBox</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#44e309c56deb37a92d2df1458cd859b1">get_vbox</a> () const </td></tr>
108
 
 
109
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: the content area <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>. <a href="#44e309c56deb37a92d2df1458cd859b1"></a><br></td></tr>
110
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>&lt; bool &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#9213b6718a78d180c7f1c77cd30b1b26">property_has_separator</a> ()</td></tr>
111
 
 
112
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">The dialog has a separator bar above its buttons. <a href="#9213b6718a78d180c7f1c77cd30b1b26"></a><br></td></tr>
113
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak">
114
 
&lt; bool &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#b8aec40cb36275b0d38cad8f0c251515">property_has_separator</a> () const </td></tr>
115
 
 
116
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">The dialog has a separator bar above its buttons. <a href="#b8aec40cb36275b0d38cad8f0c251515"></a><br></td></tr>
117
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>&lt; void, int &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#813b36a938805498073e887b29126359">signal_response</a> ()</td></tr>
118
 
 
119
 
<tr><td colspan="2"><br><h2>Static Public Member Functions</h2></td></tr>
120
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">static bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#da94684e77582514fcf9062585c64824">alternative_button_order</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; const <a class="el" href="classGdk_1_1Screen.html">Gdk::Screen</a> &gt;&amp; screen)</td></tr>
121
 
 
122
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: Whether the alternative button order should be used. <a href="#da94684e77582514fcf9062585c64824"></a><br></td></tr>
123
 
<tr><td colspan="2"><br><h2>Protected Member Functions</h2></td></tr>
124
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#9d3aab6c3ea727acab2af375e9ad3479">on_response</a> (int response_id)</td></tr>
125
 
 
126
 
<tr><td class="memItemLeft" nowrap align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#e329b0fb53552267a5846e428fa1c84f">construct_</a> (bool modal, bool use_separator)</td></tr>
127
 
 
128
 
<tr><td colspan="2"><br><h2>Related Functions</h2></td></tr>
129
 
<tr><td colspan="2">(Note that these are not member functions.) <br><br></td></tr>
130
 
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="classGtk_1_1Dialog.html">Gtk::Dialog</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#1f0f3f2840498099a768a81eafdca8f7">wrap</a> (GtkDialog* object, bool take_copy=false)</td></tr>
131
 
 
132
 
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#1f0f3f2840498099a768a81eafdca8f7"></a><br></td></tr>
 
45
<div class="center"><img src="classGtk_1_1Dialog__coll__graph.png" border="0" usemap="#Gtk_1_1Dialog_coll__map" alt="Collaboration graph"/></div>
 
46
<map name="Gtk_1_1Dialog_coll__map" id="Gtk_1_1Dialog_coll__map">
 
47
<area shape="rect" href="classGtk_1_1Window.html" title="Toplevel Window This represents all widgets which are physical windows controlled..." alt="" coords="143,573,239,600"/><area shape="rect" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="63,483,132,509"/><area shape="rect" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="37,392,141,419"/><area shape="rect" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)." alt="" coords="44,315,135,341"/><area shape="rect" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non&#45;widget objects such..." alt="" coords="5,237,93,264"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="8,160,99,187"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="64,83,184,109"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="123,160,227,187"/><area shape="rect" doxygen="libsigc++-2.0.tag:http://library.gnome.org/devel/libsigc++/unstable/" href="http://library.gnome.org/devel/libsigc++/unstable/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="71,5,177,32"/><area shape="rect" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="117,237,237,264"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html" title="Glib::RefPtr\&lt; AccelGroup \&gt;" alt="" coords="167,483,348,509"/><area shape="rect" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html" title="Glib::RefPtr\&lt; T_CppObject \&gt;" alt="" coords="165,392,355,419"/></map>
 
48
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
 
49
 
 
50
<p><a href="classGtk_1_1Dialog-members.html">List of all members.</a></p>
 
51
<table border="0" cellpadding="0" cellspacing="0">
 
52
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
 
53
<tr><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a20ecf1401f15179073406bda2b766946">~Dialog</a> ()</td></tr>
 
54
<tr><td class="memItemLeft" align="right" valign="top">GtkDialog*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#aa3e8f3bdac15fac61128dc47c22ba4cd">gobj</a> ()</td></tr>
 
55
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#aa3e8f3bdac15fac61128dc47c22ba4cd"></a><br/></td></tr>
 
56
<tr><td class="memItemLeft" align="right" valign="top">const GtkDialog*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a534ffd24e55400a26aef733a7f588856">gobj</a> () const </td></tr>
 
57
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a534ffd24e55400a26aef733a7f588856"></a><br/></td></tr>
 
58
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a7e746e77abaa67ccdc920ca97ad9b06e">Dialog</a> ()</td></tr>
 
59
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a36b72560ec3c1cd2f3ecce7eae0439d6">Dialog</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; title, bool modal=false, bool use_separator=false)</td></tr>
 
60
<tr><td class="memItemLeft" align="right" valign="top">&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a74ae53f24af2a2449c5add35fb6dc40b">Dialog</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; title, <a class="el" href="classGtk_1_1Window.html">Gtk::Window</a>&amp; parent, bool modal=false, bool use_separator=false)</td></tr>
 
61
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</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>&amp; child, int response_id)</td></tr>
 
62
<tr><td class="mdescLeft">&#160;</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>
 
63
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Button.html">Button</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#aca037e133ab2a91c646f23b7b17afb9b">add_button</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ustring.html">Glib::ustring</a>&amp; button_text, int response_id)</td></tr>
 
64
<tr><td class="mdescLeft">&#160;</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>
 
65
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Button.html">Button</a>*&#160;</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>&amp; stock_id, int response_id)</td></tr>
 
66
<tr><td class="mdescLeft">&#160;</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>
 
67
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</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>
 
68
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Calls &lt;literal&gt;gtk_widget_set_sensitive (widget, <em>setting</em>)&lt;/literal&gt; for each widget in the dialog's action area with the given <em>response_id</em>. <a href="#a04da02d509bf9c759a15cdb1dc544a5d"></a><br/></td></tr>
 
69
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a9a042edc1a83ae5d670305635d193fea">set_default_response</a> (int response_id)</td></tr>
 
70
<tr><td class="mdescLeft">&#160;</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>
 
71
<tr><td class="memItemLeft" align="right" valign="top">int&#160;</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>&amp; widget) const </td></tr>
 
72
<tr><td class="mdescLeft">&#160;</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>
 
73
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ac39df2f1035a441047d48c94d72315c6">set_has_separator</a> (bool setting=true)</td></tr>
 
74
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets whether the dialog has a separator above the buttons. <a href="#ac39df2f1035a441047d48c94d72315c6"></a><br/></td></tr>
 
75
<tr><td class="memItemLeft" align="right" valign="top">bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a15197791803d5fcb49134e3c56e04ee1">get_has_separator</a> () const </td></tr>
 
76
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Accessor for whether the dialog has a separator. <a href="#a15197791803d5fcb49134e3c56e04ee1"></a><br/></td></tr>
 
77
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</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" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>&lt; int &gt;&amp; new_order)</td></tr>
 
78
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets an alternative button order. <a href="#aae3b78426fbdd620c5a46166ba664146"></a><br/></td></tr>
 
79
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a7cf451db55cadc3509f360f70d0e0ecb">response</a> (int response_id)</td></tr>
 
80
<tr><td class="mdescLeft">&#160;</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>
 
81
<tr><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#adc98a1e747613c9b6cb66c238f6f8da6">run</a> ()</td></tr>
 
82
<tr><td class="mdescLeft">&#160;</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>
 
83
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1HButtonBox.html">HButtonBox</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a83564d23506990686d996abc8b5350d9">get_action_area</a> ()</td></tr>
 
84
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: the action area. <a href="#a83564d23506990686d996abc8b5350d9"></a><br/></td></tr>
 
85
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classGtk_1_1HButtonBox.html">HButtonBox</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a3b0d222d04a2d413dc11f78c0dfd7cff">get_action_area</a> () const </td></tr>
 
86
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: the action area. <a href="#a3b0d222d04a2d413dc11f78c0dfd7cff"></a><br/></td></tr>
 
87
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1VBox.html">VBox</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ab667999656d5cdf5729d57d6eea879ce">get_vbox</a> ()</td></tr>
 
88
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: the content area <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>. <a href="#ab667999656d5cdf5729d57d6eea879ce"></a><br/></td></tr>
 
89
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classGtk_1_1VBox.html">VBox</a>*&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a44e309c56deb37a92d2df1458cd859b1">get_vbox</a> () const </td></tr>
 
90
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: the content area <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>. <a href="#a44e309c56deb37a92d2df1458cd859b1"></a><br/></td></tr>
 
91
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>&lt; bool &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a9213b6718a78d180c7f1c77cd30b1b26">property_has_separator</a> ()</td></tr>
 
92
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">The dialog has a separator bar above its buttons. <a href="#a9213b6718a78d180c7f1c77cd30b1b26"></a><br/></td></tr>
 
93
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><br class="typebreak"/>
 
94
&lt; bool &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ab8aec40cb36275b0d38cad8f0c251515">property_has_separator</a> () const </td></tr>
 
95
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">The dialog has a separator bar above its buttons. <a href="#ab8aec40cb36275b0d38cad8f0c251515"></a><br/></td></tr>
 
96
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>&lt; void, int &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a813b36a938805498073e887b29126359">signal_response</a> ()</td></tr>
 
97
<tr><td colspan="2"><h2>Static Public Member Functions</h2></td></tr>
 
98
<tr><td class="memItemLeft" align="right" valign="top">static bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ada94684e77582514fcf9062585c64824">alternative_button_order</a> (const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; const <a class="el" href="classGdk_1_1Screen.html">Gdk::Screen</a> &gt;&amp; screen)</td></tr>
 
99
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">Returns: Whether the alternative button order should be used. <a href="#ada94684e77582514fcf9062585c64824"></a><br/></td></tr>
 
100
<tr><td colspan="2"><h2>Protected Member Functions</h2></td></tr>
 
101
<tr><td class="memItemLeft" align="right" valign="top">virtual void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#a9d3aab6c3ea727acab2af375e9ad3479">on_response</a> (int response_id)</td></tr>
 
102
<tr><td class="memItemLeft" align="right" valign="top">void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Dialog.html#ae329b0fb53552267a5846e428fa1c84f">construct_</a> (bool modal, bool use_separator)</td></tr>
 
103
<tr><td colspan="2"><h2>Related Functions</h2></td></tr>
 
104
<tr><td colspan="2"><p>(Note that these are not member functions.) </p>
 
105
<br/><br/></td></tr>
 
106
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Dialog.html">Gtk::Dialog</a>*&#160;</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>
 
107
<tr><td class="mdescLeft">&#160;</td><td class="mdescRight">A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a1f0f3f2840498099a768a81eafdca8f7"></a><br/></td></tr>
133
108
</table>
134
 
<hr><a name="_details"></a><h2>Detailed Description</h2>
135
 
Create popup windows. <p>
136
 
<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>
137
 
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>
138
 
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>
139
 
When adding buttons using <a class="el" href="classGtk_1_1Dialog.html#ca037e133ab2a91c646f23b7b17afb9b" 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#813b36a938805498073e887b29126359">signal_response()</a> with a "response id" you specified. You are encouraged to use the <a class="el" href="group__gtkmmEnums.html#g407d25a7b827dbdb685077de442e9b38">Gtk::ResponseType</a> enum. If a dialog receives a delete event, the "response" signal will be emitted with a response id of <a class="el" href="group__gtkmmEnums.html#gg407d25a7b827dbdb685077de442e9b385dfe7c858a12744d418471de12a8b6a8">Gtk::RESPONSE_NONE</a>.<p>
140
 
If you want to block waiting for a dialog to return before returning control flow to your code, you can call <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6" 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. <hr><h2>Constructor&amp; Destructor Documentation</h2>
141
 
<a class="anchor" name="20ecf1401f15179073406bda2b766946"></a><!-- doxytag: member="Gtk::Dialog::~Dialog" ref="20ecf1401f15179073406bda2b766946" args="()" -->
 
109
<hr/><a name="_details"></a><h2>Detailed Description</h2>
 
110
<p>Create popup windows. </p>
 
111
<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>
 
112
<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>
 
113
<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>
 
114
<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>
 
115
<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>
 
116
<hr/><h2>Constructor &amp; Destructor Documentation</h2>
 
117
<a class="anchor" id="a20ecf1401f15179073406bda2b766946"></a><!-- doxytag: member="Gtk::Dialog::~Dialog" ref="a20ecf1401f15179073406bda2b766946" args="()" -->
142
118
<div class="memitem">
143
119
<div class="memproto">
144
120
      <table class="memname">
145
121
        <tr>
146
122
          <td class="memname">virtual Gtk::Dialog::~Dialog </td>
147
123
          <td>(</td>
148
 
          <td class="paramname"> </td>
 
124
          <td class="paramname"></td>
149
125
          <td>&#160;)&#160;</td>
150
126
          <td><code> [virtual]</code></td>
151
127
        </tr>
153
129
</div>
154
130
<div class="memdoc">
155
131
 
156
 
<p>
157
 
 
158
 
</div>
159
 
</div><p>
160
 
<a class="anchor" name="7e746e77abaa67ccdc920ca97ad9b06e"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="7e746e77abaa67ccdc920ca97ad9b06e" args="()" -->
 
132
</div>
 
133
</div>
 
134
<a class="anchor" id="a7e746e77abaa67ccdc920ca97ad9b06e"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="a7e746e77abaa67ccdc920ca97ad9b06e" args="()" -->
161
135
<div class="memitem">
162
136
<div class="memproto">
163
137
      <table class="memname">
164
138
        <tr>
165
139
          <td class="memname">Gtk::Dialog::Dialog </td>
166
140
          <td>(</td>
167
 
          <td class="paramname"> </td>
 
141
          <td class="paramname"></td>
168
142
          <td>&#160;)&#160;</td>
169
143
          <td></td>
170
144
        </tr>
172
146
</div>
173
147
<div class="memdoc">
174
148
 
175
 
<p>
176
 
 
177
 
</div>
178
 
</div><p>
179
 
<a class="anchor" name="36b72560ec3c1cd2f3ecce7eae0439d6"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="36b72560ec3c1cd2f3ecce7eae0439d6" args="(const Glib::ustring &amp;title, bool modal=false, bool use_separator=false)" -->
 
149
</div>
 
150
</div>
 
151
<a class="anchor" id="a36b72560ec3c1cd2f3ecce7eae0439d6"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="a36b72560ec3c1cd2f3ecce7eae0439d6" args="(const Glib::ustring &amp;title, bool modal=false, bool use_separator=false)" -->
180
152
<div class="memitem">
181
153
<div class="memproto">
182
154
      <table class="memname">
207
179
</div>
208
180
<div class="memdoc">
209
181
 
210
 
<p>
211
 
 
212
 
</div>
213
 
</div><p>
214
 
<a class="anchor" name="74ae53f24af2a2449c5add35fb6dc40b"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="74ae53f24af2a2449c5add35fb6dc40b" args="(const Glib::ustring &amp;title, Gtk::Window &amp;parent, bool modal=false, bool use_separator=false)" -->
 
182
</div>
 
183
</div>
 
184
<a class="anchor" id="a74ae53f24af2a2449c5add35fb6dc40b"></a><!-- doxytag: member="Gtk::Dialog::Dialog" ref="a74ae53f24af2a2449c5add35fb6dc40b" args="(const Glib::ustring &amp;title, Gtk::Window &amp;parent, bool modal=false, bool use_separator=false)" -->
215
185
<div class="memitem">
216
186
<div class="memproto">
217
187
      <table class="memname">
248
218
</div>
249
219
<div class="memdoc">
250
220
 
251
 
<p>
252
 
 
253
 
</div>
254
 
</div><p>
255
 
<hr><h2>Member Function Documentation</h2>
256
 
<a class="anchor" name="096c1736344266e316dd31bbd5c43e19"></a><!-- doxytag: member="Gtk::Dialog::add_action_widget" ref="096c1736344266e316dd31bbd5c43e19" args="(Widget &amp;child, int response_id)" -->
 
221
</div>
 
222
</div>
 
223
<hr/><h2>Member Function Documentation</h2>
 
224
<a class="anchor" id="a096c1736344266e316dd31bbd5c43e19"></a><!-- doxytag: member="Gtk::Dialog::add_action_widget" ref="a096c1736344266e316dd31bbd5c43e19" args="(Widget &amp;child, int response_id)" -->
257
225
<div class="memitem">
258
226
<div class="memproto">
259
227
      <table class="memname">
278
246
</div>
279
247
<div class="memdoc">
280
248
 
281
 
<p>
282
 
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#7cf451db55cadc3509f360f70d0e0ecb" 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>
283
 
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. <dl compact><dt><b>Parameters:</b></dt><dd>
 
249
<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>
 
250
<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>
 
251
<dl><dt><b>Parameters:</b></dt><dd>
284
252
  <table border="0" cellspacing="2" cellpadding="0">
285
253
    <tr><td valign="top"></td><td valign="top"><em>child</em>&#160;</td><td>An activatable widget. </td></tr>
286
254
    <tr><td valign="top"></td><td valign="top"><em>response_id</em>&#160;</td><td>Response ID for <em>child</em>. </td></tr>
287
255
  </table>
 
256
  </dd>
288
257
</dl>
289
258
 
290
259
</div>
291
 
</div><p>
292
 
<a class="anchor" name="c2a99c5d26c1022c2d259448f5f179a7"></a><!-- doxytag: member="Gtk::Dialog::add_button" ref="c2a99c5d26c1022c2d259448f5f179a7" args="(const Gtk::StockID &amp;stock_id, int response_id)" -->
 
260
</div>
 
261
<a class="anchor" id="ac2a99c5d26c1022c2d259448f5f179a7"></a><!-- doxytag: member="Gtk::Dialog::add_button" ref="ac2a99c5d26c1022c2d259448f5f179a7" args="(const Gtk::StockID &amp;stock_id, int response_id)" -->
293
262
<div class="memitem">
294
263
<div class="memproto">
295
264
      <table class="memname">
314
283
</div>
315
284
<div class="memdoc">
316
285
 
317
 
<p>
318
 
Adds a button with the given text (or a stock button, if <em>button_text</em> is a stock ID) and sets things up so that clicking the button will emit the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb" 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>
319
 
The button is appended to the end of the dialog's action area. The button widget is returned, but usually you don't need it. <dl compact><dt><b>Parameters:</b></dt><dd>
 
286
<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>
 
287
<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>
 
288
<dl><dt><b>Parameters:</b></dt><dd>
320
289
  <table border="0" cellspacing="2" cellpadding="0">
321
290
    <tr><td valign="top"></td><td valign="top"><em>button_text</em>&#160;</td><td>Text of button, or stock ID. </td></tr>
322
291
    <tr><td valign="top"></td><td valign="top"><em>response_id</em>&#160;</td><td>Response ID for the button. </td></tr>
323
292
  </table>
 
293
  </dd>
324
294
</dl>
325
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The button widget that was added. </dd></dl>
 
295
<dl class="return"><dt><b>Returns:</b></dt><dd>The button widget that was added. </dd></dl>
326
296
 
327
297
</div>
328
 
</div><p>
329
 
<a class="anchor" name="ca037e133ab2a91c646f23b7b17afb9b"></a><!-- doxytag: member="Gtk::Dialog::add_button" ref="ca037e133ab2a91c646f23b7b17afb9b" args="(const Glib::ustring &amp;button_text, int response_id)" -->
 
298
</div>
 
299
<a class="anchor" id="aca037e133ab2a91c646f23b7b17afb9b"></a><!-- doxytag: member="Gtk::Dialog::add_button" ref="aca037e133ab2a91c646f23b7b17afb9b" args="(const Glib::ustring &amp;button_text, int response_id)" -->
330
300
<div class="memitem">
331
301
<div class="memproto">
332
302
      <table class="memname">
351
321
</div>
352
322
<div class="memdoc">
353
323
 
354
 
<p>
355
 
Adds a button with the given text (or a stock button, if <em>button_text</em> is a stock ID) and sets things up so that clicking the button will emit the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb" 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>
356
 
The button is appended to the end of the dialog's action area. The button widget is returned, but usually you don't need it. <dl compact><dt><b>Parameters:</b></dt><dd>
 
324
<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>
 
325
<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>
 
326
<dl><dt><b>Parameters:</b></dt><dd>
357
327
  <table border="0" cellspacing="2" cellpadding="0">
358
328
    <tr><td valign="top"></td><td valign="top"><em>button_text</em>&#160;</td><td>Text of button, or stock ID. </td></tr>
359
329
    <tr><td valign="top"></td><td valign="top"><em>response_id</em>&#160;</td><td>Response ID for the button. </td></tr>
360
330
  </table>
 
331
  </dd>
361
332
</dl>
362
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The button widget that was added. </dd></dl>
 
333
<dl class="return"><dt><b>Returns:</b></dt><dd>The button widget that was added. </dd></dl>
363
334
 
364
335
</div>
365
 
</div><p>
366
 
<a class="anchor" name="da94684e77582514fcf9062585c64824"></a><!-- doxytag: member="Gtk::Dialog::alternative_button_order" ref="da94684e77582514fcf9062585c64824" args="(const Glib::RefPtr&lt; const Gdk::Screen &gt; &amp;screen)" -->
 
336
</div>
 
337
<a class="anchor" id="ada94684e77582514fcf9062585c64824"></a><!-- doxytag: member="Gtk::Dialog::alternative_button_order" ref="ada94684e77582514fcf9062585c64824" args="(const Glib::RefPtr&lt; const Gdk::Screen &gt; &amp;screen)" -->
367
338
<div class="memitem">
368
339
<div class="memproto">
369
340
      <table class="memname">
371
342
          <td class="memname">static bool Gtk::Dialog::alternative_button_order </td>
372
343
          <td>(</td>
373
344
          <td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1RefPtr.html">Glib::RefPtr</a>&lt; const <a class="el" href="classGdk_1_1Screen.html">Gdk::Screen</a> &gt;&amp;&#160;</td>
374
 
          <td class="paramname"> <em>screen</em> </td>
 
345
          <td class="paramname"> <em>screen</em></td>
375
346
          <td>&#160;)&#160;</td>
376
347
          <td><code> [static]</code></td>
377
348
        </tr>
379
350
</div>
380
351
<div class="memdoc">
381
352
 
382
 
<p>
383
 
Returns: Whether the alternative button order should be used. <p>
384
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
353
<p>Returns: Whether the alternative button order should be used. </p>
 
354
<dl><dt><b>Parameters:</b></dt><dd>
385
355
  <table border="0" cellspacing="2" cellpadding="0">
386
356
    <tr><td valign="top"></td><td valign="top"><em>screen</em>&#160;</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>
387
357
  </table>
 
358
  </dd>
388
359
</dl>
389
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>Whether the alternative button order should be used</dd></dl>
390
 
<dl compact><dt><b><a class="el" href="since_2_6.html#_since_2_6000070">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
 
360
<dl class="return"><dt><b>Returns:</b></dt><dd>Whether the alternative button order should be used</dd></dl>
 
361
<dl class="since_2_6"><dt><b><a class="el" href="since_2_6.html#_since_2_6000069">Since gtkmm 2.6:</a></b></dt><dd></dd></dl>
391
362
 
392
363
</div>
393
 
</div><p>
394
 
<a class="anchor" name="e329b0fb53552267a5846e428fa1c84f"></a><!-- doxytag: member="Gtk::Dialog::construct_" ref="e329b0fb53552267a5846e428fa1c84f" args="(bool modal, bool use_separator)" -->
 
364
</div>
 
365
<a class="anchor" id="ae329b0fb53552267a5846e428fa1c84f"></a><!-- doxytag: member="Gtk::Dialog::construct_" ref="ae329b0fb53552267a5846e428fa1c84f" args="(bool modal, bool use_separator)" -->
395
366
<div class="memitem">
396
367
<div class="memproto">
397
368
      <table class="memname">
416
387
</div>
417
388
<div class="memdoc">
418
389
 
419
 
<p>
420
 
 
421
 
</div>
422
 
</div><p>
423
 
<a class="anchor" name="3b0d222d04a2d413dc11f78c0dfd7cff"></a><!-- doxytag: member="Gtk::Dialog::get_action_area" ref="3b0d222d04a2d413dc11f78c0dfd7cff" args="() const " -->
 
390
</div>
 
391
</div>
 
392
<a class="anchor" id="a3b0d222d04a2d413dc11f78c0dfd7cff"></a><!-- doxytag: member="Gtk::Dialog::get_action_area" ref="a3b0d222d04a2d413dc11f78c0dfd7cff" args="() const " -->
424
393
<div class="memitem">
425
394
<div class="memproto">
426
395
      <table class="memname">
427
396
        <tr>
428
397
          <td class="memname">const <a class="el" href="classGtk_1_1HButtonBox.html">HButtonBox</a>* Gtk::Dialog::get_action_area </td>
429
398
          <td>(</td>
430
 
          <td class="paramname"> </td>
 
399
          <td class="paramname"></td>
431
400
          <td>&#160;)&#160;</td>
432
401
          <td> const</td>
433
402
        </tr>
435
404
</div>
436
405
<div class="memdoc">
437
406
 
438
 
<p>
439
 
Returns: the action area. <p>
440
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The action area.</dd></dl>
441
 
<dl compact><dt><b><a class="el" href="since_2_14.html#_since_2_14000045">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
442
 
 
443
 
<p>Reimplemented in <a class="el" href="classGtk_1_1FileSelection.html#c6569b3ae5884837df55cdd654ca52d3">Gtk::FileSelection</a>.</p>
444
 
 
445
 
</div>
446
 
</div><p>
447
 
<a class="anchor" name="83564d23506990686d996abc8b5350d9"></a><!-- doxytag: member="Gtk::Dialog::get_action_area" ref="83564d23506990686d996abc8b5350d9" args="()" -->
 
407
<p>Returns: the action area. </p>
 
408
<dl class="return"><dt><b>Returns:</b></dt><dd>The action area.</dd></dl>
 
409
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000045">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
 
410
 
 
411
<p>Reimplemented in <a class="el" href="classGtk_1_1FileSelection.html#ac6569b3ae5884837df55cdd654ca52d3">Gtk::FileSelection</a>.</p>
 
412
 
 
413
</div>
 
414
</div>
 
415
<a class="anchor" id="a83564d23506990686d996abc8b5350d9"></a><!-- doxytag: member="Gtk::Dialog::get_action_area" ref="a83564d23506990686d996abc8b5350d9" args="()" -->
448
416
<div class="memitem">
449
417
<div class="memproto">
450
418
      <table class="memname">
451
419
        <tr>
452
420
          <td class="memname"><a class="el" href="classGtk_1_1HButtonBox.html">HButtonBox</a>* Gtk::Dialog::get_action_area </td>
453
421
          <td>(</td>
454
 
          <td class="paramname"> </td>
 
422
          <td class="paramname"></td>
455
423
          <td>&#160;)&#160;</td>
456
424
          <td></td>
457
425
        </tr>
459
427
</div>
460
428
<div class="memdoc">
461
429
 
462
 
<p>
463
 
Returns: the action area. <p>
464
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The action area.</dd></dl>
465
 
<dl compact><dt><b><a class="el" href="since_2_14.html#_since_2_14000044">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
466
 
 
467
 
<p>Reimplemented in <a class="el" href="classGtk_1_1FileSelection.html#3eb51f01b118c49574a7915c3fbeca47">Gtk::FileSelection</a>.</p>
468
 
 
469
 
</div>
470
 
</div><p>
471
 
<a class="anchor" name="15197791803d5fcb49134e3c56e04ee1"></a><!-- doxytag: member="Gtk::Dialog::get_has_separator" ref="15197791803d5fcb49134e3c56e04ee1" args="() const " -->
 
430
<p>Returns: the action area. </p>
 
431
<dl class="return"><dt><b>Returns:</b></dt><dd>The action area.</dd></dl>
 
432
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000044">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
 
433
 
 
434
<p>Reimplemented in <a class="el" href="classGtk_1_1FileSelection.html#a3eb51f01b118c49574a7915c3fbeca47">Gtk::FileSelection</a>.</p>
 
435
 
 
436
</div>
 
437
</div>
 
438
<a class="anchor" id="a15197791803d5fcb49134e3c56e04ee1"></a><!-- doxytag: member="Gtk::Dialog::get_has_separator" ref="a15197791803d5fcb49134e3c56e04ee1" args="() const " -->
472
439
<div class="memitem">
473
440
<div class="memproto">
474
441
      <table class="memname">
475
442
        <tr>
476
443
          <td class="memname">bool Gtk::Dialog::get_has_separator </td>
477
444
          <td>(</td>
478
 
          <td class="paramname"> </td>
 
445
          <td class="paramname"></td>
479
446
          <td>&#160;)&#160;</td>
480
447
          <td> const</td>
481
448
        </tr>
483
450
</div>
484
451
<div class="memdoc">
485
452
 
486
 
<p>
487
 
Accessor for whether the dialog has a separator. <p>
488
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd><code>true</code> if the dialog has a separator. </dd></dl>
 
453
<p>Accessor for whether the dialog has a separator. </p>
 
454
<dl class="return"><dt><b>Returns:</b></dt><dd><code>true</code> if the dialog has a separator. </dd></dl>
489
455
 
490
456
</div>
491
 
</div><p>
492
 
<a class="anchor" name="1340388130eede2edf63404c0e27f79d"></a><!-- doxytag: member="Gtk::Dialog::get_response_for_widget" ref="1340388130eede2edf63404c0e27f79d" args="(const Gtk::Widget &amp;widget) const " -->
 
457
</div>
 
458
<a class="anchor" id="a1340388130eede2edf63404c0e27f79d"></a><!-- doxytag: member="Gtk::Dialog::get_response_for_widget" ref="a1340388130eede2edf63404c0e27f79d" args="(const Gtk::Widget &amp;widget) const " -->
493
459
<div class="memitem">
494
460
<div class="memproto">
495
461
      <table class="memname">
497
463
          <td class="memname">int Gtk::Dialog::get_response_for_widget </td>
498
464
          <td>(</td>
499
465
          <td class="paramtype">const <a class="el" href="classGtk_1_1Widget.html">Gtk::Widget</a>&amp;&#160;</td>
500
 
          <td class="paramname"> <em>widget</em> </td>
 
466
          <td class="paramname"> <em>widget</em></td>
501
467
          <td>&#160;)&#160;</td>
502
468
          <td> const</td>
503
469
        </tr>
505
471
</div>
506
472
<div class="memdoc">
507
473
 
508
 
<p>
509
 
Gets the response id of a widget in the action area of a dialog. <p>
510
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
474
<p>Gets the response id of a widget in the action area of a dialog. </p>
 
475
<dl><dt><b>Parameters:</b></dt><dd>
511
476
  <table border="0" cellspacing="2" cellpadding="0">
512
477
    <tr><td valign="top"></td><td valign="top"><em>widget</em>&#160;</td><td>A widget in the action area of <em>dialog</em>. </td></tr>
513
478
  </table>
 
479
  </dd>
514
480
</dl>
515
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The response id of <em>widget</em>, or <a class="el" href="group__gtkmmEnums.html#gg407d25a7b827dbdb685077de442e9b385dfe7c858a12744d418471de12a8b6a8">Gtk::RESPONSE_NONE</a> if <em>widget</em> doesn't have a response id set.</dd></dl>
516
 
<dl compact><dt><b><a class="el" href="since_2_8.html#_since_2_8000012">Since gtkmm 2.8:</a></b></dt><dd></dd></dl>
 
481
<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>
 
482
<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>
517
483
 
518
484
</div>
519
 
</div><p>
520
 
<a class="anchor" name="44e309c56deb37a92d2df1458cd859b1"></a><!-- doxytag: member="Gtk::Dialog::get_vbox" ref="44e309c56deb37a92d2df1458cd859b1" args="() const " -->
 
485
</div>
 
486
<a class="anchor" id="a44e309c56deb37a92d2df1458cd859b1"></a><!-- doxytag: member="Gtk::Dialog::get_vbox" ref="a44e309c56deb37a92d2df1458cd859b1" args="() const " -->
521
487
<div class="memitem">
522
488
<div class="memproto">
523
489
      <table class="memname">
524
490
        <tr>
525
491
          <td class="memname">const <a class="el" href="classGtk_1_1VBox.html">VBox</a>* Gtk::Dialog::get_vbox </td>
526
492
          <td>(</td>
527
 
          <td class="paramname"> </td>
 
493
          <td class="paramname"></td>
528
494
          <td>&#160;)&#160;</td>
529
495
          <td> const</td>
530
496
        </tr>
532
498
</div>
533
499
<div class="memdoc">
534
500
 
535
 
<p>
536
 
Returns: the content area <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>. <p>
537
 
<dl class="return" compact><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>
538
 
<dl compact><dt><b><a class="el" href="since_2_14.html#_since_2_14000047">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
 
501
<p>Returns: the content area <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>. </p>
 
502
<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>
 
503
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000047">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
539
504
 
540
505
</div>
541
 
</div><p>
542
 
<a class="anchor" name="b667999656d5cdf5729d57d6eea879ce"></a><!-- doxytag: member="Gtk::Dialog::get_vbox" ref="b667999656d5cdf5729d57d6eea879ce" args="()" -->
 
506
</div>
 
507
<a class="anchor" id="ab667999656d5cdf5729d57d6eea879ce"></a><!-- doxytag: member="Gtk::Dialog::get_vbox" ref="ab667999656d5cdf5729d57d6eea879ce" args="()" -->
543
508
<div class="memitem">
544
509
<div class="memproto">
545
510
      <table class="memname">
546
511
        <tr>
547
512
          <td class="memname"><a class="el" href="classGtk_1_1VBox.html">VBox</a>* Gtk::Dialog::get_vbox </td>
548
513
          <td>(</td>
549
 
          <td class="paramname"> </td>
 
514
          <td class="paramname"></td>
550
515
          <td>&#160;)&#160;</td>
551
516
          <td></td>
552
517
        </tr>
554
519
</div>
555
520
<div class="memdoc">
556
521
 
557
 
<p>
558
 
Returns: the content area <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>. <p>
559
 
<dl class="return" compact><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>
560
 
<dl compact><dt><b><a class="el" href="since_2_14.html#_since_2_14000046">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
 
522
<p>Returns: the content area <a class="el" href="classGtk_1_1VBox.html" title="Vertical Box for laying widgets in a vertical row.">Gtk::VBox</a>. </p>
 
523
<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>
 
524
<dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000046">Since gtkmm 2.14:</a></b></dt><dd></dd></dl>
561
525
 
562
526
</div>
563
 
</div><p>
564
 
<a class="anchor" name="534ffd24e55400a26aef733a7f588856"></a><!-- doxytag: member="Gtk::Dialog::gobj" ref="534ffd24e55400a26aef733a7f588856" args="() const " -->
 
527
</div>
 
528
<a class="anchor" id="a534ffd24e55400a26aef733a7f588856"></a><!-- doxytag: member="Gtk::Dialog::gobj" ref="a534ffd24e55400a26aef733a7f588856" args="() const " -->
565
529
<div class="memitem">
566
530
<div class="memproto">
567
531
      <table class="memname">
568
532
        <tr>
569
533
          <td class="memname">const GtkDialog* Gtk::Dialog::gobj </td>
570
534
          <td>(</td>
571
 
          <td class="paramname"> </td>
 
535
          <td class="paramname"></td>
572
536
          <td>&#160;)&#160;</td>
573
537
          <td> const<code> [inline]</code></td>
574
538
        </tr>
576
540
</div>
577
541
<div class="memdoc">
578
542
 
579
 
<p>
580
 
Provides access to the underlying C GtkObject. <p>
581
 
 
582
 
<p>Reimplemented from <a class="el" href="classGtk_1_1Window.html#fe314a1e65505be026688060dc98ad3a">Gtk::Window</a>.</p>
583
 
 
584
 
<p>Reimplemented in <a class="el" href="classGtk_1_1AboutDialog.html#72c054536026167d3c2b5fbb5773faff">Gtk::AboutDialog</a>, <a class="el" href="classGtk_1_1ColorSelectionDialog.html#f9859a5abd76a8f07cb7a7b151cec160">Gtk::ColorSelectionDialog</a>, <a class="el" href="classGtk_1_1FileChooserDialog.html#0e990ba2ed1af83d23126725aa0fa6bf">Gtk::FileChooserDialog</a>, <a class="el" href="classGtk_1_1FileSelection.html#c859d39ad6a48392c7b7ebba019c71be">Gtk::FileSelection</a>, <a class="el" href="classGtk_1_1FontSelectionDialog.html#b036ff001acbc16468acf1c7009026fc">Gtk::FontSelectionDialog</a>, <a class="el" href="classGtk_1_1InputDialog.html#fc77a70cbff7baced0095b03ea1b7ee0">Gtk::InputDialog</a>, <a class="el" href="classGtk_1_1MessageDialog.html#53ab4665373026c6c78782520ab3596d">Gtk::MessageDialog</a>, <a class="el" href="classGtk_1_1RecentChooserDialog.html#58dd5a2e883b2b4888a78257af12deac">Gtk::RecentChooserDialog</a>, <a class="el" href="classGtk_1_1PageSetupUnixDialog.html#ee73bd66a347d42840347afd1a747e0b">Gtk::PageSetupUnixDialog</a>, and <a class="el" href="classGtk_1_1PrintUnixDialog.html#6f350b2c32507e663c640a4217068155">Gtk::PrintUnixDialog</a>.</p>
585
 
 
586
 
</div>
587
 
</div><p>
588
 
<a class="anchor" name="a3e8f3bdac15fac61128dc47c22ba4cd"></a><!-- doxytag: member="Gtk::Dialog::gobj" ref="a3e8f3bdac15fac61128dc47c22ba4cd" args="()" -->
 
543
<p>Provides access to the underlying C GtkObject. </p>
 
544
 
 
545
<p>Reimplemented from <a class="el" href="classGtk_1_1Window.html#afe314a1e65505be026688060dc98ad3a">Gtk::Window</a>.</p>
 
546
 
 
547
<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_1InputDialog.html#afc77a70cbff7baced0095b03ea1b7ee0">Gtk::InputDialog</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>, and <a class="el" href="classGtk_1_1PrintUnixDialog.html#a6f350b2c32507e663c640a4217068155">Gtk::PrintUnixDialog</a>.</p>
 
548
 
 
549
</div>
 
550
</div>
 
551
<a class="anchor" id="aa3e8f3bdac15fac61128dc47c22ba4cd"></a><!-- doxytag: member="Gtk::Dialog::gobj" ref="aa3e8f3bdac15fac61128dc47c22ba4cd" args="()" -->
589
552
<div class="memitem">
590
553
<div class="memproto">
591
554
      <table class="memname">
592
555
        <tr>
593
556
          <td class="memname">GtkDialog* Gtk::Dialog::gobj </td>
594
557
          <td>(</td>
595
 
          <td class="paramname"> </td>
 
558
          <td class="paramname"></td>
596
559
          <td>&#160;)&#160;</td>
597
560
          <td><code> [inline]</code></td>
598
561
        </tr>
600
563
</div>
601
564
<div class="memdoc">
602
565
 
603
 
<p>
604
 
Provides access to the underlying C GtkObject. <p>
605
 
 
606
 
<p>Reimplemented from <a class="el" href="classGtk_1_1Window.html#467102527550b51eb4036390caeedb5c">Gtk::Window</a>.</p>
607
 
 
608
 
<p>Reimplemented in <a class="el" href="classGtk_1_1AboutDialog.html#154a7b18752a8770891c424aee419763">Gtk::AboutDialog</a>, <a class="el" href="classGtk_1_1ColorSelectionDialog.html#45caeb0d10a9100ddebd70beae235f89">Gtk::ColorSelectionDialog</a>, <a class="el" href="classGtk_1_1FileChooserDialog.html#8bcb702bdc16043f42481c8cebccae55">Gtk::FileChooserDialog</a>, <a class="el" href="classGtk_1_1FileSelection.html#03ebec3a61eaf4ef998efd9a4797a2cf">Gtk::FileSelection</a>, <a class="el" href="classGtk_1_1FontSelectionDialog.html#d5b39fcf3ce8f770bc2987267f46a12b">Gtk::FontSelectionDialog</a>, <a class="el" href="classGtk_1_1InputDialog.html#207e658e5dcd65c726fd626368b103c9">Gtk::InputDialog</a>, <a class="el" href="classGtk_1_1MessageDialog.html#6019fc42bcc8e891dfbcc6565939ec8e">Gtk::MessageDialog</a>, <a class="el" href="classGtk_1_1RecentChooserDialog.html#a9037355630ec732629caf279a3012cf">Gtk::RecentChooserDialog</a>, <a class="el" href="classGtk_1_1PageSetupUnixDialog.html#037e9e6f945a24d31cb2b16605eb1aab">Gtk::PageSetupUnixDialog</a>, and <a class="el" href="classGtk_1_1PrintUnixDialog.html#e8d543407e309cd6e7e67cd0aa2f82b0">Gtk::PrintUnixDialog</a>.</p>
609
 
 
610
 
</div>
611
 
</div><p>
612
 
<a class="anchor" name="9d3aab6c3ea727acab2af375e9ad3479"></a><!-- doxytag: member="Gtk::Dialog::on_response" ref="9d3aab6c3ea727acab2af375e9ad3479" args="(int response_id)" -->
 
566
<p>Provides access to the underlying C GtkObject. </p>
 
567
 
 
568
<p>Reimplemented from <a class="el" href="classGtk_1_1Window.html#a467102527550b51eb4036390caeedb5c">Gtk::Window</a>.</p>
 
569
 
 
570
<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_1InputDialog.html#a207e658e5dcd65c726fd626368b103c9">Gtk::InputDialog</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>, and <a class="el" href="classGtk_1_1PrintUnixDialog.html#ae8d543407e309cd6e7e67cd0aa2f82b0">Gtk::PrintUnixDialog</a>.</p>
 
571
 
 
572
</div>
 
573
</div>
 
574
<a class="anchor" id="a9d3aab6c3ea727acab2af375e9ad3479"></a><!-- doxytag: member="Gtk::Dialog::on_response" ref="a9d3aab6c3ea727acab2af375e9ad3479" args="(int response_id)" -->
613
575
<div class="memitem">
614
576
<div class="memproto">
615
577
      <table class="memname">
617
579
          <td class="memname">virtual void Gtk::Dialog::on_response </td>
618
580
          <td>(</td>
619
581
          <td class="paramtype">int&#160;</td>
620
 
          <td class="paramname"> <em>response_id</em> </td>
 
582
          <td class="paramname"> <em>response_id</em></td>
621
583
          <td>&#160;)&#160;</td>
622
584
          <td><code> [protected, virtual]</code></td>
623
585
        </tr>
625
587
</div>
626
588
<div class="memdoc">
627
589
 
628
 
<p>
629
 
 
630
 
</div>
631
 
</div><p>
632
 
<a class="anchor" name="b8aec40cb36275b0d38cad8f0c251515"></a><!-- doxytag: member="Gtk::Dialog::property_has_separator" ref="b8aec40cb36275b0d38cad8f0c251515" args="() const " -->
 
590
</div>
 
591
</div>
 
592
<a class="anchor" id="ab8aec40cb36275b0d38cad8f0c251515"></a><!-- doxytag: member="Gtk::Dialog::property_has_separator" ref="ab8aec40cb36275b0d38cad8f0c251515" args="() const " -->
633
593
<div class="memitem">
634
594
<div class="memproto">
635
595
      <table class="memname">
636
596
        <tr>
637
597
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a>&lt;bool&gt; Gtk::Dialog::property_has_separator </td>
638
598
          <td>(</td>
639
 
          <td class="paramname"> </td>
 
599
          <td class="paramname"></td>
640
600
          <td>&#160;)&#160;</td>
641
601
          <td> const</td>
642
602
        </tr>
644
604
</div>
645
605
<div class="memdoc">
646
606
 
647
 
<p>
648
 
The dialog has a separator bar above its buttons. <p>
649
 
You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
 
607
<p>The dialog has a separator bar above its buttons. </p>
 
608
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
 
609
<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>
650
610
 
651
611
</div>
652
 
</div><p>
653
 
<a class="anchor" name="9213b6718a78d180c7f1c77cd30b1b26"></a><!-- doxytag: member="Gtk::Dialog::property_has_separator" ref="9213b6718a78d180c7f1c77cd30b1b26" args="()" -->
 
612
</div>
 
613
<a class="anchor" id="a9213b6718a78d180c7f1c77cd30b1b26"></a><!-- doxytag: member="Gtk::Dialog::property_has_separator" ref="a9213b6718a78d180c7f1c77cd30b1b26" args="()" -->
654
614
<div class="memitem">
655
615
<div class="memproto">
656
616
      <table class="memname">
657
617
        <tr>
658
618
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>&lt;bool&gt; Gtk::Dialog::property_has_separator </td>
659
619
          <td>(</td>
660
 
          <td class="paramname"> </td>
 
620
          <td class="paramname"></td>
661
621
          <td>&#160;)&#160;</td>
662
622
          <td></td>
663
623
        </tr>
665
625
</div>
666
626
<div class="memdoc">
667
627
 
668
 
<p>
669
 
The dialog has a separator bar above its buttons. <p>
670
 
You rarely need to use properties because there are get_ and set_ methods for almost all of them. <dl class="return" compact><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl>
 
628
<p>The dialog has a separator bar above its buttons. </p>
 
629
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
 
630
<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>
671
631
 
672
632
</div>
673
 
</div><p>
674
 
<a class="anchor" name="7cf451db55cadc3509f360f70d0e0ecb"></a><!-- doxytag: member="Gtk::Dialog::response" ref="7cf451db55cadc3509f360f70d0e0ecb" args="(int response_id)" -->
 
633
</div>
 
634
<a class="anchor" id="a7cf451db55cadc3509f360f70d0e0ecb"></a><!-- doxytag: member="Gtk::Dialog::response" ref="a7cf451db55cadc3509f360f70d0e0ecb" args="(int response_id)" -->
675
635
<div class="memitem">
676
636
<div class="memproto">
677
637
      <table class="memname">
679
639
          <td class="memname">void Gtk::Dialog::response </td>
680
640
          <td>(</td>
681
641
          <td class="paramtype">int&#160;</td>
682
 
          <td class="paramname"> <em>response_id</em> </td>
 
642
          <td class="paramname"> <em>response_id</em></td>
683
643
          <td>&#160;)&#160;</td>
684
644
          <td></td>
685
645
        </tr>
687
647
</div>
688
648
<div class="memdoc">
689
649
 
690
 
<p>
691
 
Emits the <a class="el" href="classGtk_1_1Dialog.html#7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response</a> signal with the given response ID. <p>
692
 
Used to indicate that the user has responded to the dialog in some way; typically either you or <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6" 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. <dl compact><dt><b>Parameters:</b></dt><dd>
 
650
<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>
 
651
<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>
 
652
<dl><dt><b>Parameters:</b></dt><dd>
693
653
  <table border="0" cellspacing="2" cellpadding="0">
694
654
    <tr><td valign="top"></td><td valign="top"><em>response_id</em>&#160;</td><td>Response ID. </td></tr>
695
655
  </table>
 
656
  </dd>
696
657
</dl>
697
658
 
698
659
</div>
699
 
</div><p>
700
 
<a class="anchor" name="dc98a1e747613c9b6cb66c238f6f8da6"></a><!-- doxytag: member="Gtk::Dialog::run" ref="dc98a1e747613c9b6cb66c238f6f8da6" args="()" -->
 
660
</div>
 
661
<a class="anchor" id="adc98a1e747613c9b6cb66c238f6f8da6"></a><!-- doxytag: member="Gtk::Dialog::run" ref="adc98a1e747613c9b6cb66c238f6f8da6" args="()" -->
701
662
<div class="memitem">
702
663
<div class="memproto">
703
664
      <table class="memname">
704
665
        <tr>
705
666
          <td class="memname">int Gtk::Dialog::run </td>
706
667
          <td>(</td>
707
 
          <td class="paramname"> </td>
 
668
          <td class="paramname"></td>
708
669
          <td>&#160;)&#160;</td>
709
670
          <td></td>
710
671
        </tr>
712
673
</div>
713
674
<div class="memdoc">
714
675
 
715
 
<p>
716
 
Blocks in a recursive main loop until the <em>dialog</em> emits the response signal. <p>
717
 
It returns the response ID from the "response" signal emission. Before entering the recursive main loop, <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6" 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#a791d86a0bb3658e378e81d731dd0121" 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>
718
 
If the dialog receives "delete_event", <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6" 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#gg407d25a7b827dbdb685077de442e9b389d8e23d86df7d0f4096c5842dd7ad832">Gtk::RESPONSE_DELETE_EVENT</a>. Also, during <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6" 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#dc98a1e747613c9b6cb66c238f6f8da6" 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#7cf451db55cadc3509f360f70d0e0ecb" title="Emits the Gtk::Dialog::response signal with the given response ID.">Gtk::Dialog::response()</a> to emit the "response" signal.<p>
719
 
After <a class="el" href="classGtk_1_1Dialog.html#dc98a1e747613c9b6cb66c238f6f8da6" 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>
720
 
Typical usage of this function might be: <div class="fragment"><pre class="fragment"> <span class="keywordtype">int</span> result = dialog.run();
 
676
<p>Blocks in a recursive main loop until the <em>dialog</em> emits the response signal. </p>
 
677
<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>
 
678
<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>
 
679
<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>
 
680
<p>Typical usage of this function might be: </p>
 
681
<div class="fragment"><pre class="fragment"> <span class="keywordtype">int</span> result = dialog.run();
721
682
 <span class="keywordflow">switch</span> (result)
722
683
 {
723
 
 <span class="keywordflow">case</span> <a class="code" href="group__gtkmmEnums.html#gg407d25a7b827dbdb685077de442e9b38d61a3fd00662c4f7e5f9915fdcb02454">Gtk::RESPONSE_ACCEPT</a>:
 
684
 <span class="keywordflow">case</span> <a class="code" href="group__gtkmmEnums.html#gga407d25a7b827dbdb685077de442e9b38ad61a3fd00662c4f7e5f9915fdcb02454">Gtk::RESPONSE_ACCEPT</a>:
724
685
   do_application_specific_something();
725
686
   <span class="keywordflow">break</span>;
726
687
 <span class="keywordflow">default</span>:
727
688
   do_nothing_since_dialog_was_cancelled();
728
689
   <span class="keywordflow">break</span>;
729
690
 }
730
 
</pre></div> <dl class="return" compact><dt><b>Returns:</b></dt><dd>Response ID. </dd></dl>
 
691
</pre></div> <dl class="return"><dt><b>Returns:</b></dt><dd>Response ID. </dd></dl>
731
692
 
732
693
</div>
733
 
</div><p>
734
 
<a class="anchor" name="ae3b78426fbdd620c5a46166ba664146"></a><!-- doxytag: member="Gtk::Dialog::set_alternative_button_order_from_array" ref="ae3b78426fbdd620c5a46166ba664146" args="(const Glib::ArrayHandle&lt; int &gt; &amp;new_order)" -->
 
694
</div>
 
695
<a class="anchor" id="aae3b78426fbdd620c5a46166ba664146"></a><!-- doxytag: member="Gtk::Dialog::set_alternative_button_order_from_array" ref="aae3b78426fbdd620c5a46166ba664146" args="(const Glib::ArrayHandle&lt; int &gt; &amp;new_order)" -->
735
696
<div class="memitem">
736
697
<div class="memproto">
737
698
      <table class="memname">
739
700
          <td class="memname">void Gtk::Dialog::set_alternative_button_order_from_array </td>
740
701
          <td>(</td>
741
702
          <td class="paramtype">const <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1ArrayHandle.html">Glib::ArrayHandle</a>&lt; int &gt; &amp;&#160;</td>
742
 
          <td class="paramname"> <em>new_order</em> </td>
 
703
          <td class="paramname"> <em>new_order</em></td>
743
704
          <td>&#160;)&#160;</td>
744
705
          <td></td>
745
706
        </tr>
747
708
</div>
748
709
<div class="memdoc">
749
710
 
750
 
<p>
751
 
Sets an alternative button order. <p>
752
 
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>
753
 
By default, GTK+ dialogs use the button order advocated by the Gnome &lt;ulink url="http://developer.gnome.org/projects/gup/hig/2.0/"&gt;Human Interface Guidelines&lt;/ulink&gt; 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>
754
 
Use this function after adding all the buttons to your dialog<p>
755
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
711
<p>Sets an alternative button order. </p>
 
712
<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>
 
713
<p>By default, GTK+ dialogs use the button order advocated by the Gnome &lt;ulink url="http://developer.gnome.org/projects/gup/hig/2.0/"&gt;Human Interface Guidelines&lt;/ulink&gt; 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>
 
714
<p>Use this function after adding all the buttons to your dialog</p>
 
715
<dl><dt><b>Parameters:</b></dt><dd>
756
716
  <table border="0" cellspacing="2" cellpadding="0">
757
717
    <tr><td valign="top"></td><td valign="top"><em>new_order</em>&#160;</td><td>an array of response ids of the dialog's buttons.</td></tr>
758
718
  </table>
 
719
  </dd>
759
720
</dl>
760
721
 
761
722
</div>
762
 
</div><p>
763
 
<a class="anchor" name="9a042edc1a83ae5d670305635d193fea"></a><!-- doxytag: member="Gtk::Dialog::set_default_response" ref="9a042edc1a83ae5d670305635d193fea" args="(int response_id)" -->
 
723
</div>
 
724
<a class="anchor" id="a9a042edc1a83ae5d670305635d193fea"></a><!-- doxytag: member="Gtk::Dialog::set_default_response" ref="a9a042edc1a83ae5d670305635d193fea" args="(int response_id)" -->
764
725
<div class="memitem">
765
726
<div class="memproto">
766
727
      <table class="memname">
768
729
          <td class="memname">void Gtk::Dialog::set_default_response </td>
769
730
          <td>(</td>
770
731
          <td class="paramtype">int&#160;</td>
771
 
          <td class="paramname"> <em>response_id</em> </td>
 
732
          <td class="paramname"> <em>response_id</em></td>
772
733
          <td>&#160;)&#160;</td>
773
734
          <td></td>
774
735
        </tr>
776
737
</div>
777
738
<div class="memdoc">
778
739
 
779
 
<p>
780
 
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>
781
 
Pressing "Enter" normally activates the default widget. <dl compact><dt><b>Parameters:</b></dt><dd>
 
740
<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>
 
741
<p>Pressing "Enter" normally activates the default widget. </p>
 
742
<dl><dt><b>Parameters:</b></dt><dd>
782
743
  <table border="0" cellspacing="2" cellpadding="0">
783
744
    <tr><td valign="top"></td><td valign="top"><em>response_id</em>&#160;</td><td>A response ID. </td></tr>
784
745
  </table>
 
746
  </dd>
785
747
</dl>
786
748
 
787
749
</div>
788
 
</div><p>
789
 
<a class="anchor" name="c39df2f1035a441047d48c94d72315c6"></a><!-- doxytag: member="Gtk::Dialog::set_has_separator" ref="c39df2f1035a441047d48c94d72315c6" args="(bool setting=true)" -->
 
750
</div>
 
751
<a class="anchor" id="ac39df2f1035a441047d48c94d72315c6"></a><!-- doxytag: member="Gtk::Dialog::set_has_separator" ref="ac39df2f1035a441047d48c94d72315c6" args="(bool setting=true)" -->
790
752
<div class="memitem">
791
753
<div class="memproto">
792
754
      <table class="memname">
794
756
          <td class="memname">void Gtk::Dialog::set_has_separator </td>
795
757
          <td>(</td>
796
758
          <td class="paramtype">bool&#160;</td>
797
 
          <td class="paramname"> <em>setting</em> = <code>true</code> </td>
 
759
          <td class="paramname"> <em>setting</em> = <code>true</code></td>
798
760
          <td>&#160;)&#160;</td>
799
761
          <td></td>
800
762
        </tr>
802
764
</div>
803
765
<div class="memdoc">
804
766
 
805
 
<p>
806
 
Sets whether the dialog has a separator above the buttons. <p>
807
 
<code>true</code> by default. <dl compact><dt><b>Parameters:</b></dt><dd>
 
767
<p>Sets whether the dialog has a separator above the buttons. </p>
 
768
<p><code>true</code> by default. </p>
 
769
<dl><dt><b>Parameters:</b></dt><dd>
808
770
  <table border="0" cellspacing="2" cellpadding="0">
809
771
    <tr><td valign="top"></td><td valign="top"><em>setting</em>&#160;</td><td><code>true</code> to have a separator. </td></tr>
810
772
  </table>
 
773
  </dd>
811
774
</dl>
812
775
 
813
776
</div>
814
 
</div><p>
815
 
<a class="anchor" name="04da02d509bf9c759a15cdb1dc544a5d"></a><!-- doxytag: member="Gtk::Dialog::set_response_sensitive" ref="04da02d509bf9c759a15cdb1dc544a5d" args="(int response_id, bool setting=true)" -->
 
777
</div>
 
778
<a class="anchor" id="a04da02d509bf9c759a15cdb1dc544a5d"></a><!-- doxytag: member="Gtk::Dialog::set_response_sensitive" ref="a04da02d509bf9c759a15cdb1dc544a5d" args="(int response_id, bool setting=true)" -->
816
779
<div class="memitem">
817
780
<div class="memproto">
818
781
      <table class="memname">
837
800
</div>
838
801
<div class="memdoc">
839
802
 
840
 
<p>
841
 
Calls &lt;literal&gt;gtk_widget_set_sensitive (widget, <em>setting</em>)&lt;/literal&gt; for each widget in the dialog's action area with the given <em>response_id</em>. <p>
842
 
A convenient way to sensitize/desensitize dialog buttons. <dl compact><dt><b>Parameters:</b></dt><dd>
 
803
<p>Calls &lt;literal&gt;gtk_widget_set_sensitive (widget, <em>setting</em>)&lt;/literal&gt; for each widget in the dialog's action area with the given <em>response_id</em>. </p>
 
804
<p>A convenient way to sensitize/desensitize dialog buttons. </p>
 
805
<dl><dt><b>Parameters:</b></dt><dd>
843
806
  <table border="0" cellspacing="2" cellpadding="0">
844
807
    <tr><td valign="top"></td><td valign="top"><em>response_id</em>&#160;</td><td>A response ID. </td></tr>
845
808
    <tr><td valign="top"></td><td valign="top"><em>setting</em>&#160;</td><td><code>true</code> for sensitive. </td></tr>
846
809
  </table>
 
810
  </dd>
847
811
</dl>
848
812
 
849
813
</div>
850
 
</div><p>
851
 
<a class="anchor" name="813b36a938805498073e887b29126359"></a><!-- doxytag: member="Gtk::Dialog::signal_response" ref="813b36a938805498073e887b29126359" args="()" -->
 
814
</div>
 
815
<a class="anchor" id="a813b36a938805498073e887b29126359"></a><!-- doxytag: member="Gtk::Dialog::signal_response" ref="a813b36a938805498073e887b29126359" args="()" -->
852
816
<div class="memitem">
853
817
<div class="memproto">
854
818
      <table class="memname">
855
819
        <tr>
856
820
          <td class="memname"><a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/classGlib_1_1SignalProxy1.html">Glib::SignalProxy1</a>&lt; void,int &gt; Gtk::Dialog::signal_response </td>
857
821
          <td>(</td>
858
 
          <td class="paramname"> </td>
 
822
          <td class="paramname"></td>
859
823
          <td>&#160;)&#160;</td>
860
824
          <td></td>
861
825
        </tr>
862
826
      </table>
863
827
</div>
864
828
<div class="memdoc">
865
 
 
866
 
<p>
867
 
<dl class="user" compact><dt><b>Prototype:</b></dt><dd><code>void on_my_response(int response_id)</code> </dd></dl>
868
 
 
869
 
</div>
870
 
</div><p>
871
 
<hr><h2>Friends And Related Function Documentation</h2>
872
 
<a class="anchor" name="1f0f3f2840498099a768a81eafdca8f7"></a><!-- doxytag: member="Gtk::Dialog::wrap" ref="1f0f3f2840498099a768a81eafdca8f7" args="(GtkDialog *object, bool take_copy=false)" -->
 
829
<dl class="user"><dt><b>Prototype:</b></dt><dd><code>void on_my_response(int response_id)</code> </dd></dl>
 
830
 
 
831
</div>
 
832
</div>
 
833
<hr/><h2>Friends And Related Function Documentation</h2>
 
834
<a class="anchor" id="a1f0f3f2840498099a768a81eafdca8f7"></a><!-- doxytag: member="Gtk::Dialog::wrap" ref="a1f0f3f2840498099a768a81eafdca8f7" args="(GtkDialog *object, bool take_copy=false)" -->
873
835
<div class="memitem">
874
836
<div class="memproto">
875
837
      <table class="memname">
894
856
</div>
895
857
<div class="memdoc">
896
858
 
897
 
<p>
898
 
A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <p>
899
 
<dl compact><dt><b>Parameters:</b></dt><dd>
 
859
<p>A <a class="elRef" doxygen="glibmm-2.4.tag:http://library.gnome.org/devel/glibmm/unstable/" href="http://library.gnome.org/devel/glibmm/unstable/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
 
860
<dl><dt><b>Parameters:</b></dt><dd>
900
861
  <table border="0" cellspacing="2" cellpadding="0">
901
862
    <tr><td valign="top"></td><td valign="top"><em>object</em>&#160;</td><td>The C instance. </td></tr>
902
863
    <tr><td valign="top"></td><td valign="top"><em>take_copy</em>&#160;</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>
903
864
  </table>
 
865
  </dd>
904
866
</dl>
905
 
<dl class="return" compact><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
 
867
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
906
868
 
907
869
</div>
908
 
</div><p>
909
 
<hr>The documentation for this class was generated from the following file:<ul>
910
 
<li>gtkmm/dialog.h</ul>
911
 
</div>
912
 
<hr size="1"><address style="text-align: right;"><small>Generated on Sun Sep 6 18:45:26 2009 for gtkmm by&#160;
 
870
</div>
 
871
<hr/>The documentation for this class was generated from the following file:<ul>
 
872
<li>gtkmm/dialog.h</li>
 
873
</ul>
 
874
</div>
 
875
<hr size="1"/><address style="text-align: right;"><small>Generated on Mon Sep 21 16:34:34 2009 for gtkmm by&#160;
913
876
<a href="http://www.doxygen.org/index.html">
914
 
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
 
877
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address>
915
878
</body>
916
879
</html>