]> git.saurik.com Git - wxWidgets.git/blob - docs/latex/wx/chfocevt.tex
added discussion of user-generated vs programmatic events
[wxWidgets.git] / docs / latex / wx / chfocevt.tex
1 \section{\class{wxChildFocusEvent}}\label{wxchildfocusevent}
2
3 A child focus event is sent to a (parent-)window when one of its child windows gains focus,
4 so that the window could restore the focus back to its corresponding child
5 if it loses it now and regains later.
6
7 Notice that child window is the direct child of the window receiving event.
8 Use \helpref{FindFocus}{wxwindowfindfocus} to retreive the window which is actually getting focus.
9
10 \wxheading{Derived from}
11
12 \helpref{wxCommandEvent}{wxcommandevent}\\
13 \helpref{wxEvent}{wxevent}\\
14 \helpref{wxObject}{wxobject}
15
16 \wxheading{Include files}
17
18 <wx/event.h>
19
20 \wxheading{Event table macros}
21
22 To process a child focus event, use this event handler macro to direct input to a member
23 function that takes a wxChildFocusEvent argument.
24
25 \twocolwidtha{7cm}
26 \begin{twocollist}\itemsep=0pt
27 \twocolitem{{\bf EVT\_CHILD\_FOCUS(func)}}{Process a wxEVT\_CHILD\_FOCUS event.}
28 \end{twocollist}%
29
30 \wxheading{See also}
31
32 \helpref{Event handling overview}{eventhandlingoverview}
33
34 \latexignore{\rtfignore{\wxheading{Members}}}
35
36
37 \membersection{wxChildFocusEvent::wxChildFocusEvent}\label{wxchildfocuseventctor}
38
39 \func{}{wxChildFocusEvent}{\param{wxWindow *}{win = NULL}}
40
41 Constructor.
42
43 \wxheading{Parameters}
44
45 \docparam{win}{The direct child which is (or which contains the window which is) receiving the focus.}
46
47
48 \membersection{wxChildFocusEvent::GetWindow}\label{wxchildfocuseventgetwindow}
49
50 Returns the direct child which receives the focus, or a (grand-)parent of the control receiving the focus.
51
52 To get the actually focused control use \helpref{wxWindow::FindFocus}{wxwindowfindfocus}