no changes, just come cleanup and more comments

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

diff --git a/docs/latex/wx/helpevt.tex b/docs/latex/wx/helpevt.tex
index ed8f7836ed4bbacada9bac60d23bfa6138634963..9e79145b5b90db20f08315b9f1f51d12b1ebe928 100644 (file)
--- a/docs/latex/wx/helpevt.tex
+++ b/docs/latex/wx/helpevt.tex
@@ -10,7 +10,7 @@ A help event is sent to the window that the user clicked on, and is propagated u
 window hierarchy until the event is processed or there are no more event handlers.
 The application should call wxEvent::GetId to check the identity of the clicked-on window,
 and then either show some suitable help or call wxEvent::Skip if the identifier is unrecognised.
-Calling Skip is important because it allows wxWindows to generate further events for ancestors
+Calling Skip is important because it allows wxWidgets to generate further events for ancestors
 of the clicked-on window. Otherwise it would be impossible to show help for container windows,
 since processing would stop after the first window found.
 
@@ -24,6 +24,10 @@ since processing would stop after the first window found.
 
 <wx/event.h>
 
+\wxheading{Library}
+
+\helpref{wxCore}{librarieslist}
+
 \wxheading{Event table macros}
 
 To process an activate event, use these event handler macros to direct input to a member
@@ -43,13 +47,37 @@ function that takes a wxHelpEvent argument.
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxHelpEvent::wxHelpEvent}
+\membersection{wxHelpEvent::wxHelpEvent}\label{wxhelpeventctor}
 
-\func{}{wxHelpEvent}{\param{WXTYPE }{eventType = 0}, \param{bool}{ active = TRUE}, \param{wxWindowID }{id = 0},
+\func{}{wxHelpEvent}{\param{WXTYPE }{eventType = 0}, \param{wxWindowID }{id = 0},
  \param{const wxPoint\& }{point}}
 
 Constructor.
 
+\membersection{wxHelpEvent::GetOrigin}\label{wxhelpeventgetorigin}
+
+\constfunc{wxHelpEvent::Origin }{GetOrigin}{\void}
+
+Returns the origin of the help event which is one of the following values:
+
+\twocolwidtha{7cm}
+\begin{twocollist}\itemsep=0pt
+\twocolitem{{\bf Origin\_Unknown}}{Unrecognized event source.}
+\twocolitem{{\bf Origin\_Keyboard}}{Event generated by \texttt{F1} key press.}
+\twocolitem{{\bf Origin\_HelpButton}}{Event generated by 
+\helpref{wxContextHelp}{wxcontexthelp} or using the "?" title bur button under
+MS Windows.}
+\end{twocollist}
+
+The application may handle events generated using the keyboard or mouse
+differently, e.g. by using \helpref{wxGetMousePosition()}{wxgetmouseposition} 
+for the mouse events.
+
+\wxheading{See also}
+
+\helpref{wxHelpEvent::SetOrigin}{wxhelpeventsetorigin}
+
+
 \membersection{wxHelpEvent::GetPosition}\label{wxhelpeventgetposition}
 
 \constfunc{const wxPoint\&}{GetPosition}{\void}
@@ -57,6 +85,17 @@ Constructor.
 Returns the left-click position of the mouse, in screen coordinates. This allows
 the application to position the help appropriately.
 
+\membersection{wxHelpEvent::SetOrigin}\label{wxhelpeventsetorigin}
+
+\func{void}{SetOrigin}{\param{wxHelpEvent::Origin }{origin}}
+
+Set the help event origin, only used internally by wxWidgets normally.
+
+\wxheading{See also}
+
+\helpref{wxHelpEvent::GetOrigin}{wxhelpeventgetorigin}
+
+
 \membersection{wxHelpEvent::SetPosition}\label{wxhelpeventsetposition}
 
 \func{void}{SetPosition}{\param{const wxPoint\&}{ pt}}