![]() |
![]() |
![]() |
GIO Reference Manual | ![]() |
---|---|---|---|---|
#include <gio/gio.h> enum GFileMonitorEvent; GFileMonitor; gboolean g_file_monitor_cancel (GFileMonitor *monitor); gboolean g_file_monitor_is_cancelled (GFileMonitor *monitor); void g_file_monitor_set_rate_limit (GFileMonitor *monitor, int limit_msecs); void g_file_monitor_emit_event (GFileMonitor *monitor, GFile *child, GFile *other_file, GFileMonitorEvent event_type);
Monitors a file or directory for changes.
To obtain a GFileMonitor for a file or directory, use g_file_monitor_file() or g_file_monitor_directory().
To get informed about changes to the file or directory you are monitoring, connect to the GFileMonitor::changed signal.
typedef enum { G_FILE_MONITOR_EVENT_CHANGED, G_FILE_MONITOR_EVENT_CHANGES_DONE_HINT, G_FILE_MONITOR_EVENT_DELETED, G_FILE_MONITOR_EVENT_CREATED, G_FILE_MONITOR_EVENT_ATTRIBUTE_CHANGED, G_FILE_MONITOR_EVENT_PRE_UNMOUNT, G_FILE_MONITOR_EVENT_UNMOUNTED } GFileMonitorEvent;
Specifies what type of event a monitor event is.
gboolean g_file_monitor_cancel (GFileMonitor *monitor);
Cancels a file monitor.
monitor : | a GFileMonitor. |
Returns : | TRUE if monitor was cancelled. |
gboolean g_file_monitor_is_cancelled (GFileMonitor *monitor);
Returns whether the monitor is canceled.
monitor : | a GFileMonitor |
Returns : | TRUE if monitor is canceled. FALSE otherwise. |
void g_file_monitor_set_rate_limit (GFileMonitor *monitor, int limit_msecs);
Sets the rate limit to which the monitor will report consecutive change events to the same file.
monitor : | a GFileMonitor. |
limit_msecs : | a integer with the limit in milliseconds to poll for changes. |
void g_file_monitor_emit_event (GFileMonitor *monitor, GFile *child, GFile *other_file, GFileMonitorEvent event_type);
Emits the GFileMonitor::changed signal if a change has taken place. Should be called from file monitor implementations only.
The signal will be emitted from an idle handler.
monitor : | a GFileMonitor. |
child : | a GFile. |
other_file : | a GFile. |
event_type : | a set of GFileMonitorEvent flags. |
"cancelled" gboolean : Read
Whether the monitor has been cancelled.
Default value: FALSE
void user_function (GFileMonitor *monitor, GFile *file, GFile *other_file, GFileMonitorEvent event_type, gpointer user_data) : Run Last
Emitted when a file has been changed.
monitor : | a GFileMonitor. |
file : | a GFile. |
other_file : | a GFile. |
event_type : | a GFileMonitorEvent. |
user_data : | user data set when the signal handler was connected. |