include/wx/power.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/power.h
   3 // Purpose:     functions and classes for system power management
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     2006-05-27
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2006 Vadim Zeitlin <vadim@wxwindows.org>
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_POWER_H_
  13 #define _WX_POWER_H_
  14
  15 #include "wx/event.h"
  16
  17 // ----------------------------------------------------------------------------
  18 // power management constants
  19 // ----------------------------------------------------------------------------
  20
  21 enum wxPowerType
  22 {
  23     wxPOWER_SOCKET,
  24     wxPOWER_BATTERY,
  25     wxPOWER_UNKNOWN
  26 };
  27
  28 enum wxBatteryState
  29 {
  30     wxBATTERY_NORMAL_STATE,    // system is fully usable
  31     wxBATTERY_LOW_STATE,       // start to worry
  32     wxBATTERY_CRITICAL_STATE,  // save quickly
  33     wxBATTERY_SHUTDOWN_STATE,  // too late
  34     wxBATTERY_UNKNOWN_STATE
  35 };
  36
  37 // ----------------------------------------------------------------------------
  38 // wxPowerEvent is generated when the system online status changes
  39 // ----------------------------------------------------------------------------
  40
  41 // currently the power events are only available under Windows, to avoid
  42 // compiling in the code for handling them which is never going to be invoked
  43 // under the other platforms, we define wxHAS_POWER_EVENTS symbol if this event
  44 // is available, it should be used to guard all code using wxPowerEvent
  45 #ifdef __WXMSW__
  46
  47 #define wxHAS_POWER_EVENTS
  48
  49 class WXDLLIMPEXP_BASE wxPowerEvent : public wxEvent
  50 {
  51 public:
  52     wxPowerEvent(wxEventType evtType) : wxEvent(wxID_NONE, evtType)
  53     {
  54         m_veto = false;
  55     }
  56
  57     // Veto the operation (only makes sense with EVT_POWER_SUSPENDING)
  58     void Veto() { m_veto = true; }
  59
  60     bool IsVetoed() const { return m_veto; }
  61
  62
  63     // default copy ctor, assignment operator and dtor are ok
  64
  65     virtual wxEvent *Clone() const { return new wxPowerEvent(*this); }
  66
  67 private:
  68     bool m_veto;
  69
  70     DECLARE_ABSTRACT_CLASS(wxPowerEvent)
  71 };
  72
  73 BEGIN_DECLARE_EVENT_TYPES()
  74     DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_BASE, wxEVT_POWER_SUSPENDING, 406)
  75     DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_BASE, wxEVT_POWER_SUSPENDED, 407)
  76     DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_BASE, wxEVT_POWER_SUSPEND_CANCEL, 408)
  77     DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_BASE, wxEVT_POWER_RESUME, 444)
  78 END_DECLARE_EVENT_TYPES()
  79
  80 typedef void (wxEvtHandler::*wxPowerEventFunction)(wxPowerEvent&);
  81
  82 #define wxPowerEventHandler(func) \
  83     (wxObjectEventFunction)(wxEventFunction) \
  84         wxStaticCastEvent(wxPowerEventFunction, &func)
  85
  86 #define EVT_POWER_SUSPENDING(func) \
  87     wx__DECLARE_EVT0(wxEVT_POWER_SUSPENDING, wxPowerEventHandler(func))
  88 #define EVT_POWER_SUSPENDED(func) \
  89     wx__DECLARE_EVT0(wxEVT_POWER_SUSPENDED, wxPowerEventHandler(func))
  90 #define EVT_POWER_SUSPEND_CANCEL(func) \
  91     wx__DECLARE_EVT0(wxEVT_POWER_SUSPEND_CANCEL, wxPowerEventHandler(func))
  92 #define EVT_POWER_RESUME(func) \
  93     wx__DECLARE_EVT0(wxEVT_POWER_RESUME, wxPowerEventHandler(func))
  94
  95 #else // no support for power events
  96     #undef wxHAS_POWER_EVENTS
  97 #endif // support for power events/no support
  98
  99 // ----------------------------------------------------------------------------
 100 // power management functions
 101 // ----------------------------------------------------------------------------
 102
 103 // return the current system power state: online or offline
 104 WXDLLIMPEXP_BASE wxPowerType wxGetPowerType();
 105
 106 // return approximate battery state
 107 WXDLLIMPEXP_BASE wxBatteryState wxGetBatteryState();
 108
 109 #endif // _WX_POWER_H_