take const wxConfig object in wxDocManager::FileHistoryLoad() and wxFileHistory:...

[wxWidgets.git] / interface / power.h

diff --git a/interface/power.h b/interface/power.h
index 8cf91500ff126209adb1368baa59070f65e5f606..b54808f56218d72096bde7cff3a852b3b273b967 100644 (file)
--- a/interface/power.h
+++ b/interface/power.h
@@ -16,22 +16,38 @@
 
     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}
 
-    @see 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();
 };