Signal

GrlSource::content-changed

since: 0.2.0

Declaration

void
content_changed (
  GrlSource* self,
  GrlMedia** changed_medias,
  GrlSourceChangeType change_type,
  gboolean location_unknown,
  gpointer user_data
)

Description [src]

Signals that the content in the source has changed. changed_medias is the list of elements that have changed. Usually these medias are of type GrlMedia container, meaning that the content of that container has changed.

If location_unknown is TRUE it means the source cannot establish where the change happened: could be either in the container, in any child, or in any other descendant of the container in the hierarchy.

Both change_type and location_unknown are applied to all elements in the list.

For the cases where the source can only signal that a change happened, but not where, it would use a list with the the root container (NULL id) and set location_unknown as TRUE.

Default handler:

The default handler is called before the handlers added via g_signal_connect().

Signal can be directly emitted on objects from user code

Available since: 0.2.0

Parameters

changed_medias

Type: An array of GrlMedia*

A GPtrArray with the medias that changed or a common ancestor of them of type GrlMedia.

The data is owned by the caller of the function.

change_type

Type: GrlSourceChangeType

The kind of change that ocurred.

location_unknown

Type: gboolean

TRUE if the change happened in media itself or in one of its direct children (when media is a GrlMedia). FALSE otherwise.