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.

Example

See these files in the examples subdirectory of the LispWorks library:

capi/applications/cocoa-application.lisp

capi/applications/cocoa-application-single-window.lisp

delivery/macos/multiple-window-application.lisp

delivery/macos/single-window-application.lisp

See also

cocoa-default-application-interface