Signal

GioFileMonitor::changed

Declaration

void
changed (
  GFileMonitor* self,
  GioFile* file,
  GioFile* other_file,
  GFileMonitorEvent event_type,
  gpointer user_data
)

Description

Emitted when file has been changed.

If using G_FILE_MONITOR_WATCH_MOVES on a directory monitor, and the information is available (and if supported by the backend), event_type may be G_FILE_MONITOR_EVENT_RENAMED, G_FILE_MONITOR_EVENT_MOVED_IN or G_FILE_MONITOR_EVENT_MOVED_OUT.

In all cases file will be a child of the monitored directory. For renames, file will be the old name and other_file is the new name. For “moved in” events, file is the name of the file that appeared and other_file is the old name that it was moved from (in another directory). For “moved out” events, file is the name of the file that used to be in this directory and other_file is the name of the file at its new location.

It makes sense to treat G_FILE_MONITOR_EVENT_MOVED_IN as equivalent to G_FILE_MONITOR_EVENT_CREATED and G_FILE_MONITOR_EVENT_MOVED_OUT as equivalent to G_FILE_MONITOR_EVENT_DELETED, with extra information. G_FILE_MONITOR_EVENT_RENAMED is equivalent to a delete/create pair. This is exactly how the events will be reported in the case that the G_FILE_MONITOR_WATCH_MOVES flag is not in use.

If using the deprecated flag G_FILE_MONITOR_SEND_MOVED flag and event_type is G_FILE_MONITOR_EVENT_MOVED, file will be set to a GFile containing the old path, and other_file will be set to a GFile containing the new path.

In all the other cases, other_file will be set to NULL.

Default handler:

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

Parameters

file

Type: GFile

A GFile.

The data is owned by the caller of the function.

other_file

Type: GFile

A GFile or NULL.

The argument can be NULL.

The data is owned by the caller of the function.

event_type

Type: GFileMonitorEvent

A GFileMonitorEvent.