1 CAPI Reference Entries

contact-pane

Summary

The classcontact-pane is provided as a means of using CLUE contacts in a CAPI interface.

Superclasses

titled-pane

Slots

contact

The contact (when created).

contact-initargs-function

Initialization arguments for the contact.

Accessors

contact-pane-contact-initargs-function

Readers

contact-pane-contact

Description

The CAPI cannot use CLUE contacts in its layout hierarchies, so the macrodefine-contact-pane is used to create a CAPI version of a contact, which will be a subclass ofcontact-pane. The functioncontact-pane-contact is provided as a means of getting hold of the contact from the CAPI pane, and is to be used by code that needs to refer to slots in the contact.

When the interface containing acontact-pane is first displayed, the CAPI creates an instance of the CLUE contact and places it in the hierarchy. Thecontact-initargs-function (if non-nil) is called with the contact-pane, and should return a list of initialization arguments for the contact (the list is applied to themake-instance).

Note that this functionality is only available for LispWorks running under UNIX, and is provided for backwards compatibility. For true portability, CLUE contacts should not be used.

Example

This example creates a CAPI contact pane calledcapi-text-item which is really a toolkit text item.

(capi:define-contact-pane (capi-text-item tk:text-item)
  () ())
(setq text-item (capi:contain
                  (make-instance 'capi-text-item)))

(tk:contact-value (capi:contact-pane-contact
                    text-item))

Example File

capi/elements/contact-pane.lisp

See Also

define-contact-pane
contact-pane-contact

Generated with Harlequin WebMaker