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