diff --git a/docs/latex/wx/cntxtevt.tex b/docs/latex/wx/cntxtevt.tex index 8003df8000..fec04052b8 100644 --- a/docs/latex/wx/cntxtevt.tex +++ b/docs/latex/wx/cntxtevt.tex @@ -1,7 +1,14 @@ \section{\class{wxContextMenuEvent}}\label{wxcontextmenuevent} -This class is used for context menu events, sent to give -the application a chance to show a context (popup) menu. +This class is used for context menu events, sent to give the application a chance to show a context (popup) menu. + +Note that if \helpref{GetPosition}{wxcontextmenueventgetposition} returns wxDefaultPosition, this means that the event originated +from a keyboard context button event, and you should compute a suitable position yourself, +for example by calling \helpref{wxGetMousePosition}{wxgetmouseposition}. + +When a keyboard context menu button is pressed on Windows, a right-click event with default position is sent first, +and if this event is not processed, the context menu event is sent. So if you process mouse events and you find your context menu event handler +is not being called, you could call wxEvent::Skip for mouse right-down events. \wxheading{Derived from} @@ -40,7 +47,11 @@ Constructor. \constfunc{wxPoint}{GetPosition}{\void} -Returns the position at which the menu should be shown. +Returns the position in screen coordinates at which the menu should be shown. Use \helpref{wxWindow::ScreenToClient}{wxwindowscreentoclient} to +convert to client coordinates. You can also omit a position from \helpref{wxWindow::PopupMenu}{wxwindowpopupmenu} in order to use +the current mouse pointer position. + +If the event originated from a keyboard event, the value returned from this function will be wxDefaultPosition. \membersection{wxContextMenuEvent::SetPosition}\label{wxcontextmenueventsetposition} diff --git a/docs/latex/wx/window.tex b/docs/latex/wx/window.tex index 765a7f1905..7a4b1e4b5b 100644 --- a/docs/latex/wx/window.tex +++ b/docs/latex/wx/window.tex @@ -2288,7 +2288,7 @@ default value is {\tt false}.} Pops up the given menu at the specified coordinates, relative to this window, and returns control when the user has dismissed the menu. If a menu item is selected, the corresponding menu event is generated and will be -processed as usually. If the coordinates are not specified, current mouse +processed as usually. If the coordinates are not specified, the current mouse cursor position is used. \wxheading{Parameters}