Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

added discussion of user-generated vs programmatic events

Browse Source 
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@41891 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin
2006-10-10 13:42:04 +00:00
parent 250e4028f8
commit e0c664bf08
1 changed files with 25 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
docs/latex/wx/tevent.tex
View File

@@ -219,6 +219,31 @@ used by, the native controls in a dialog. In this case, a special event handler
will have to be written that will override ProcessEvent() in order to pass will have to be written that will override ProcessEvent() in order to pass
all events (or any selection of them) to the parent window. all events (or any selection of them) to the parent window.
\subsection{Events generated by the user vs programmatically generated events}\label{progevent}
While generically \helpref{wxEvents}{wxevent} can be generated both by user
actions (e.g. resize of a \helpref{wxWindow}{wxwindow}) and by calls to functions
(e.g. \helpref{wxWindow::SetSize}{wxwindowsetsize}), wxWidgets controls
normally send \helpref{wxCommandEvent}{wxcommandevent}-derived events only for
the user-generated events. The only {\bf exceptions} to this rule are:
\begin{twocollist}\itemsep=0pt
\twocolitem{\helpref{wxNotebook::AddPage}{wxnotebookaddpage}}{No event-free alternatives}
\twocolitem{\helpref{wxNotebook::AdvanceSelection}{wxnotebookadvanceselection}}{No event-free alternatives}
\twocolitem{\helpref{wxNotebook::DeletePage}{wxnotebookdeletepage}}{No event-free alternatives}
\twocolitem{\helpref{wxNotebook::SetSelection}{wxnotebooksetselection}}{Use \helpref{wxNotebook::ChangeSelection}{wxnotebookchangeselection} instead, as \helpref{wxNotebook::SetSelection}{wxnotebooksetselection} is deprecated}
\twocolitem{\helpref{wxTreeCtrl::Delete}{wxtreectrldelete}}{No event-free alternatives}
\twocolitem{\helpref{wxTreeCtrl::DeleteAllItems}{wxtreectrldeleteallitems}}{No event-free alternatives}
\twocolitem{\helpref{wxTreeCtrl::EditLabel}{wxtreectrleditlabel}}{No event-free alternatives}
\twocolitem{All \helpref{wxTextCtrl}{wxtextctrl} methods}
{\helpref{wxTextCtrl::ChangeValue}{wxtextctrlchangevalue} can be used instead
of \helpref{wxTextCtrl::SetValue}{wxtextctrlsetvalue} but the other functions,
such as \helpref{Replace}{wxtextctrlreplace} or \helpref{WriteText}{wxtextctrlwritetext}
don't have event-free equivalents}
\end{twocollist}
% VZ: it doesn't work like this, but just in case we ever reenable this % VZ: it doesn't work like this, but just in case we ever reenable this
% behaviour, I leave it here % behaviour, I leave it here
% %