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
  18 // ----------------------------------------------------------------------------
  19 // wxAppTraits: the Unix version adds extra hooks needed by Unix code
  20 // ----------------------------------------------------------------------------
  21
  22 class WXDLLIMPEXP_BASE wxAppTraits : public wxAppTraitsBase
  23 {
  24 public:
  25     // wxExecute() support methods
  26     // ---------------------------
  27
  28     // wait for the process termination, return whatever wxExecute() must
  29     // return
  30     //
  31     // base class implementation handles all cases except wxEXEC_SYNC without
  32     // wxEXEC_NOEVENTS one which is implemented at the GUI level
  33     virtual int WaitForChild(wxExecuteData& execData);
  34
  35     // integrate the monitoring of the given fd with the port-specific event
  36     // loop: when this fd, which corresponds to a dummy pipe opened between the
  37     // parent and child processes, is closed by the child, the parent is
  38     // notified about this via a call to wxHandleProcessTermination() function
  39     //
  40     // the default implementation uses wxFDIODispatcher and so is suitable for
  41     // the console applications or ports which don't have any specific event
  42     // loop
  43     virtual int AddProcessCallback(wxEndProcessData *data, int fd);
  44
  45
  46     // wxThread helpers
  47     // ----------------
  48
  49     // TODO
  50
  51 #if wxUSE_SOCKETS
  52     // returns the select()-based socket manager for console applications which
  53     // is also used by some ports (wxX11, wxDFB) in the GUI build (hence it is
  54     // here and not in wxConsoleAppTraits)
  55     virtual GSocketManager *GetSocketManager();
  56 #endif
  57
  58 protected:
  59     // a helper for the implementation of WaitForChild() in wxGUIAppTraits:
  60     // checks the streams used for redirected IO in execData and returns true
  61     // if there is any activity in them
  62     bool CheckForRedirectedIO(wxExecuteData& execData);
  63 };
  64
  65 #endif // _WX_UNIX_APPTBASE_H_
  66