Function

Summary

Displays a window containing an element.

Package

capi

Signature

contain element &rest interface-args &key screen process title &allow-other-keys => element

Description

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.

Example

(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")

See also

make-container
display
element