include/wx/unix/apptbase.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/unix/apptbase.h
   3 // Purpose:     declaration of wxAppTraits for Unix systems
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     23.06.2003
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2003 Vadim Zeitlin <vadim@wxwidgets.org>
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_UNIX_APPTBASE_H_
  13 #define _WX_UNIX_APPTBASE_H_
  14
  15 struct wxEndProcessData;
  16 struct wxExecuteData;
  17 class wxFDIOManager;
  18
  19 // ----------------------------------------------------------------------------
  20 // wxAppTraits: the Unix version adds extra hooks needed by Unix code
  21 // ----------------------------------------------------------------------------
  22
  23 class WXDLLIMPEXP_BASE wxAppTraits : public wxAppTraitsBase
  24 {
  25 public:
  26     // wxExecute() support methods
  27     // ---------------------------
  28
  29     // wait for the process termination, return whatever wxExecute() must
  30     // return
  31     //
  32     // base class implementation handles all cases except wxEXEC_SYNC without
  33     // wxEXEC_NOEVENTS one which is implemented at the GUI level
  34     virtual int WaitForChild(wxExecuteData& execData);
  35
  36     // integrate the monitoring of the given fd with the port-specific event
  37     // loop: when this fd, which corresponds to a dummy pipe opened between the
  38     // parent and child processes, is closed by the child, the parent is
  39     // notified about this via a call to wxHandleProcessTermination() function
  40     //
  41     // the default implementation uses wxFDIODispatcher and so is suitable for
  42     // the console applications or ports which don't have any specific event
  43     // loop
  44     virtual int AddProcessCallback(wxEndProcessData *data, int fd);
  45
  46 #if wxUSE_SOCKETS
  47     // return a pointer to the object which should be used to integrate
  48     // monitoring of the file descriptors to the event loop (currently this is
  49     // used for the sockets only but should be used for arbitrary event loop
  50     // sources in the future)
  51     //
  52     // this object may be different for the console and GUI applications
  53     //
  54     // the pointer is not deleted by the caller as normally it points to a
  55     // static variable
  56     virtual wxFDIOManager *GetFDIOManager();
  57 #endif // wxUSE_SOCKETS
  58
  59 protected:
  60     // a helper for the implementation of WaitForChild() in wxGUIAppTraits:
  61     // checks the streams used for redirected IO in execData and returns true
  62     // if there is any activity in them
  63     bool CheckForRedirectedIO(wxExecuteData& execData);
  64 };
  65
  66 #endif // _WX_UNIX_APPTBASE_H_
  67