1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
|
.. wxPython Phoenix documentation
This file was generated by Phoenix's sphinx generator and associated
tools, do not edit by hand.
Copyright: (c) 2011-2018 by Total Control Software
License: wxWindows License
.. include:: headings.inc
.. _wx.PowerEvent:
==========================================================================================================================================
|phoenix_title| **wx.PowerEvent**
==========================================================================================================================================
The power events are generated when the system power state changes, e.g.
the system is suspended, hibernated, plugged into or unplugged from the wall socket and so on. PowerEvents are emitted by Windows.
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 ``ifdef wxHAS_POWER_EVENTS`` instead of directly testing for the platform in your code: this symbol will be defined for all platforms supporting the power events.
.. _PowerEvent-events:
|events| Events Emitted by this Class
=====================================
Handlers bound for the following event types will receive a :ref:`wx.PowerEvent` parameter.
Event macros:
- EVT_POWER_SUSPENDING: System is about to be suspended, this event can be vetoed to prevent suspend from taking place.
- EVT_POWER_SUSPENDED: 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.
- EVT_POWER_SUSPEND_CANCEL: System suspension was cancelled because some application vetoed it.
- EVT_POWER_RESUME: System resumed from suspend: normally the application should restore the state in which it had been before the suspension.
.. seealso:: :ref:`wx.GetPowerType`, :ref:`wx.GetBatteryState`
|
|class_hierarchy| Class Hierarchy
=================================
.. raw:: html
<div id="toggleBlock" onclick="return toggleVisibility(this)" class="closed" style="cursor:pointer;">
<img id="toggleBlock-trigger" src="_static/images/closed.png"/>
Inheritance diagram for class <strong>PowerEvent</strong>:
</div>
<div id="toggleBlock-summary" style="display:block;"></div>
<div id="toggleBlock-content" style="display:none;">
<p class="graphviz">
<center><img src="_static/images/inheritance/wx.PowerEvent_inheritance.png" alt="Inheritance diagram of PowerEvent" usemap="#dummy" class="inheritance"/></center>
</div>
<script type="text/javascript">toggleVisibilityOnLoad(document.getElementById('toggleBlock'))</script>
<map id="dummy" name="dummy"> <area shape="rect" id="node1" href="wx.Event.html" title="wx.Event" alt="" coords="23,83,101,112"/> <area shape="rect" id="node3" href="wx.PowerEvent.html" title="wx.PowerEvent" alt="" coords="5,160,120,189"/> <area shape="rect" id="node2" href="wx.Object.html" title="wx.Object" alt="" coords="21,5,103,35"/> </map>
</p>
|
|method_summary| Methods Summary
================================
================================================================================ ================================================================================
:meth:`~wx.PowerEvent.__init__`
:meth:`~wx.PowerEvent.IsVetoed` Returns whether Veto has been called.
:meth:`~wx.PowerEvent.Veto` Call this to prevent suspend from taking place in ``wxEVT_POWER_SUSPENDING`` handler (it is ignored for all the others).
================================================================================ ================================================================================
|
|api| Class API
===============
.. class:: wx.PowerEvent(Event)
**Possible constructors**::
PowerEvent()
PowerEvent(evtType)
The power events are generated when the system power state changes,
e.g.
.. method:: __init__(self, *args, **kw)
|overload| Overloaded Implementations:
**~~~**
**__init__** `(self)`
**~~~**
**__init__** `(self, evtType)`
:param `evtType`:
:type `evtType`: wx.EventType
**~~~**
.. method:: IsVetoed(self)
Returns whether Veto has been called.
:rtype: `bool`
.. method:: Veto(self)
Call this to prevent suspend from taking place in ``wxEVT_POWER_SUSPENDING`` handler (it is ignored for all the others).
|
