X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/7c913512a4c9f36e11e07ea707002fab1608d324..a0f4d36895556e3054e2256cb5f1787cc9fcf75c:/interface/power.h

diff --git a/interface/power.h b/interface/power.h
index 87a4ae1e0a..b54808f562 100644
--- a/interface/power.h
+++ b/interface/power.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        power.h
-// Purpose:     documentation for wxPowerEvent class
+// Purpose:     interface of wxPowerEvent
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -16,23 +16,39 @@
 
     Notice that currently only suspend and resume events are generated and only
     under MS Windows platform. To avoid the need to change the code using this
-    event later when these events are implemented on the other platforms please use
-    the test @c ifdef wxHAS_POWER_EVENTS instead of directly testing for
+    event later when these events are implemented on the other platforms please
+    use the test <tt>ifdef wxHAS_POWER_EVENTS</tt> instead of directly testing for
     the platform in your code: this symbol will be defined for all platforms
     supporting the power events.
 
+    @beginEventTable{wxPowerEvent}
+    @event{EVT_POWER_SUSPENDING(func)}:
+           System is about to be suspended, this event can be vetoed to prevent
+           suspend from taking place.
+    @event{EVT_POWER_SUSPENDED(func)}:
+           System is about to suspend: normally the application should quickly
+           (i.e. without user intervention) close all the open files and network
+           connections here, possibly remembering them to reopen them later when
+           the system is resumed.
+    @event{EVT_POWER_SUSPEND_CANCEL(func)}:
+           System suspension was cancelled because some application vetoed it.
+    @event{EVT_POWER_RESUME(func)}:
+           System resumed from suspend: normally the application should restore
+           the state in which it had been before the suspension.
+    @endEventTable
+
     @library{wxbase}
-    @category{FIXME}
+    @category{events}
 
-    @seealso
-    wxGetPowerType, wxGetBatteryState
+    @see ::wxGetPowerType(), ::wxGetBatteryState()
 */
 class wxPowerEvent : public wxEvent
 {
 public:
     /**
-        Call this to prevent suspend from taking place in
-        @c wxEVT_POWER_SUSPENDING handler (it is ignored for all the others).
+        Call this to prevent suspend from taking place in @c wxEVT_POWER_SUSPENDING
+        handler (it is ignored for all the others).
     */
     void Veto();
 };
+