8
8
<link rel="up" href="ch04.html" title="RhythmDB">
9
9
<link rel="prev" href="RhythmDBImportJob.html" title="RhythmDBImportJob">
10
10
<link rel="next" href="RhythmDBQueryModel.html" title="RhythmDBQueryModel">
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="#RhythmDBPropertyModel.synopsis" class="shortcut">Top</a>
33
<a href="#RhythmDBPropertyModel.description" class="shortcut">Description</a>
35
<a href="#RhythmDBPropertyModel.object-hierarchy" class="shortcut">Object Hierarchy</a>
37
<a href="#RhythmDBPropertyModel.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
39
<a href="#RhythmDBPropertyModel.properties" class="shortcut">Properties</a>
41
<a href="#RhythmDBPropertyModel.signals" class="shortcut">Signals</a>
33
<a href="#RhythmDBPropertyModel.description" class="shortcut">Description</a>
35
<a href="#RhythmDBPropertyModel.object-hierarchy" class="shortcut">Object Hierarchy</a>
37
<a href="#RhythmDBPropertyModel.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
39
<a href="#RhythmDBPropertyModel.properties" class="shortcut">Properties</a>
41
<a href="#RhythmDBPropertyModel.signals" class="shortcut">Signals</a>
44
44
<div class="refentry" title="RhythmDBPropertyModel">
52
52
</tr></table></div>
53
53
<div class="refsynopsisdiv" title="Synopsis">
54
54
<a name="RhythmDBPropertyModel.synopsis"></a><h2>Synopsis</h2>
55
<pre class="synopsis">
56
<a class="link" href="RhythmDBPropertyModel.html#RhythmDBPropertyModel-struct" title="RhythmDBPropertyModel">RhythmDBPropertyModel</a>;
55
<pre class="synopsis"> <a class="link" href="RhythmDBPropertyModel.html#RhythmDBPropertyModel-struct" title="RhythmDBPropertyModel">RhythmDBPropertyModel</a>;
57
56
<a class="link" href="RhythmDBPropertyModel.html#RhythmDBPropertyModelClass" title="RhythmDBPropertyModelClass">RhythmDBPropertyModelClass</a>;
58
57
enum <a class="link" href="RhythmDBPropertyModel.html#RhythmDBPropertyModelColumn" title="enum RhythmDBPropertyModelColumn">RhythmDBPropertyModelColumn</a>;
59
<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel">RhythmDBPropertyModel</a> * <a class="link" href="RhythmDBPropertyModel.html#rhythmdb-property-model-new" title="rhythmdb_property_model_new ()">rhythmdb_property_model_new</a> (<a class="link" href="RhythmDB.html" title="RhythmDB">RhythmDB</a> *db,
60
<a class="link" href="RhythmDB.html#RhythmDBPropType" title="enum RhythmDBPropType">RhythmDBPropType</a> propid);
62
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
63
>gboolean</a> <a class="link" href="RhythmDBPropertyModel.html#rhythmdb-property-model-iter-from-string" title="rhythmdb_property_model_iter_from_string ()">rhythmdb_property_model_iter_from_string</a>
64
(<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel">RhythmDBPropertyModel</a> *model,
67
href="http://library.gnome.org/devel/gtk/unstable/GtkTreeModel.html#GtkTreeIter"
68
>GtkTreeIter</a> *iter);
69
void <a class="link" href="RhythmDBPropertyModel.html#rhythmdb-property-model-enable-drag" title="rhythmdb_property_model_enable_drag ()">rhythmdb_property_model_enable_drag</a> (<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel">RhythmDBPropertyModel</a> *model,
71
href="http://library.gnome.org/devel/gtk/unstable/GtkTreeView.html"
72
>GtkTreeView</a> *view);
58
<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel"><span class="returnvalue">RhythmDBPropertyModel</span></a> * <a class="link" href="RhythmDBPropertyModel.html#rhythmdb-property-model-new" title="rhythmdb_property_model_new ()">rhythmdb_property_model_new</a> (<a class="link" href="RhythmDB.html" title="RhythmDB"><span class="returnvalue">RhythmDB</span></a> *db,
59
<a class="link" href="RhythmDB.html#RhythmDBPropType" title="enum RhythmDBPropType"><span class="returnvalue">RhythmDBPropType</span></a> propid);
60
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> <a class="link" href="RhythmDBPropertyModel.html#rhythmdb-property-model-iter-from-string" title="rhythmdb_property_model_iter_from_string ()">rhythmdb_property_model_iter_from_string</a>
61
(<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel"><span class="returnvalue">RhythmDBPropertyModel</span></a> *model,
62
const <span class="returnvalue">char</span> *name,
63
<a href="http://library.gnome.org/devel/gtk/unstable/GtkTreeModel.html#GtkTreeIter"><span class="returnvalue">GtkTreeIter</span></a> *iter);
64
<span class="returnvalue">void</span> <a class="link" href="RhythmDBPropertyModel.html#rhythmdb-property-model-enable-drag" title="rhythmdb_property_model_enable_drag ()">rhythmdb_property_model_enable_drag</a> (<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel"><span class="returnvalue">RhythmDBPropertyModel</span></a> *model,
65
<a href="http://library.gnome.org/devel/gtk/unstable/GtkTreeView.html"><span class="returnvalue">GtkTreeView</span></a> *view);
75
68
<div class="refsect1" title="Object Hierarchy">
76
69
<a name="RhythmDBPropertyModel.object-hierarchy"></a><h2>Object Hierarchy</h2>
77
70
<pre class="synopsis">
79
href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject"
71
<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
81
72
+----RhythmDBPropertyModel
85
76
<a name="RhythmDBPropertyModel.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
87
78
RhythmDBPropertyModel implements
89
href="http://library.gnome.org/devel/gtk/unstable/GtkTreeModel.html"
90
>GtkTreeModel</a> and <a class="link" href="rhythmbox-rb-tree-dnd.html#RbTreeDragSource">RbTreeDragSource</a>.</p>
79
<a href="http://library.gnome.org/devel/gtk/unstable/GtkTreeModel.html">GtkTreeModel</a> and <a class="link" href="rhythmbox-rb-tree-dnd.html#RbTreeDragSource">RbTreeDragSource</a>.</p>
92
81
<div class="refsect1" title="Properties">
93
82
<a name="RhythmDBPropertyModel.properties"></a><h2>Properties</h2>
94
83
<pre class="synopsis">
95
"<a class="link" href="RhythmDBPropertyModel.html#RhythmDBPropertyModel--db" title='The "db" property'>db</a>" <a class="link" href="RhythmDB.html" title="RhythmDB">RhythmDB</a>* : Read / Write / Construct Only
96
"<a class="link" href="RhythmDBPropertyModel.html#RhythmDBPropertyModel--prop" title='The "prop" property'>prop</a>" <a
97
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
98
>gint</a> : Read / Write / Construct Only
99
"<a class="link" href="RhythmDBPropertyModel.html#RhythmDBPropertyModel--query-model" title='The "query-model" property'>query-model</a>" <a class="link" href="RhythmDBQueryModel.html" title="RhythmDBQueryModel">RhythmDBQueryModel</a>* : Read / Write
84
"<a class="link" href="RhythmDBPropertyModel.html#RhythmDBPropertyModel--db" title='The "db" property'>db</a>" <a class="link" href="RhythmDB.html" title="RhythmDB"><span class="type">RhythmDB</span></a>* : Read / Write / Construct Only
85
"<a class="link" href="RhythmDBPropertyModel.html#RhythmDBPropertyModel--prop" title='The "prop" property'>prop</a>" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only
86
"<a class="link" href="RhythmDBPropertyModel.html#RhythmDBPropertyModel--query-model" title='The "query-model" property'>query-model</a>" <a class="link" href="RhythmDBQueryModel.html" title="RhythmDBQueryModel"><span class="type">RhythmDBQueryModel</span></a>* : Read / Write
102
89
<div class="refsect1" title="Signals">
111
98
A RhythmDBPropertyModel groups the entries in a <a class="link" href="RhythmDBQueryModel.html" title="RhythmDBQueryModel"><span class="type">RhythmDBQueryModel</span></a> by
112
99
the value of a property. For example, a RhythmDBPropertyModel using
113
100
the RHYTHMDB_PROP_ARTIST property can be used as the model for a
115
href="http://library.gnome.org/devel/gtk/unstable/GtkTreeView.html"
116
><span class="type">GtkTreeView</span></a> that will list the artists present in the query model.
101
<a href="http://library.gnome.org/devel/gtk/unstable/GtkTreeView.html"><span class="type">GtkTreeView</span></a> that will list the artists present in the query model.
119
104
The album/artist/genre browsers displayed in the library and other sources are
120
105
populated using a RhythmDBPropertyModel for each property.</p>
124
107
<div class="refsect1" title="Details">
125
108
<a name="RhythmDBPropertyModel.details"></a><h2>Details</h2>
159
142
<div class="refsect2" title="rhythmdb_property_model_new ()">
160
143
<a name="rhythmdb-property-model-new"></a><h3>rhythmdb_property_model_new ()</h3>
161
<pre class="programlisting"><a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel">RhythmDBPropertyModel</a> * rhythmdb_property_model_new (<a class="link" href="RhythmDB.html" title="RhythmDB">RhythmDB</a> *db,
162
<a class="link" href="RhythmDB.html#RhythmDBPropType" title="enum RhythmDBPropType">RhythmDBPropType</a> propid);</pre>
144
<pre class="programlisting"><a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel"><span class="returnvalue">RhythmDBPropertyModel</span></a> * rhythmdb_property_model_new (<a class="link" href="RhythmDB.html" title="RhythmDB"><span class="returnvalue">RhythmDB</span></a> *db,
145
<a class="link" href="RhythmDB.html#RhythmDBPropType" title="enum RhythmDBPropType"><span class="returnvalue">RhythmDBPropType</span></a> propid);</pre>
164
147
Creates a new property model for the specified property ID.</p>
167
148
<div class="variablelist"><table border="0">
168
149
<col align="left" valign="top">
189
170
<div class="refsect2" title="rhythmdb_property_model_iter_from_string ()">
190
171
<a name="rhythmdb-property-model-iter-from-string"></a><h3>rhythmdb_property_model_iter_from_string ()</h3>
191
<pre class="programlisting"><a
192
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"
193
>gboolean</a> rhythmdb_property_model_iter_from_string
194
(<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel">RhythmDBPropertyModel</a> *model,
197
href="http://library.gnome.org/devel/gtk/unstable/GtkTreeModel.html#GtkTreeIter"
198
>GtkTreeIter</a> *iter);</pre>
172
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> rhythmdb_property_model_iter_from_string
173
(<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel"><span class="returnvalue">RhythmDBPropertyModel</span></a> *model,
174
const <span class="returnvalue">char</span> *name,
175
<a href="http://library.gnome.org/devel/gtk/unstable/GtkTreeModel.html#GtkTreeIter"><span class="returnvalue">GtkTreeIter</span></a> *iter);</pre>
200
177
Locates the row in the model for a property value.</p>
203
178
<div class="variablelist"><table border="0">
204
179
<col align="left" valign="top">
232
205
<div class="refsect2" title="rhythmdb_property_model_enable_drag ()">
233
206
<a name="rhythmdb-property-model-enable-drag"></a><h3>rhythmdb_property_model_enable_drag ()</h3>
234
<pre class="programlisting">void rhythmdb_property_model_enable_drag (<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel">RhythmDBPropertyModel</a> *model,
236
href="http://library.gnome.org/devel/gtk/unstable/GtkTreeView.html"
237
>GtkTreeView</a> *view);</pre>
207
<pre class="programlisting"><span class="returnvalue">void</span> rhythmdb_property_model_enable_drag (<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel"><span class="returnvalue">RhythmDBPropertyModel</span></a> *model,
208
<a href="http://library.gnome.org/devel/gtk/unstable/GtkTreeView.html"><span class="returnvalue">GtkTreeView</span></a> *view);</pre>
239
Enables drag and drop from a specified <a
240
href="http://library.gnome.org/devel/gtk/unstable/GtkTreeView.html"
241
><span class="type">GtkTreeView</span></a> that is
210
Enables drag and drop from a specified <a href="http://library.gnome.org/devel/gtk/unstable/GtkTreeView.html"><span class="type">GtkTreeView</span></a> that is
242
211
backed by the <a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel"><span class="type">RhythmDBPropertyModel</span></a>. Drag targets are
243
212
determined by the indexed property.</p>
246
213
<div class="variablelist"><table border="0">
247
214
<col align="left" valign="top">
255
222
<td><p><span class="term"><em class="parameter"><code>view</code></em> :</span></p></td>
257
href="http://library.gnome.org/devel/gtk/unstable/GtkTreeView.html"
258
><span class="type">GtkTreeView</span></a> from which to enable drag and drop
223
<td> the <a href="http://library.gnome.org/devel/gtk/unstable/GtkTreeView.html"><span class="type">GtkTreeView</span></a> from which to enable drag and drop
266
231
<a name="RhythmDBPropertyModel.property-details"></a><h2>Property Details</h2>
267
232
<div class="refsect2" title='The "db" property'>
268
233
<a name="RhythmDBPropertyModel--db"></a><h3>The <code class="literal">"db"</code> property</h3>
269
<pre class="programlisting"> "db" <a class="link" href="RhythmDB.html" title="RhythmDB">RhythmDB</a>* : Read / Write / Construct Only</pre>
234
<pre class="programlisting"> "db" <a class="link" href="RhythmDB.html" title="RhythmDB"><span class="type">RhythmDB</span></a>* : Read / Write / Construct Only</pre>
271
236
The <a class="link" href="RhythmDB.html" title="RhythmDB"><span class="type">RhythmDB</span></a> object the model is associated with.</p>
276
239
<div class="refsect2" title='The "prop" property'>
277
240
<a name="RhythmDBPropertyModel--prop"></a><h3>The <code class="literal">"prop"</code> property</h3>
278
<pre class="programlisting"> "prop" <a
279
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"
280
>gint</a> : Read / Write / Construct Only</pre>
241
<pre class="programlisting"> "prop" <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> : Read / Write / Construct Only</pre>
282
243
The property that this property model indexes.</p>
285
244
<p>Allowed values: [0,59]</p>
286
245
<p>Default value: 0</p>
289
248
<div class="refsect2" title='The "query-model" property'>
290
249
<a name="RhythmDBPropertyModel--query-model"></a><h3>The <code class="literal">"query-model"</code> property</h3>
291
<pre class="programlisting"> "query-model" <a class="link" href="RhythmDBQueryModel.html" title="RhythmDBQueryModel">RhythmDBQueryModel</a>* : Read / Write</pre>
250
<pre class="programlisting"> "query-model" <a class="link" href="RhythmDBQueryModel.html" title="RhythmDBQueryModel"><span class="type">RhythmDBQueryModel</span></a>* : Read / Write</pre>
293
252
The query model that this property model indexes.</p>
298
255
<div class="refsect1" title="Signal Details">
299
256
<a name="RhythmDBPropertyModel.signal-details"></a><h2>Signal Details</h2>
300
257
<div class="refsect2" title='The "pre-row-deletion" signal'>
301
258
<a name="RhythmDBPropertyModel-pre-row-deletion"></a><h3>The <code class="literal">"pre-row-deletion"</code> signal</h3>
302
<pre class="programlisting">void user_function (<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel">RhythmDBPropertyModel</a> *model,
304
href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"
305
>gpointer</a> user_data) : Run Last</pre>
259
<pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="RhythmDBPropertyModel.html" title="RhythmDBPropertyModel"><span class="type">RhythmDBPropertyModel</span></a> *model,
260
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data) : Run Last</pre>
307
262
Emitted just before a row is deleted from the model.</p>
310
263
<div class="variablelist"><table border="0">
311
264
<col align="left" valign="top">