summaryrefslogtreecommitdiff
path: root/documentation/Fl_Menu_.html
diff options
context:
space:
mode:
authorMatthias Melcher <fltk@matthiasm.com>2003-07-18 05:53:21 +0000
committerMatthias Melcher <fltk@matthiasm.com>2003-07-18 05:53:21 +0000
commit4042047358c4a9ebb8f61007ec27c7f66fd0a79e (patch)
tree586cc59db657251c68e9bb3b32dbdac132c65b2b /documentation/Fl_Menu_.html
parent91721061895a16fea93a866061e632c8a6556088 (diff)
updated documentation and Fl_Dial. STR #101, 94, 99
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@3049 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'documentation/Fl_Menu_.html')
-rw-r--r--documentation/Fl_Menu_.html22
1 files changed, 21 insertions, 1 deletions
diff --git a/documentation/Fl_Menu_.html b/documentation/Fl_Menu_.html
index bc34198f6..7a1bbe7f5 100644
--- a/documentation/Fl_Menu_.html
+++ b/documentation/Fl_Menu_.html
@@ -111,7 +111,9 @@ item at the end. To copy a menu array you need to copy
<TT>NULL</TT> this returns zero (an empty menu will return 1).
<H4><A name=Fl_Menu_.add>int Fl_Menu_::add(const char* label, const
-char* shortcut, Fl_Callback*, void *user_data=0, int flags=0)</a></h4>
+char* shortcut, Fl_Callback*, void *user_data=0, int flags=0)</a><br>
+int Fl_Menu_::add(const char* label, int shortcut, Fl_Callback*,
+void *user_data=0, int flags=0)</h4>
Adds a new menu item, with a <TT>title</TT> string, <TT> shortcut</TT>
string, <TT>callback</TT>, argument to the callback, and flags. If
@@ -129,6 +131,24 @@ this new one. Otherwise this new one is added to the end of the
correct menu or submenu. The return value is the offset into the array
that the new entry was placed at.</P>
+<P>Shortcut can be 0L, or either a modifier/key combination (for example
+FL_CTRL+'A') or a string describing the shortcut in one of two ways:</p>
+
+<pre>
+ [#+^]<ascii_value>     eg. "97", "^97", "+97", "#97"
+ [#+^]<ascii_char>      eg. "a", "^a", "+a", "#a"
+</pre>
+..where <ascii_value> is a decimal value representing an ascii character
+(eg. 97 is the ascii for 'a'), and the optional prefixes enhance the value
+that follows. Multiple prefixes must appear in the above order.
+<pre>
+ # - Alt
+ + - Shift
+ ^ - Control
+</pre>
+Text shortcuts are converted to integer shortcut by calling
+<tt>int fl_old_shortcut(const char*)</tt>.
+
<P>The return value is the index into the array that the entry was put. </P>
<h4>int Fl_Menu_::add(const char *)</H4>