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