projects / wxWidgets.git / blame
| Commit | Line | Data |
|---|---|---|
| a660d684 KB |
1 | \section{\class{wxActivateEvent}}\label{wxactivateevent} |
| 2 | ||
| 3 | An activate event is sent when a window or application is being activated | |
| 4 | or deactivated. | |
| 5 | ||
| 6 | \wxheading{Derived from} | |
| 7 | ||
| 8 | \helpref{wxEvent}{wxevent}\\ | |
| 9 | \helpref{wxObject}{wxobject} | |
| 10 | ||
| 954b8ae6 JS |
11 | \wxheading{Include files} |
| 12 | ||
| 13 | <wx/event.h> | |
| 14 | ||
| a7af285d VZ |
15 | \wxheading{Library} |
| 16 | ||
| 17 | \helpref{wxCore}{librarieslist} | |
| 18 | ||
| a660d684 KB |
19 | \wxheading{Event table macros} |
| 20 | ||
| 21 | To process an activate event, use these event handler macros to direct input to a member | |
| 22 | function that takes a wxActivateEvent argument. | |
| 23 | ||
| 24 | \twocolwidtha{7cm} | |
| 25 | \begin{twocollist}\itemsep=0pt | |
| 26 | \twocolitem{{\bf EVT\_ACTIVATE(func)}}{Process a wxEVT\_ACTIVATE event.} | |
| 27 | \twocolitem{{\bf EVT\_ACTIVATE\_APP(func)}}{Process a wxEVT\_ACTIVATE\_APP event.} | |
| afafd942 JS |
28 | \twocolitem{{\bf EVT\_HIBERNATE(func)}}{Process a hibernate event, supplying the member function. |
| 29 | This event applies to wxApp only, and only on Windows SmartPhone and PocketPC. It is generated when the | |
| 30 | system is low on memory; the application should free up as much memory as possible, and restore | |
| 08890e27 | 31 | full working state when it receives a wxEVT\_ACTIVATE or wxEVT\_ACTIVATE\_APP event.} |
| a660d684 KB |
32 | \end{twocollist}% |
| 33 | ||
| 34 | \wxheading{Remarks} | |
| 35 | ||
| 08890e27 | 36 | A top-level window (a dialog or frame) receives an activate event when it is |
| a660d684 KB |
37 | being activated or deactivated. This is indicated visually by the title |
| 38 | bar changing colour, and a subwindow gaining the keyboard focus. | |
| 39 | ||
| 40 | An application is activated or deactivated when one of its frames becomes activated, | |
| b4aec6c7 | 41 | or a frame becomes inactivated resulting in all application frames being inactive. |
| a660d684 | 42 | |
| f5c74fdd | 43 | Please note that usually you should call \helpref{event.Skip()}{wxeventskip} in |
| afafd942 | 44 | your handlers for these events as not doing so can result in strange effects. |
| f5c74fdd | 45 | |
| a660d684 KB |
46 | \wxheading{See also} |
| 47 | ||
| f5c74fdd VZ |
48 | \helpref{Event handling overview}{eventhandlingoverview},\rtfsp |
| 49 | \helpref{wxApp::IsActive}{wxappisactive} | |
| a660d684 KB |
50 | |
| 51 | \latexignore{\rtfignore{\wxheading{Members}}} | |
| 52 | ||
| f510b7b2 | 53 | \membersection{wxActivateEvent::wxActivateEvent}\label{wxactivateeventctor} |
| a660d684 | 54 | |
| cc81d32f | 55 | \func{}{wxActivateEvent}{\param{WXTYPE }{eventType = 0}, \param{bool}{ active = true}, \param{int }{id = 0}} |
| a660d684 KB |
56 | |
| 57 | Constructor. | |
| 58 | ||
| a660d684 KB |
59 | \membersection{wxActivateEvent::GetActive}\label{wxactivateeventgetactive} |
| 60 | ||
| 61 | \constfunc{bool}{GetActive}{\void} | |
| 62 | ||
| cc81d32f | 63 | Returns true if the application or window is being activated, false otherwise. |
| a660d684 | 64 |