]> git.saurik.com Git - wxWidgets.git/blob - docs/latex/wx/activevt.tex
added wxWindow::HandleAsNavigationKey() helper for handling (not only) TAB key in...
[wxWidgets.git] / docs / latex / wx / activevt.tex
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
11 \wxheading{Include files}
12
13 <wx/event.h>
14
15 \wxheading{Library}
16
17 \helpref{wxCore}{librarieslist}
18
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.}
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
31 full working state when it receives a wxEVT\_ACTIVATE or wxEVT\_ACTIVATE\_APP event.}
32 \end{twocollist}%
33
34 \wxheading{Remarks}
35
36 A top-level window (a dialog or frame) receives an activate event when it is
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,
41 or a frame becomes inactivated resulting in all application frames being inactive.
42
43 Please note that usually you should call \helpref{event.Skip()}{wxeventskip} in
44 your handlers for these events as not doing so can result in strange effects.
45
46 \wxheading{See also}
47
48 \helpref{Event handling overview}{eventhandlingoverview},\rtfsp
49 \helpref{wxApp::IsActive}{wxappisactive}
50
51 \latexignore{\rtfignore{\wxheading{Members}}}
52
53 \membersection{wxActivateEvent::wxActivateEvent}\label{wxactivateeventctor}
54
55 \func{}{wxActivateEvent}{\param{WXTYPE }{eventType = 0}, \param{bool}{ active = true}, \param{int }{id = 0}}
56
57 Constructor.
58
59 \membersection{wxActivateEvent::GetActive}\label{wxactivateeventgetactive}
60
61 \constfunc{bool}{GetActive}{\void}
62
63 Returns true if the application or window is being activated, false otherwise.
64