FileMonitor

FileMonitor

Object Hierarchy:

Description:

[ CCode ( type_id = "g_file_monitor_get_type ()" ) ]
public abstract class FileMonitor : Object

Monitors a file or directory for changes.

To obtain a `GFileMonitor` for a file or directory, use [method@Gio.File.monitor], [method@Gio.File.monitor_file], or [ method@Gio.File.monitor_directory].

To get informed about changes to the file or directory you are monitoring, connect to the [signal@Gio.FileMonitor:GFileMonitor:changed] signal. The signal will be emitted in the thread-default main context (see [ method@GLib.MainContext.push_thread_default]) of the thread that the monitor was created in (though if the global default main context is blocked, this may cause notifications to be blocked even if the thread-default context is still running).

Namespace: GLib

Package: gio-2.0

Content:

Properties:

public bool cancelled { get; }
Whether the monitor has been cancelled.
public MainContext context { construct; }
public int rate_limit { get; set; }
The limit of the monitor to watch for changes, in milliseconds.

Creation methods:

protected FileMonitor ()

Methods:

public virtual bool cancel ()
Cancels a file monitor.
public void emit_event (File child, File other_file, FileMonitorEvent event_type)
Emits the changed signal if a change has taken place.
public bool is_cancelled ()
Returns whether the monitor is canceled.
public void set_rate_limit (int limit_msecs)
Sets the rate limit to which the this will report consecutive change events to the same file.

Signals:

public virtual signal void changed (File file, File? other_file, FileMonitorEvent event_type)
Emitted when file has been changed.

Inherited Members:

All known members inherited from class GLib.Object