contain element &rest interface-args &key screen process title &allow-other-keys => element
The function
contain
creates and displays a container for the CAPI element
element
.
contain
returns
element
as its result.
contain
is provided as a convenient way of testing CAPI functionality and is useful mainly during interactive development. Many of the CAPI examples use it.
The container is created using make-container, which can make containers for any of the following classes:
simple-pane
layout
interface
pinboard-object
menu
menu-item
menu-component
list
In the case of a
list
, the CAPI tries to see what sort of objects they are and makes an appropriate container. For instance, if they were all simple-panes it would put them into a column-layout.
interface-args
, after removing the arguments
screen
and
process
, are passed to
make-container
as the initargs to the interface.
title
is used as the title of the container.
The values of the arguments screen and process are passed to display when displaying the container.
(capi:contain (make-instance 'capi:text-input-pane))
(capi:contain (make-instance
'capi:column-layout
:description `("Title:"
,(make-instance
'capi:text-input-pane))))
(capi:contain (make-instance 'capi:menu-item)
:title "Test")
CAPI Reference Manual - 15 Dec 2011