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

\section{\class{wxFocusEvent}}\label{wxfocusevent}

A focus event is sent when a window's focus changes. The window losing focus
receives a ``kill focus'' event while the window gaining it gets a ``set
focus'' one.

Notice that the set focus event happens both when the user gives focus to the
window (whether using the mouse or keyboard) and when it is done from the
program itself using \helpref{SetFocus}{wxwindowsetfocus}.

\wxheading{Derived from}

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

\wxheading{Include files}

<wx/event.h>

\wxheading{Event table macros}

To process a focus event, use these event handler macros to direct input to a member
function that takes a wxFocusEvent argument.

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

\wxheading{See also}

\helpref{Event handling overview}{eventhandlingoverview}

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


\membersection{wxFocusEvent::wxFocusEvent}\label{wxfocuseventctor}

\func{}{wxFocusEvent}{\param{WXTYPE }{eventType = 0}, \param{int }{id = 0}}

Constructor.


\membersection{wxFocusEvent::GetWindow}\label{wxfocuseventgetwindow}

Returns the window associated with this event, that is the window which had the
focus before for the \texttt{wxEVT\_SET\_FOCUS} event and the window which is
going to receive focus for the \texttt{wxEVT\_KILL\_FOCUS} one.

Warning: the window pointer may be \texttt{NULL}!
Commit	Line	Data
a660d684 KB	1	\section{\class{wxFocusEvent}}\label{wxfocusevent}
a660d684 KB	2
8204abde VZ	3	A focus event is sent when a window's focus changes. The window losing focus
	4	receives a ``kill focus'' event while the window gaining it gets a ``set
	5	focus'' one.
	6
	7	Notice that the set focus event happens both when the user gives focus to the
	8	window (whether using the mouse or keyboard) and when it is done from the
	9	program itself using \helpref{SetFocus}{wxwindowsetfocus}.
a660d684 KB	10
	11	\wxheading{Derived from}
	12
	13	\helpref{wxEvent}{wxevent}\\
	14	\helpref{wxObject}{wxobject}
	15
954b8ae6 JS	16	\wxheading{Include files}
	17
	18	<wx/event.h>
	19
a660d684 KB	20	\wxheading{Event table macros}
	21
	22	To process a focus event, use these event handler macros to direct input to a member
	23	function that takes a wxFocusEvent argument.
	24
	25	\twocolwidtha{7cm}
	26	\begin{twocollist}\itemsep=0pt
	27	\twocolitem{{\bf EVT\_SET\_FOCUS(func)}}{Process a wxEVT\_SET\_FOCUS event.}
	28	\twocolitem{{\bf EVT\_KILL\_FOCUS(func)}}{Process a wxEVT\_KILL\_FOCUS event.}
	29	\end{twocollist}%
	30
	31	\wxheading{See also}
	32
a660d684 KB	33	\helpref{Event handling overview}{eventhandlingoverview}
	34
	35	\latexignore{\rtfignore{\wxheading{Members}}}
	36
35b92f05	37
b236c10f	38	\membersection{wxFocusEvent::wxFocusEvent}\label{wxfocuseventctor}
a660d684 KB	39
	40	\func{}{wxFocusEvent}{\param{WXTYPE }{eventType = 0}, \param{int }{id = 0}}
	41
	42	Constructor.
	43
35b92f05 VZ	44
	45	\membersection{wxFocusEvent::GetWindow}\label{wxfocuseventgetwindow}
	46
	47	Returns the window associated with this event, that is the window which had the
	48	focus before for the \texttt{wxEVT\_SET\_FOCUS} event and the window which is
	49	going to receive focus for the \texttt{wxEVT\_KILL\_FOCUS} one.
	50
	51	Warning: the window pointer may be \texttt{NULL}!
	52