Function

Summary

The display function displays a CAPI interface on a specified screen.

Package

capi

Signature

display interface &key screen process owner

Arguments

interface

A CAPI interface.

screen

A screen.

process

A mp:process , t or nil .

owner

A CAPI interface.

Description

The function display displays the CAPI interface interface on the specified screen (or the current one if not supplied).

If process is not supplied, then if owner is supplied interface runs in owner 's process, otherwise interface runs in the process of the parent of interface if it is a document-container, or in a new process created for interface if not.

If process is supplied, then interface runs in a newly-created process if process is t . This is the default value. If process is nil , interface runs in the current process. Otherwise, process is expected to be a CAPI process, and interface runs in it. Note that you should operate on a CAPI interface only in its own process.

owner specifies an owner for interface , which should be another CAPI interface. interface inherits a number of attributes from owner , including the default process, default screen and default display state.

Note: Use the function contain to display objects other than interfaces.

Note: A generic function interface-display is called immediately after display displays an interface. You can add post-display code by defining your own :after method.

Example

(capi:display (make-instance 'capi:interface

                             :title "Test"))

See also

contain
display-dialog
document-container
execute-with-interface
interface
interface-display
quit-interface
*update-screen-interfaces-hooks*