Fix missing documentation for several GDI functions.

[wxWidgets.git] / include / wx / fswatcher.h

diff --git a/include/wx/fswatcher.h b/include/wx/fswatcher.h
index ff856722c1a397ff5e337a49ca44f0dc4b58449a..ebbf1467346e314bbba54ce031cb902d8ed4653d 100644 (file)
--- a/include/wx/fswatcher.h
+++ b/include/wx/fswatcher.h
@@ -44,15 +44,18 @@ enum
     wxFSW_EVENT_RENAME = 0x04,
     wxFSW_EVENT_MODIFY = 0x08,
     wxFSW_EVENT_ACCESS = 0x10,
     wxFSW_EVENT_RENAME = 0x04,
     wxFSW_EVENT_MODIFY = 0x08,
     wxFSW_EVENT_ACCESS = 0x10,

+    wxFSW_EVENT_ATTRIB = 0x20, // Currently this is wxGTK-only

 
     // error events
 
     // error events

-    wxFSW_EVENT_WARNING = 0x20,
-    wxFSW_EVENT_ERROR = 0x40,
-
+    wxFSW_EVENT_WARNING = 0x40,
+    wxFSW_EVENT_ERROR = 0x80,

     wxFSW_EVENT_ALL = wxFSW_EVENT_CREATE | wxFSW_EVENT_DELETE |
                          wxFSW_EVENT_RENAME | wxFSW_EVENT_MODIFY |
     wxFSW_EVENT_ALL = wxFSW_EVENT_CREATE | wxFSW_EVENT_DELETE |
                          wxFSW_EVENT_RENAME | wxFSW_EVENT_MODIFY |

-                         wxFSW_EVENT_ACCESS |
+                         wxFSW_EVENT_ACCESS | wxFSW_EVENT_ATTRIB |

                          wxFSW_EVENT_WARNING | wxFSW_EVENT_ERROR
                          wxFSW_EVENT_WARNING | wxFSW_EVENT_ERROR

+#ifdef wxHAS_INOTIFY
+    ,wxFSW_EVENT_UNMOUNT = 0x2000
+#endif

 };
 
 // Type of the path watched, used only internally for now.
 };
 
 // Type of the path watched, used only internally for now.


@@ -75,7 +78,7 @@ wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_BASE, wxEVT_FSWATCHER,
 class WXDLLIMPEXP_BASE wxFileSystemWatcherEvent: public wxEvent
 {
 public:
 class WXDLLIMPEXP_BASE wxFileSystemWatcherEvent: public wxEvent
 {
 public:

-    wxFileSystemWatcherEvent(int changeType, int watchid = wxID_ANY) :
+    wxFileSystemWatcherEvent(int changeType = 0, int watchid = wxID_ANY) :

         wxEvent(watchid, wxEVT_FSWATCHER),
         m_changeType(changeType)
     {
         wxEvent(watchid, wxEVT_FSWATCHER),
         m_changeType(changeType)
     {


@@ -149,7 +152,7 @@ public:
 
     virtual wxEventCategory GetEventCategory() const
     {
 
     virtual wxEventCategory GetEventCategory() const
     {

-        // TODO this has to be merged with "similiar" categories and changed
+        // TODO this has to be merged with "similar" categories and changed

         return wxEVT_CATEGORY_UNKNOWN;
     }
 
         return wxEVT_CATEGORY_UNKNOWN;
     }
 


@@ -176,6 +179,8 @@ protected:
     wxFileName m_path;
     wxFileName m_newPath;
     wxString m_errorMsg;
     wxFileName m_path;
     wxFileName m_newPath;
     wxString m_errorMsg;

+private:
+    DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxFileSystemWatcherEvent)

 };
 
 typedef void (wxEvtHandler::*wxFileSystemWatcherEventFunction)
 };
 
 typedef void (wxEvtHandler::*wxFileSystemWatcherEventFunction)


@@ -196,12 +201,16 @@ class wxFSWatchInfo
 {
 public:
     wxFSWatchInfo() :
 {
 public:
     wxFSWatchInfo() :

-        m_events(-1), m_type(wxFSWPath_None)
+        m_events(-1), m_type(wxFSWPath_None), m_refcount(-1)

     {
     }
 
     {
     }
 

-    wxFSWatchInfo(const wxString& path, int events, wxFSWPathType type) :
-        m_path(path), m_events(events), m_type(type)
+    wxFSWatchInfo(const wxString& path,
+                  int events,
+                  wxFSWPathType type,
+                  const wxString& filespec = wxString()) :
+        m_path(path), m_filespec(filespec), m_events(events), m_type(type),
+        m_refcount(1)

     {
     }
 
     {
     }
 


@@ -210,6 +219,8 @@ public:
         return m_path;
     }
 
         return m_path;
     }
 

+    const wxString& GetFilespec() const { return m_filespec; }
+

     int GetFlags() const
     {
         return m_events;
     int GetFlags() const
     {
         return m_events;


@@ -220,10 +231,27 @@ public:
         return m_type;
     }
 
         return m_type;
     }
 

+    // Reference counting of watch entries is used to avoid watching the same
+    // file system path multiple times (this can happen even accidentally, e.g.
+    // when you have a recursive watch and then decide to watch some file or
+    // directory under it separately).
+    int IncRef()
+    {
+        return ++m_refcount;
+    }
+
+    int DecRef()
+    {
+        wxASSERT_MSG( m_refcount > 0, wxS("Trying to decrement a zero count") );
+        return --m_refcount;
+    }
+

 protected:
     wxString m_path;
 protected:
     wxString m_path;

+    wxString m_filespec;      // For tree watches, holds any filespec to apply

     int m_events;
     wxFSWPathType m_type;
     int m_events;
     wxFSWPathType m_type;

+    int m_refcount;

 };
 
 WX_DECLARE_STRING_HASH_MAP(wxFSWatchInfo, wxFSWatchInfoMap);
 };
 
 WX_DECLARE_STRING_HASH_MAP(wxFSWatchInfo, wxFSWatchInfoMap);


