A menu.
A pane.
The horizontal coordinate of menu 's position relative to owner .
The vertical coordinate of menu 's position relative to owner .
The mouse button that raises the menu.
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.
(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))