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 wxPipe;
  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
  47     // wxThread helpers
  48     // ----------------
  49
  50     // TODO
  51
  52 #if wxUSE_SOCKETS
  53     // returns the select()-based socket manager for console applications which
  54     // is also used by some ports (wxX11, wxDFB) in the GUI build (hence it is
  55     // here and not in wxConsoleAppTraits)
  56     virtual GSocketManager *GetSocketManager();
  57 #endif
  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