Updated info on handlers

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

diff --git a/docs/latex/wx/cmdevent.tex b/docs/latex/wx/cmdevent.tex
index 66fa145ec2db176398845039a708215d984a1a1e..973f3956de83b6efa36bad1df17e950a0158739a 100644 (file)
--- a/docs/latex/wx/cmdevent.tex
+++ b/docs/latex/wx/cmdevent.tex
@@ -36,7 +36,9 @@ which is generated by a wxListBox control.}
 \twocolitem{{\bf EVT\_TEXT(id, func)}}{Process a wxEVT\_COMMAND\_TEXT\_UPDATED command,
 which is generated by a wxTextCtrl control.}
 \twocolitem{{\bf EVT\_TEXT\_ENTER(id, func)}}{Process a wxEVT\_COMMAND\_TEXT\_ENTER command,
 \twocolitem{{\bf EVT\_TEXT(id, func)}}{Process a wxEVT\_COMMAND\_TEXT\_UPDATED command,
 which is generated by a wxTextCtrl control.}
 \twocolitem{{\bf EVT\_TEXT\_ENTER(id, func)}}{Process a wxEVT\_COMMAND\_TEXT\_ENTER command,

-which is generated by a wxTextCtrl control.}
+which is generated by a wxTextCtrl control. Note that you must use
+wxTE\_PROCESS\_ENTER flag when creating the control if you want it to generate
+such events.}

 \twocolitem{{\bf EVT\_MENU(id, func)}}{Process a wxEVT\_COMMAND\_MENU\_SELECTED command,
 which is generated by a menu item.}
 \twocolitem{{\bf EVT\_MENU\_RANGE(id1, id2, func)}}{Process a wxEVT\_COMMAND\_MENU\_RANGE command,
 \twocolitem{{\bf EVT\_MENU(id, func)}}{Process a wxEVT\_COMMAND\_MENU\_SELECTED command,
 which is generated by a menu item.}
 \twocolitem{{\bf EVT\_MENU\_RANGE(id1, id2, func)}}{Process a wxEVT\_COMMAND\_MENU\_RANGE command,


@@ -80,10 +82,10 @@ which is generated by a control.}
 
 \membersection{wxCommandEvent::m\_clientData}
 
 
 \membersection{wxCommandEvent::m\_clientData}
 

-\member{char*}{m\_clientData}
+\member{void*}{m\_clientData}

 
 Contains a pointer to client data for listboxes and choices, if the event
 
 Contains a pointer to client data for listboxes and choices, if the event

-was a selection.
+was a selection. Beware, this is not implemented anyway...

 
 \membersection{wxCommandEvent::m\_commandInt}
 
 
 \membersection{wxCommandEvent::m\_commandInt}
 


@@ -117,13 +119,13 @@ Constructor.
 
 \membersection{wxCommandEvent::Checked}
 
 
 \membersection{wxCommandEvent::Checked}
 

-\func{bool}{Checked}{\void}
+\constfunc{bool}{Checked}{\void}

 
 

-Returns TRUE or FALSE for a checkbox selection event.
+Deprecated, use \helpref{IsChecked}{wxcommandeventischecked} instead.

 
 \membersection{wxCommandEvent::GetClientData}
 
 
 \membersection{wxCommandEvent::GetClientData}
 

-\func{char*}{GetClientData}{\void}
+\func{void*}{GetClientData}{\void}

 
 Returns client data pointer for a listbox or choice selection event
 (not valid for a deselection).
 
 Returns client data pointer for a listbox or choice selection event
 (not valid for a deselection).


@@ -154,6 +156,16 @@ a deselection).
 Returns item string for a listbox or choice selection event (not valid for
 a deselection).
 
 Returns item string for a listbox or choice selection event (not valid for
 a deselection).
 

+\membersection{wxCommandEvent::IsChecked}\label{wxcommandeventischecked}
+
+\constfunc{bool}{IsChecked}{\void}
+
+This method can be used with checkbox and menu events: for the checkboxes, the
+method returns {\tt TRUE} for a selection event and {\tt FALSE} for a
+deselection one. For the menu events, this method indicates if the menu item
+just has become checked or unchecked (and thus only makes sense for checkable
+menu items).
+

 \membersection{wxCommandEvent::IsSelection}
 
 \func{bool}{IsSelection}{\void}
 \membersection{wxCommandEvent::IsSelection}
 
 \func{bool}{IsSelection}{\void}


@@ -163,7 +175,7 @@ is a deselection.
 
 \membersection{wxCommandEvent::SetClientData}
 
 
 \membersection{wxCommandEvent::SetClientData}
 

-\func{void}{SetClientData}{\param{char*}{ clientData}}
+\func{void}{SetClientData}{\param{void*}{ clientData}}

 
 Sets the client data for this event.
 
 
 Sets the client data for this event.