set-application-interface Function

Summary

Specifies the main Cocoa application interface.

Package

capi

Signature

set-application-interface interface

Arguments

interface⇩

An object of type cocoa-default-application-interface.

Description

The function set-application-interface sets interface as the main application interface. This interface is used to supply the application menu and receives various callbacks associated with the application.

set-application-interface must be called before any CAPI functions that make the screen object (such as convert-to-screen and display).

interface should not be displayed like a normal interface.

An application can only have one application menu and one dock menu. Because the LispWorks IDE already provides these menus, calling set-application-interface while running the LispWorks IDE will add a submenu to the LispWorks application menu to contain the application-menu and menu-bar-items of your application, and you can test them there. Likewise, a submenu will be added to the LispWorks Dock icon menu. Other aspects of the application interface can only be tested when running it standalone.

set-application-interface is only applicable when running under Cocoa.

Examples

(example-edit-file "capi/applications/cocoa-application")

(example-edit-file "capi/applications/cocoa-application-single-window")

(example-edit-file "delivery/macos/multiple-window-application")

(example-edit-file "delivery/macos/single-window-application")

See also

cocoa-default-application-interface