dbus_properties_mixin_emit_properties_changed


Description:


[ Version ( since = "0.15.6" ) ]
public void dbus_properties_mixin_emit_properties_changed (Object object, string interface_name, string? properties)

Emits the PropertiesChanged signal for the provided properties.

Depending on the EmitsChangedSignal annotations in the introspection XML, either the new value of the property will be included in the signal, or merely the fact that the property has changed.

For example, the MPRIS specification defines a TrackList interface with two properties, one of which is annotated with EmitsChangedSignal=true and one annotated with EmitsChangedSignal=invalidates. The following call would include the new value of CanEditTracks and list Tracks as invalidated:

   const gchar *properties[] = { "CanEditTracks", "Tracks", NULL };

tp_dbus_properties_mixin_emit_properties_changed (G_OBJECT (self),
"org.mpris.MediaPlayer2.TrackList", properties);

It is an error to pass a property to this function if the property is annotated with EmitsChangedSignal=false, or is unannotated.

Parameters:

object

an object which uses the D-Bus properties mixin

interface_name

the interface on which properties have changed

properties

a null-terminated array of (unqualified) property names whose values have changed.


Namespace: TelepathyGLib
Package: telepathy-glib