| Allegro CL version 6.2 Unrevised from 6.1 | |||||||||
Arguments: menu-item
Returns the value of the event-synonym property of the
argument menu-item.
The value of this
property, if true, should be the key-chord that
will invoke this menu-item's command, assuming that the keyboard focus
is inside the window whose menu-bar contains this menu-item. An
event-synonym always contains a single main non-shift key, plus an
optional set of one or more shift keys. If no shift keys are used,
then the event-synonym consists entirely of a character name like #\A
or a key name like vk-comma or vk-f3. If shift keys are used, then the
event-synonym is a list whose members are the names of the shift keys
(in any order) and the main non-shift key as the last member. The
available shift key names are control-key, alt-key, and
shift-key,
and they may be used in any combination.
Note that typable characters are normally used only with either control-key or alt-key (or both), since otherwise the characters would not be typable as text (since typing them would activate the menu item rather than entering the character). This is why the first two examples, though legal, are not recommended.
Here are some example event synonyms:
event-synonym is
a property of the menu-item class.
See proxy-menu-bar-window, which can be used to redirect keyboard shortcuts to the menu-bar of another window. See cg-events.htm for information about event handling in Common Graphics.
Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page was not revised from the 6.1 page.
Created 2002.2.26.
| Allegro CL version 6.2 Unrevised from 6.1 | |||||||||