make list whose items are referred to by their numbers in the text really numbered; fix a few typos (#9550)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@54025 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -29,7 +29,7 @@ Classes: wxEvtHandler, wxWindow, wxEvent
|
|||||||
@section overview_eventhandling_introduction Introduction
|
@section overview_eventhandling_introduction Introduction
|
||||||
|
|
||||||
There are two principal ways to handle events in wxWidgets. One of them uses
|
There are two principal ways to handle events in wxWidgets. One of them uses
|
||||||
<em>event table</em> macros and allows to define the connection between events
|
<em>event table</em> macros and allows you to define the connection between events
|
||||||
and their handlers only statically, i.e. during program compilation. The other
|
and their handlers only statically, i.e. during program compilation. The other
|
||||||
one uses wxEvtHandler::Connect() call and can be used to connect, and
|
one uses wxEvtHandler::Connect() call and can be used to connect, and
|
||||||
disconnect, the handlers dynamically, i.e. during run-time depending on some
|
disconnect, the handlers dynamically, i.e. during run-time depending on some
|
||||||
@@ -331,21 +331,21 @@ void MyTextCtrl::OnChar(wxKeyEvent& event)
|
|||||||
@endcode
|
@endcode
|
||||||
|
|
||||||
The normal order of event table searching by ProcessEvent is as follows:
|
The normal order of event table searching by ProcessEvent is as follows:
|
||||||
|
<ol>
|
||||||
@li If the object is disabled (via a call to wxEvtHandler::SetEvtHandlerEnabled)
|
<li> If the object is disabled (via a call to wxEvtHandler::SetEvtHandlerEnabled)
|
||||||
the function skips to step (6).
|
the function skips to step (6).
|
||||||
@li If the object is a wxWindow, @b ProcessEvent is recursively called on the window's
|
<li> If the object is a wxWindow, @b ProcessEvent is recursively called on the window's
|
||||||
wxValidator. If this returns @true, the function exits.
|
wxValidator. If this returns @true, the function exits.
|
||||||
@li @b SearchEventTable is called for this event handler. If this fails, the base
|
<li> @b SearchEventTable is called for this event handler. If this fails, the base
|
||||||
class table is tried, and so on until no more tables exist or an appropriate
|
class table is tried, and so on until no more tables exist or an appropriate
|
||||||
function was found, in which case the function exits.
|
function was found, in which case the function exits.
|
||||||
@li The search is applied down the entire chain of event handlers (usually the chain has
|
<li> The search is applied down the entire chain of event handlers (usually the chain has
|
||||||
a length of one). If this succeeds, the function exits.
|
a length of one). If this succeeds, the function exits.
|
||||||
@li If the object is a wxWindow and the event is set to set to propagate (in the library only
|
<li> If the object is a wxWindow and the event is set to set to propagate (in the library only
|
||||||
wxCommandEvent based events are set to propagate), @b ProcessEvent is recursively applied
|
wxCommandEvent based events are set to propagate), @b ProcessEvent is recursively applied
|
||||||
to the parent window's event handler. If this returns @true, the function exits.
|
to the parent window's event handler. If this returns @true, the function exits.
|
||||||
@li Finally, @b ProcessEvent is called on the wxApp object.
|
<li> Finally, @b ProcessEvent is called on the wxApp object.
|
||||||
|
</ol>
|
||||||
<b>Pay close attention to Step 5</b>. People often overlook or get
|
<b>Pay close attention to Step 5</b>. People often overlook or get
|
||||||
confused by this powerful feature of the wxWidgets event processing
|
confused by this powerful feature of the wxWidgets event processing
|
||||||
system. To put it a different way, events set to propagate
|
system. To put it a different way, events set to propagate
|
||||||
@@ -488,7 +488,7 @@ as well. The automatically generated identifiers are always negative and so
|
|||||||
will never conflict with the user-specified identifiers which must be always
|
will never conflict with the user-specified identifiers which must be always
|
||||||
positive.
|
positive.
|
||||||
|
|
||||||
See @ref page_stdevtid for the list of standard identifiers availabel.
|
See @ref page_stdevtid for the list of standard identifiers available.
|
||||||
You can use wxID_HIGHEST to determine the number above which it is safe to
|
You can use wxID_HIGHEST to determine the number above which it is safe to
|
||||||
define your own identifiers. Or, you can use identifiers below wxID_LOWEST.
|
define your own identifiers. Or, you can use identifiers below wxID_LOWEST.
|
||||||
Finally, you can allocate identifiers dynamically using wxNewId() function to.
|
Finally, you can allocate identifiers dynamically using wxNewId() function to.
|
||||||
|
Reference in New Issue
Block a user