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

improved Skip() docs (replaces patch 1516341)

Browse Source 
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@40284 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin
2006-07-24 18:05:32 +00:00
parent a8d69700fc
commit e617d19d32
1 changed files with 13 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
docs/latex/wx/event.tex
View File

@@ -172,13 +172,19 @@ is currently greater than $0$.
\func{void}{Skip}{\param{bool}{ skip = true}} \func{void}{Skip}{\param{bool}{ skip = true}}
Called by an event handler, it controls whether additional event This method can be called by an event handler and controls whether additional
handlers bound to this event will be called after the current event event handlers bound to this event will be called after the current event
handler returns. Skip(false) (the default behavior) will prevent handler returns. The default behavior is equivalent to calling Skip(false)
additional event handlers from being called and control will be (which is, hence, usually unnecessary) and will prevent additional event
returned to the sender of the event immediately after the current handlers from being called and control will be returned to the sender of the
handler has finished. Skip(true) will cause the event processing event immediately after the current handler has finished. If Skip(true) is
system to continue searching for a handler function for this event. called, the event processing system continues searching for a handler
function for this event as if the current handler didn't exist.
In general, it is recommended to skip all non-command events to allow the
default handling to take place. The command events are, however, normally not
skipped as usually a single command such as a button click or menu item
selection must only be processed by one handler.
\membersection{wxEvent::StopPropagation}\label{wxeventstoppropagation} \membersection{wxEvent::StopPropagation}\label{wxeventstoppropagation}