Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.2
This page is new in 8.2.


Arguments: menu

This menu property has an effect only on the GTK platform.

If nil (the default), then keyboard shortcuts for menu commands will be handled using GTK's own facility for shortcuts. This allows the shortcut strings to be neatly right-aligned on the menus. But it means that GTK will always handle a menu command shortcut, and not allow Common Graphics to override that behavior in certain cases. In particular, a shortcut will still invoke a menu-item when a modal dialog is present, even if the menu-item's allow-during-modality property is nil to prevent just that. Also, a graphical keyboard shortcut that does not include either the Control key or the Alt key would prevent the user from typing the shortcut character into a text-editing widget. And the rather obscure proxy-menu-bar-window feature would not work. nil is nevertheless the default value, on the assumption that most applications will not use these particular other Common Graphics features, and would prefer normal-looking menus.

If true, then all Common Graphics menu functionality such as allow-during-modality will work as documented. But the shortcut strings will not be neatly right-aligned on the menus.

Mac OS X note: On the Mac, the default value of this property is currently true, due to an unsolved problem with using native GTK shortcuts. The value could still be set to nil for nicer looking menu strings, but if a menu bar contains both a control-foo shortcut and a control-alt-foo shortcut, then typing the control-alt-foo shortcut would actually invoke the menu command for the control-foo shortcut.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page is new in the 8.2 release.
Created 2016.6.21.

Allegro CL version 8.2
This page is new in 8.2.