applied doc patch for wxPostEvent().
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@14361 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
@@ -2262,21 +2262,11 @@ Now obsolete: use \helpref{wxWindow::Close}{wxwindowclose} instead.
|
|||||||
|
|
||||||
\func{void}{wxPostEvent}{\param{wxEvtHandler *}{dest}, \param{wxEvent\& }{event}}
|
\func{void}{wxPostEvent}{\param{wxEvtHandler *}{dest}, \param{wxEvent\& }{event}}
|
||||||
|
|
||||||
This function posts the event to the specified {\it dest} object. The
|
In a GUI application, this function posts {\it event} to the specified {\it dest}
|
||||||
difference between sending an event and posting it is that in the first case
|
object using \helpref{wxEvtHandler::AddPendingEvent}{wxevthandleraddpendingevent}.
|
||||||
the event is processed before the function returns (in wxWindows, event sending
|
Otherwise, it dispatches {\it event} immediately using
|
||||||
is done with \helpref{ProcessEvent}{wxevthandlerprocessevent} function), but in
|
\helpref{wxEvtHandler::ProcessEvent}{wxevthandlerprocessevent}.
|
||||||
the second, the function returns immediately and the event will be processed
|
See the respective documentation for details (and caveats).
|
||||||
sometime later - usually during the next even loop iteration.
|
|
||||||
|
|
||||||
Note that a copy of the {\it event} is made by the function, so the original
|
|
||||||
copy can be deleted as soon as function returns. This function can also be used
|
|
||||||
to send events between different threads safely. As this function makes a
|
|
||||||
copy of the event, the event needs to have a fully implemented Clone() method,
|
|
||||||
which may not be the case for all event in wxWindows.
|
|
||||||
|
|
||||||
See also \helpref{AddPendingEvent}{wxevthandleraddpendingevent} (which this function
|
|
||||||
uses internally).
|
|
||||||
|
|
||||||
\wxheading{Include files}
|
\wxheading{Include files}
|
||||||
|
|
||||||
|
Reference in New Issue
Block a user