Ensure AutoComp items with no type will set the item's image index to -1.

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

diff --git a/docs/latex/wx/cntxtevt.tex b/docs/latex/wx/cntxtevt.tex
index 8003df8000a0fcd9a148e287f516cbc436fc3b65..3b0ef5b10753e9fcd93db1fe4391cd6d8efbe7fd 100644 (file)
--- a/docs/latex/wx/cntxtevt.tex
+++ b/docs/latex/wx/cntxtevt.tex
@@ -3,6 +3,14 @@
 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}
 
 \helpref{wxCommandEvent}{wxcommandevent}\\
@@ -13,6 +21,10 @@ the application a chance to show a context (popup) menu.
 
 <wx/event.h>
 
+\wxheading{Library}
+
+\helpref{wxCore}{librarieslist}
+
 \wxheading{Event table macros}
 
 To process a menu event, use these event handler macros to direct input to member
@@ -40,7 +52,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}