/usr/share/gtk-doc/html/rhythmbox/rhythmbox-rb-dialog.html is in rhythmbox-doc 2.96-0ubuntu4.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>rb-dialog</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="Rhythmbox Development Reference Manual">
<link rel="up" href="ch07.html" title="Widgets">
<link rel="prev" href="RBCellRendererRating.html" title="RBCellRendererRating">
<link rel="next" href="RBEntryView.html" title="RBEntryView">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="RBCellRendererRating.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="ch07.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Rhythmbox Development Reference Manual</th>
<td><a accesskey="n" href="RBEntryView.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#rhythmbox-rb-dialog.synopsis" class="shortcut">Top</a>
|
<a href="#rhythmbox-rb-dialog.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="rhythmbox-rb-dialog"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="rhythmbox-rb-dialog.top_of_page"></a>rb-dialog</span></h2>
<p>rb-dialog — helper functions for creating gtk+ dialog windows</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="rhythmbox-rb-dialog.synopsis"></a><h2>Synopsis</h2>
<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> (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> *parent</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *primary</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *secondary</code></em>,
<em class="parameter"><code>...</code></em>);
<a href="/usr/share/gtk-doc/html/gtk3/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> (<em class="parameter"><code>const <span class="type">char</span> *title</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> *parent</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkFileChooser.html#GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> action</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_only</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="rhythmbox-rb-dialog.description"></a><h2>Description</h2>
<p>
This provides a couple of shortcuts for creating dialogs. If you want
to annoy the user by displaying an error message, this is the way to do it.
</p>
</div>
<div class="refsect1">
<a name="rhythmbox-rb-dialog.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="rb-error-dialog"></a><h3>rb_error_dialog ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span> rb_error_dialog (<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> *parent</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *primary</code></em>,
<em class="parameter"><code>const <span class="type">char</span> *secondary</code></em>,
<em class="parameter"><code>...</code></em>);</pre>
<p>
Creates and displays a simple error dialog box containing a primary
message in bold, larger type and a secondary message in the regular
font. Both the primary and secondary message strings should be
translated.
</p>
<p>
Care should be taken to avoid opening multiple error dialog boxes
when a single error message (such as 'out of disk space') affects
multiple items.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
<td>parent <a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> for the dialog</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>primary</code></em> :</span></p></td>
<td>main error message</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>secondary</code></em> :</span></p></td>
<td>secondary error message (printf-style format string)</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td>
<td>any substitution values for the secondary message</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="rb-file-chooser-new"></a><h3>rb_file_chooser_new ()</h3>
<pre class="programlisting"><a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html"><span class="returnvalue">GtkWidget</span></a> * rb_file_chooser_new (<em class="parameter"><code>const <span class="type">char</span> *title</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> *parent</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/gtk3/GtkFileChooser.html#GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a> action</code></em>,
<em class="parameter"><code><a href="/usr/share/gtk-doc/html/glib/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> local_only</code></em>);</pre>
<p>
Creates and shows a regular gtk+ file chooser dialog with
a given title. The user's music directory (typically ~/Music) is
added as a shortcut.
</p>
<p>
For consistency, this should be used anywhere a file chooser is required.
</p>
<p>
After creating the dialog, the caller should connect a handler to its
'response' signal to process the user's selected files or folders.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>title</code></em> :</span></p></td>
<td>title for the file chooser</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>parent</code></em> :</span></p></td>
<td>parent <a href="/usr/share/gtk-doc/html/gtk3/GtkWindow.html"><span class="type">GtkWindow</span></a> for the file chooser</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
<td>the <a href="/usr/share/gtk-doc/html/gtk3/GtkFileChooser.html#GtkFileChooserAction"><span class="type">GtkFileChooserAction</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>local_only</code></em> :</span></p></td>
<td>if TRUE, don't show network locations</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the file chooser <a href="/usr/share/gtk-doc/html/gtk3/GtkWidget.html"><span class="type">GtkWidget</span></a>. <span class="annotation">[<a href="http://foldoc.org/transfer%20full"><span class="acronym">transfer full</span></a>]</span>
</td>
</tr>
</tbody>
</table></div>
</div>
</div>
</div>
<div class="footer">
<hr>
Generated by GTK-Doc V1.18</div>
</body>
</html>
|