8.11 DUIM-Gadgets Module

make-menu-from-items

Generic function

Summary

Returns a menu object created from the specified items.

Signature

make-menu-from-items framem items #key owner title label-key value-key foreground background text-style => menu

Arguments

framem: An instance of type <frame-manager>.
items: An instance of type <sequence>.
owner: An instance of type <sheet>.
title: An instance of type <string>.
label-key: An instance of <function>. Default value: identity.
value-key: An instance of <function>. Default value: identity.
foreground: An instance of type false-or(<ink>). Default value: #f.
background: An instance of type false-or(<ink>). Default value: #f.
text-style: An instance of type <text-style>.

Values

menu: An instance of type <menu>.

Library

duim-gadgets

Module

duim-gadgets

Description

Returns a menu object created from the specified items.

The framem argument lets you specify a frame manager.

The owner argument is used to specify which sheet owns the menu. If you fail to supply this, then the menu will be owned by the entire screen.

You can specify a title, if desired.

The label-key and value-key can be functions used to compute the label and value for each item in the menu, respectively. For more information, see gadget-label-key, page 570, or gadget-value-key, page 589. In general, the label key can be trusted to "do the right thing" by default.

The text-style argument specified a text style for the menu. The foreground and background arguments specify foreground and background colors for the menu: foreground being used for the text in the menu, and background for the menu itself.