X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/571d991bb3232f0dcd3319dbdc9d35e5c80f4c71..438959cca892a7651634cc3a7aad4819ac49b23c:/include/wx/uiaction.h

diff --git a/include/wx/uiaction.h b/include/wx/uiaction.h
index e662b2c3c3..5170170dc9 100644
--- a/include/wx/uiaction.h
+++ b/include/wx/uiaction.h
@@ -4,7 +4,7 @@
 // Author:      Kevin Ollivier, Steven Lamerton, Vadim Zeitlin
 // Modified by:
 // Created:     2010-03-06
-// RCS-ID:      $Id: menu.cpp 54129 2008-06-11 19:30:52Z SC $
+// RCS-ID:      $Id$
 // Copyright:   (c) Kevin Ollivier
 //              (c) 2010 Steven Lamerton
 //              (c) 2010 Vadim Zeitlin
@@ -58,8 +58,8 @@ public:
         { return Key(keycode, modifiers, false); }
 
     // Higher level methods for generating both the key press and release for a
-    // single key or for all characters in the ASCII string "text" which can
-    // currently contain letters only (no digits, no punctuation).
+    // single key or for all characters in the ASCII string "text" which can currently
+    // contain letters, digits and characters for the definition of numbers [+-., ].
     bool Char(int keycode, int modifiers = wxMOD_NONE);
 
     bool Text(const char *text);
@@ -70,11 +70,17 @@ private:
     // implementation level it makes more sense to have them in a single
     // function.
     //
-    // This is a simple wrapper verifying the input parameters validity around
-    // the platform-specific DoKey() method implemented in platform-specific
-    // files.
+    // It calls DoModifiers() to simulate pressing the modifier keys if
+    // necessary and then DoKey() for the key itself.
     bool Key(int keycode, int modifiers, bool isDown);
 
+    // Call DoKey() for all modifier keys whose bits are set in the parameter.
+    void SimulateModifiers(int modifier, bool isDown);
+
+
+    // The low-level port-specific function which really generates the key
+    // presses. It should generate exactly one key event with the given
+    // parameters.
     bool DoKey(int keycode, int modifiers, bool isDown);
 };