on-menu-char

If the frame has a menu bar with keyboard shortcuts, on-menu-char attempts to match the given event to a menu item. If a match is found, #t is returned, otherwise #f is returned.

When the match corresponds to a complete shortcut combination, the menu item's callback is called (before on-menu-char returns). A match may also correspond to a shortcut prefix (under X, when when prefix style is 'ctl-m; see set-x-shortcut-prefix ), in which case the prefix key event is consumed and #t is returned, but the menu item's callback is not called until the shortcut is completed (if it is completed).

If the event does not correspond to a complete shortcut combination, the event may be handled anyway if it correponds to a mnemonic in the menu bar (i.e., an underlined letter in a menu's title, which is installed by including an ampersand in the menu's label). If a mnemonic match is found, the keyboard focus is moved to the menu bar (selecting the menu with the mnemonic), and #t is returned.

• (send a-frame on-menu-char event) -> boolean
      event : key-event% object