@@ -260,7 +288,7 @@ public:
      * of particular type.
      */
     virtual bool AddTree(const wxFileName& path, int events = wxFSW_EVENT_ALL,
      * of particular type.
      */
     virtual bool AddTree(const wxFileName& path, int events = wxFSW_EVENT_ALL,

-                         const wxString& filter = wxEmptyString);
+                         const wxString& filespec = wxEmptyString);

 
     /**
      * Removes path from the list of watched paths.
 
     /**
      * Removes path from the list of watched paths.


@@ -305,6 +333,14 @@ public:
             m_owner = handler;
     }
 
             m_owner = handler;
     }
 

+
+    // This is a semi-private function used by wxWidgets itself only.
+    //
+    // Delegates the real work of adding the path to wxFSWatcherImpl::Add() and
+    // updates m_watches if the new path was successfully added.
+    bool AddAny(const wxFileName& path, int events, wxFSWPathType type,
+                const wxString& filespec = wxString());
+

 protected:
 
     static wxString GetCanonicalPath(const wxFileName& path)
 protected:
 
     static wxString GetCanonicalPath(const wxFileName& path)


@@ -320,10 +356,6 @@ protected:
         return path_copy.GetFullPath();
     }
 
         return path_copy.GetFullPath();
     }
 

-    // Delegates the real work of adding the path to wxFSWatcherImpl::Add() and
-    // updates m_watches if the new path was successfully added.
-    bool DoAdd(const wxFileName& path, int events, wxFSWPathType type);
-

 
     wxFSWatchInfoMap m_watches;        // path=>wxFSWatchInfo map
     wxFSWatcherImpl* m_service;     // file system events service
 
     wxFSWatchInfoMap m_watches;        // path=>wxFSWatchInfo map
     wxFSWatcherImpl* m_service;     // file system events service


@@ -341,7 +373,7 @@ protected:
 #elif defined(wxHAS_KQUEUE)
     #include "wx/unix/fswatcher_kqueue.h"
     #define wxFileSystemWatcher wxKqueueFileSystemWatcher
 #elif defined(wxHAS_KQUEUE)
     #include "wx/unix/fswatcher_kqueue.h"
     #define wxFileSystemWatcher wxKqueueFileSystemWatcher

-#elif defined(__WXMSW__)
+#elif defined(__WINDOWS__)

     #include "wx/msw/fswatcher.h"
     #define wxFileSystemWatcher wxMSWFileSystemWatcher
 #else
     #include "wx/msw/fswatcher.h"
     #define wxFileSystemWatcher wxMSWFileSystemWatcher
 #else