, a menu, or a function designator.
If you wish to override the defaults, then you should first define a subclass of
with your changes. Then set a single instance of this subclass as the application interface by calling set-application-interface before any CAPI functions that make the screen object (such as convert-to-screen and display).
Do not call display with a subclass of
- the application interface does not have a window on the screen and should be created in addition to the visible interfaces in your application.
message-callback will be called for various application messages. The interface argument will be the application interface and the message argument will be a keyword. The message argument will be one of the following:
This message is invoked when the user double-clicks on a document associated with the application or drags a document into the application icon. The args contain the name of the file to open.
This message is invoked just after the user has started the application and all other initialization has been done (including any
message if applicable). You can use it to open a default document for example. There are no
controls the application's main menu. If this is
, then a minimal application menu will be made using the title of the application interface, otherwise it should be a menu containing the usual items or the name of a slot containing such a menu in the application interface. Note that the
item in the
needs to call destroy on the interface, rather than call
provides a menu for use by the Mac OS X Dock icon. If the value is
(the default), then the standard menu is used. If
is a function designator, it is called with the application interface as its argument when the menu is popped up and should return a menu. Otherwise
should be a menu, which is used directly. The Dock will add the standard items such as
to the end of the menu you supply.
interface initargs are interpreted as follows:
:hiddenif the whole application is hidden and will return
(setf top-level-interface-display-state)can be used to perform some operations typically found on the application menu.
Show the application and activate it
Show the application again without activating it
CAPI Reference Manual - 15 Dec 2011