Generic FunctionPackage: cgToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
Unrevised from 8.0 to 8.1.
8.0 version

pop-up-shortcut-menu

Arguments: window

Pops up a menu for window if the shortcut-commands method for window returns a list of menu-items. Does nothing if shortcut-commands instead returns nil, which is the default case.

The default mouse-right-down methods for basic-pane and dialog-item call this function on the window that was clicked. (If a dialog-item is right-clicked, window will be the window of the dialog-item rather than the dialog-item itself.) The default virtual-key-down method for basic-pane calls this function as well when the "context menu key" is pressed (see vk-applications).

Compatibility note: in releases through 6.1, the default mouse-right-down methods called pop-up-shortcut-menu only in the IDE, and not in generated standalone applications. Now, as said above, mouse-right-down calls pop-up-shortcut-menu is both cases. This might change the default behavior of an application only if the application defined shortcut-commands methods.

This function creates (and later closes) a menu which is an instance of the class returned by the shortcut-menu-class method for window. By default, this is the shortcut-menu class, whose on-click function is default-menu-on-click. So in the default case, the value of each menu-item should be as described under default-menu-on-click. Alternately, a shortcut-menu-class method could be defined that uses a different on-click function.


Copyright (c) 1998-2009, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.1. This page was not revised from the 8.0 page.
Created 2009.7.29.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.1
Unrevised from 8.0 to 8.1.
8.0 version