[wxWidgets.git] / docs / latex / wx / chfocevt.tex

\section{\class{wxChildFocusEvent}}\label{wxchildfocusevent}

A child focus event is sent to a (parent-)window when one of its child windows gains focus,
so that the window could restore the focus back to its corresponding child
if it loses it now and regains later.

Notice that child window is the direct child of the window receiving event.
Use \helpref{FindFocus}{wxwindowfindfocus} to retreive the window which is actually getting focus. 

\wxheading{Derived from}

\helpref{wxCommandEvent}{wxcommandevent}\\
\helpref{wxEvent}{wxevent}\\
\helpref{wxObject}{wxobject}

\wxheading{Include files}

<wx/event.h>

\wxheading{Event table macros}

To process a child focus event, use this event handler macro to direct input to a member
function that takes a wxChildFocusEvent argument.

\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf EVT\_CHILD\_FOCUS(func)}}{Process a wxEVT\_CHILD\_FOCUS event.}
\end{twocollist}%

\wxheading{See also}

\helpref{Event handling overview}{eventhandlingoverview}

\latexignore{\rtfignore{\wxheading{Members}}}


\membersection{wxChildFocusEvent::wxChildFocusEvent}\label{wxchildfocuseventctor}

\func{}{wxChildFocusEvent}{\param{wxWindow *}{win = NULL}}

Constructor.

\wxheading{Parameters}

\docparam{win}{The direct child which is (or which contains the window which is) receiving the focus.}


\membersection{wxChildFocusEvent::GetWindow}\label{wxchildfocuseventgetwindow}

Returns the direct child which receives the focus, or a (grand-)parent of the control receiving the focus.

To get the actually focused control use \helpref{wxWindow::FindFocus}{wxwindowfindfocus}.
Commit	Line	Data
66ad556c VZ	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.
776eb3d7	8	Use \helpref{FindFocus}{wxwindowfindfocus} to retreive the window which is actually getting focus.
66ad556c VZ	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
b67a86d5 JS	52	To get the actually focused control use \helpref{wxWindow::FindFocus}{wxwindowfindfocus}.
b67a86d5 JS	53