X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ad8d42f83cdf7a4f26969957e94ed166a1a5710e..53107283f366d1d4950559afcbf056e901e778fd:/include/wx/private/fdiodispatcher.h diff --git a/include/wx/private/fdiodispatcher.h b/include/wx/private/fdiodispatcher.h index 0f71d94fd6..e7f367c1ff 100644 --- a/include/wx/private/fdiodispatcher.h +++ b/include/wx/private/fdiodispatcher.h @@ -45,6 +45,18 @@ class WXDLLIMPEXP_BASE wxFDIODispatcher public: enum { TIMEOUT_INFINITE = -1 }; + // return the global dispatcher to be used for IO events, can be NULL only + // if wxSelectDispatcher wasn't compiled into the library at all as + // creating it never fails + // + // don't delete the returned pointer + static wxFDIODispatcher *Get(); + + // if we have any registered handlers, check for any pending events to them + // and dispatch them -- this is used from wxX11 and wxDFB event loops + // implementation + static void DispatchPending(); + // register handler for the given descriptor with the dispatcher, return // true on success or false on error virtual bool RegisterFD(int fd, wxFDIOHandler *handler, int flags) = 0; @@ -52,13 +64,13 @@ public: // modify descriptor flags or handler, return true on success virtual bool ModifyFD(int fd, wxFDIOHandler *handler, int flags) = 0; - // unregister descriptor previously registered with RegisterFD(), the - // caller is responsible for deleting the returned handler pointer if - // necessary - virtual bool UnregisterFD(int fd, int flags) = 0; + // unregister descriptor previously registered with RegisterFD() + virtual bool UnregisterFD(int fd) = 0; - // loops waiting for an event to happen on any of the descriptors - virtual void RunLoop(int timeout) = 0; + // wait for an event for at most timeout milliseconds and process it; + // return true if we processed any events or false if timeout expired + // without anything happening + virtual bool Dispatch(int timeout = TIMEOUT_INFINITE) = 0; virtual ~wxFDIODispatcher() { } }; @@ -94,10 +106,12 @@ WX_DECLARE_HASH_MAP( // // notice that all functions for FD management have implementation // in the base class and should be called from the derived classes -class WXDLLIMPEXP_BASE wxMappedFDIODispatcher : public wxFDIODispatcher { +class WXDLLIMPEXP_BASE wxMappedFDIODispatcher : public wxFDIODispatcher +{ public: // find the handler for the given fd, return NULL if none wxFDIOHandler *FindHandler(int fd) const; + // register handler for the given descriptor with the dispatcher, return // true on success or false on error virtual bool RegisterFD(int fd, wxFDIOHandler *handler, int flags); @@ -105,10 +119,8 @@ public: // modify descriptor flags or handler, return true on success virtual bool ModifyFD(int fd, wxFDIOHandler *handler, int flags); - // unregister descriptor previously registered with RegisterFD(), the - // caller is responsible for deleting the returned handler pointer if - // necessary - virtual bool UnregisterFD(int fd, int flags); + // unregister descriptor previously registered with RegisterFD() + virtual bool UnregisterFD(int fd); virtual ~wxMappedFDIODispatcher() { }