make-menu-for-pane

make-menu-for-pane Function

Summary

Makes a menu or a menu-component for a pane.

Package

capi

Signature

make-menu-for-pane pane items &key title menu-name component-p => menu

Arguments

`pane`⇩	A pane.
`items`⇩	A list of menu-objects.
`title`⇩	A string or `nil`.
`menu-name`⇩	A string or `nil`.
`component-p`⇩	A boolean.

Values

menu⇩

A menu or a menu-component.

Description

The function make-menu-for-pane makes a menu or a menu-component for the pane pane with the items specified by items.

items should be a list in which each element is a menu-item, menu-component or menu.

title and menu-name provide a title and name for menu. title and menu-name both default to nil.

If component-p is true, then make-menu-for-pane creates a menu-component rather than a menu. The default value of component-p is nil.

menu is set up so that by default each callback inside it is done on the pane pane itself. This is the useful feature of make-menu-for-pane because it avoids the need to set up items to do their callbacks on pane explicitly.

Note that this is merely the default behavior. You can specify different callback behavior on a per-item basis, using setup-callback-argument and callback-data-function (see menu-object), callback-type (see callbacks) and data for menu-item (see item).