All Manuals > CAPI Reference Manual > 1 CAPI Reference Entries

NextPrevUpTopContentsIndex

display-popup-menu

Function
Summary

Displays a popup menu.

Package

capi

Signature

display-popup-menu menu &key owner x y button => result

Arguments

menu

A menu.

owner

A pane.

x

The horizontal coordinate of menu 's position relative to owner .

y

The vertical coordinate of menu 's position relative to owner .

button

The mouse button that raises the menu.

Description

The function display-popup-menu displays the menu menu at position x , y . display-popup-menu should be used in response to the user clicking a mouse button, and is typically used to implement contextual ("right button") menus.

The user may select an item in the menu, in which case the item's selection-callback is invoked, and display-popup-menu returns t .

Alternatively the user may cancel the menu, by clicking elsewhere or pressing the Escape key. In this case, display-popup-menu returns nil .

owner specifies the owner of the menu, that is, a pane that the menu is associated with. If owner is not supplied the system trys to find the appropriate owner, which usually suffices.

x and y default to the horizontal and vertical coordinates, relative to owner, of the location of the mouse pointer.

button defaults to :button-3 .

Example
(defun popup-test-menu (pinboard x y &optional gspec)
  (capi:display-popup-menu
   (make-instance 'capi:menu :items '(1 2 3))
   :owner pinboard :x x :y y))
(capi:contain 
 (make-instance 'capi:pinboard-layout
                :input-model 
                '((:post-menu popup-test-menu))
                :visible-min-width 100
                :visible-min-height 100))
See also

menu
pinboard-layout


CAPI Reference Manual - 15 Dec 2011

NextPrevUpTopContentsIndex