interface-menu-groups Generic Function

Summary

Used when an embedded document sets the menu-bar-items to its menus, on Microsoft Windows.

Package

capi

Signature

interface-menu-groups interface => result

Arguments

interface⇩

A CAPI interface.

Values

result

A list.

Description

The generic function interface-menu-groups is called when an embedded document sets the menu bar of its containing interface interface. It is called when an embedded object uses the IOleInPlaceFrame::InsertMenus method to add menus from the interface to its own composite menu, which is used as the menubar while the embedded object is active.

The menu bar for the embedded document includes three groups of menus that are supplied by the container (file-group, view-group, windows-group). interface-menu-groups is used to define these groups of menus.

interface-menu-groups should return a list of length 3. Each element is a list of menus. In this list, each item is either a menu object, or a cons. When it is a cons, the car is a menu object and the cdr is a string, which overrides the the title of the menu.

The default method, specialied on interface, simply returns (nil nil nil).

Notes

interface-menu-groups is implemented only in LispWorks for Windows. Load the functionality by (require "embed").

See also

ole-control-pane