8
8
<link rel="up" href="ch07.html" title="Widgets">
9
9
<link rel="prev" href="RBCellRendererRating.html" title="RBCellRendererRating">
10
10
<link rel="next" href="RBEntryView.html" title="RBEntryView">
11
<meta name="generator" content="GTK-Doc V1.11 (XML mode)">
11
<meta name="generator" content="GTK-Doc V1.13 (XML mode)">
12
12
<link rel="stylesheet" href="style.css" type="text/css">
13
13
<link rel="chapter" href="ch01.html" title="Backends">
14
14
<link rel="chapter" href="ch02.html" title="Lib">
30
30
<tr><td colspan="5" class="shortcuts">
31
31
<a href="#rhythmbox-rb-dialog.synopsis" class="shortcut">Top</a>
33
<a href="#rhythmbox-rb-dialog.description" class="shortcut">Description</a>
33
<a href="#rhythmbox-rb-dialog.description" class="shortcut">Description</a>
36
36
<div class="refentry" title="rb-dialog">
44
44
</tr></table></div>
45
45
<div class="refsynopsisdiv" title="Synopsis">
46
46
<a name="rhythmbox-rb-dialog.synopsis"></a><h2>Synopsis</h2>
47
<pre class="synopsis">
48
void <a class="link" href="rhythmbox-rb-dialog.html#rb-error-dialog" title="rb_error_dialog ()">rb_error_dialog</a> (<a
49
href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"
50
>GtkWindow</a> *parent,
52
const char *secondary,
47
<pre class="synopsis"><span class="returnvalue">void</span> <a class="link" href="rhythmbox-rb-dialog.html#rb-error-dialog" title="rb_error_dialog ()">rb_error_dialog</a> (<a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"><span class="returnvalue">GtkWindow</span></a> *parent,
48
const <span class="returnvalue">char</span> *primary,
49
const <span class="returnvalue">char</span> *secondary,
55
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
56
>GtkWidget</a> * <a class="link" href="rhythmbox-rb-dialog.html#rb-file-chooser-new" title="rb_file_chooser_new ()">rb_file_chooser_new</a> (const char *title,
58
href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"
59
>GtkWindow</a> *parent,
61
href="http://library.gnome.org/devel/gtk/unstable/GtkFileChooser.html#GtkFileChooserAction"
62
>GtkFileChooserAction</a> action,
64
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
65
>gboolean</a> local_only);
51
<a href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * <a class="link" href="rhythmbox-rb-dialog.html#rb-file-chooser-new" title="rb_file_chooser_new ()">rb_file_chooser_new</a> (const <span class="returnvalue">char</span> *title,
52
<a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"><span class="returnvalue">GtkWindow</span></a> *parent,
53
<a href="http://library.gnome.org/devel/gtk/unstable/GtkFileChooser.html#GtkFileChooserAction"><span class="returnvalue">GtkFileChooserAction</span></a> action,
54
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> local_only);
68
57
<div class="refsect1" title="Description">
71
60
This provides a couple of shortcuts for creating dialogs. If you want
72
61
to annoy the user by displaying an error message, this is the way to do it.</p>
76
63
<div class="refsect1" title="Details">
77
64
<a name="rhythmbox-rb-dialog.details"></a><h2>Details</h2>
78
65
<div class="refsect2" title="rb_error_dialog ()">
79
66
<a name="rb-error-dialog"></a><h3>rb_error_dialog ()</h3>
80
<pre class="programlisting">void rb_error_dialog (<a
81
href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"
82
>GtkWindow</a> *parent,
84
const char *secondary,
67
<pre class="programlisting"><span class="returnvalue">void</span> rb_error_dialog (<a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"><span class="returnvalue">GtkWindow</span></a> *parent,
68
const <span class="returnvalue">char</span> *primary,
69
const <span class="returnvalue">char</span> *secondary,
87
72
Creates and displays a simple error dialog box containing a primary
93
78
Care should be taken to avoid opening multiple error dialog boxes
94
79
when a single error message (such as 'out of disk space') affects
95
80
multiple items.</p>
98
81
<div class="variablelist"><table border="0">
99
82
<col align="left" valign="top">
102
85
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
104
href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"
105
><span class="type">GtkWindow</span></a> for the dialog
86
<td> parent <a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"><span class="type">GtkWindow</span></a> for the dialog
127
108
<div class="refsect2" title="rb_file_chooser_new ()">
128
109
<a name="rb-file-chooser-new"></a><h3>rb_file_chooser_new ()</h3>
129
<pre class="programlisting"><a
130
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
131
>GtkWidget</a> * rb_file_chooser_new (const char *title,
133
href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"
134
>GtkWindow</a> *parent,
136
href="http://library.gnome.org/devel/gtk/unstable/GtkFileChooser.html#GtkFileChooserAction"
137
>GtkFileChooserAction</a> action,
139
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
140
>gboolean</a> local_only);</pre>
110
<pre class="programlisting"><a href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * rb_file_chooser_new (const <span class="returnvalue">char</span> *title,
111
<a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"><span class="returnvalue">GtkWindow</span></a> *parent,
112
<a href="http://library.gnome.org/devel/gtk/unstable/GtkFileChooser.html#GtkFileChooserAction"><span class="returnvalue">GtkFileChooserAction</span></a> action,
113
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> local_only);</pre>
142
115
Creates and shows a regular gtk+ file chooser dialog with
143
116
a given title. The user's music directory (typically ~/Music) is
150
123
After creating the dialog, the caller should connect a handler to its
151
124
'response' signal to process the user's selected files or folders.</p>
154
125
<div class="variablelist"><table border="0">
155
126
<col align="left" valign="top">
163
134
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
165
href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"
166
><span class="type">GtkWindow</span></a> for the file chooser
135
<td> parent <a href="http://library.gnome.org/devel/gtk/unstable/GtkWindow.html"><span class="type">GtkWindow</span></a> for the file chooser
170
139
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
172
href="http://library.gnome.org/devel/gtk/unstable/GtkFileChooser.html#GtkFileChooserAction"
173
><span class="type">GtkFileChooserAction</span></a>
140
<td> the <a href="http://library.gnome.org/devel/gtk/unstable/GtkFileChooser.html#GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a>
182
149
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
183
<td> the file chooser <a
184
href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"
185
><span class="type">GtkWidget</span></a>
150
<td> the file chooser <a href="http://library.gnome.org/devel/gtk/unstable/GtkWidget.html"><span class="type">GtkWidget</span></a>