Method
RBRhythmDBentry_set
Declaration [src]
void
rhythmdb_entry_set (
RhythmDB* db,
RhythmDBEntry* entry,
guint propid,
const GValue* value
)
Description [src]
This function can be called by any code which wishes to change a
song property and send a notification. It may be called when the
database is read-only; in this case the change will be queued for
an unspecified time in the future. The implication of this is that
rhythmdb_entry_get()
may not reflect the changes immediately. However,
if this property is exposed in the user interface, you should still
make the change in the widget. Then when the database returns to a
writable state, your change will take effect in the database too,
and a notification will be sent at that point.
Note that you must call rhythmdb_commit()
at some point after invoking
this function, and that even after the commit, your change may not
have taken effect.
Parameters
entry
-
Type:
RhythmDBEntry
A
RhythmDBEntry
.The data is owned by the caller of the method. propid
-
Type:
guint
The id of the property to set.
value
-
Type:
GValue
The property value.
The data is owned by the caller of the method.