Version: 3.0.3
fswatcher.h File Reference

Classes

class  wxFileSystemWatcher
 The wxFileSystemWatcher class allows to receive notifications of file system changes. More...
 
class  wxFileSystemWatcherEvent
 A class of events sent when a file system event occurs. More...
 

Enumerations

enum  wxFSWFlags {
  wxFSW_EVENT_CREATE = 0x01,
  wxFSW_EVENT_DELETE = 0x02,
  wxFSW_EVENT_RENAME = 0x04,
  wxFSW_EVENT_MODIFY = 0x08,
  wxFSW_EVENT_ACCESS = 0x10,
  wxFSW_EVENT_ATTRIB = 0x20,
  wxFSW_EVENT_UNMOUNT = 0x2000,
  wxFSW_EVENT_WARNING = 0x40,
  wxFSW_EVENT_ERROR = 0x80,
  wxFSW_EVENT_ALL
}
 These are the possible types of file system change events. More...
 
enum  wxFSWWarningType {
  wxFSW_WARNING_NONE,
  wxFSW_WARNING_GENERAL,
  wxFSW_WARNING_OVERFLOW
}
 Possible warning types for the warning events generated by wxFileSystemWatcher. More...
 

Variables

wxEventType wxEVT_FSWATCHER
 

Enumeration Type Documentation

enum wxFSWFlags

These are the possible types of file system change events.

Not all of these events are reported on all platforms currently.

Since
2.9.1
Enumerator
wxFSW_EVENT_CREATE 

File or directory was created.

wxFSW_EVENT_DELETE 

File or directory was deleted.

wxFSW_EVENT_RENAME 

File or directory was renamed.

Notice that under MSW this event is sometimes – although not always – followed by a wxFSW_EVENT_MODIFY for the new file.

Under OS X this event is currently not detected and instead separate wxFSW_EVENT_CREATE and wxFSW_EVENT_DELETE events are.

wxFSW_EVENT_MODIFY 

File or directory was modified.

Depending on the program doing the file modification, multiple such events can be reported for a single logical file update.

Under OS X this event is currently not detected.

wxFSW_EVENT_ACCESS 

File or directory was accessed.

This event is currently only detected under Linux.

wxFSW_EVENT_ATTRIB 

The item's metadata was changed, e.g. its permissions or timestamps.

This event is currently only detected under Linux.

Since
2.9.5
wxFSW_EVENT_UNMOUNT 

The file system containing a watched item was unmounted.

wxFSW_EVENT_UNMOUNT cannot be set; unmount events are produced automatically. This flag is therefore not included in wxFSW_EVENT_ALL.

This event is currently only detected under Linux.

Since
2.9.5
wxFSW_EVENT_WARNING 

A warning condition arose.

This is something that probably needs to be shown to the user in an interactive program as it can indicate a relatively serious problem, e.g. some events could have been missed because of an overflow. But more events will still be coming in the future, unlike for the error condition below.

wxFSW_EVENT_ERROR 

An error condition arose.

Errors are fatal, i.e. no more events will be reported after an error and the program can stop watching the directories currently being monitored.

wxFSW_EVENT_ALL 

Possible warning types for the warning events generated by wxFileSystemWatcher.

Since
3.0
Enumerator
wxFSW_WARNING_NONE 

This is not a warning at all.

wxFSW_WARNING_GENERAL 

A generic warning.

Further information may be provided in the user-readable message available from wxFileSystemWatcherEvent::GetErrorDescription()

wxFSW_WARNING_OVERFLOW 

An overflow event.

This warning indicates that some file system changes were not signaled by any events, usually because there were too many of them and the internally used queue has overflown. If such event is received it is recommended to completely rescan the files or directories being monitored.

Variable Documentation

wxEventType wxEVT_FSWATCHER