All Manuals > CAPI User Guide and Reference Manual > 21 CAPI Reference Entries

find-interface Generic Function

Summary

Displays an interface of a given class, making it if necessary.

Package

capi

Signature

find-interface class-name &rest initargs &key screen &allow-other-keys => interface

Arguments
class-name
A specifier for a subclass of interface.
initargs
Initialization arguments for class-name.
screen
A screen or nil.
Values
interface
An interface of class class-name.
Description

The generic function find-interface finds and displays an interface of the given class class-name that matches initargs and screen.

class-name can be the name of a suitable class, the class itself, or an instance of the class.

screen can be a CAPI object as accepted by convert-to-screen. screen defaults to the default screen.

find-interface calls locate-interface to locate an existing interface:

  1. If an interface of the class specified by class-name matching initargs exists already on screen, then this interface is activated and returned.
  2. Otherwise, if an interface of the class specified by class-name exists already on screen, then reinitialize-interface is applied to this interface which is then activated and returned.

If no instance of class class-name exists on screen, then find-interface creates one by passing class-name and initargs to make-instance, and displays the result on screen.

Notes

There are many uses of find-interface in the LispWorks IDE.

See also

locate-interface
reinitialize-interface


CAPI User Guide and Reference Manual (Macintosh version) - 01 Dec 2021 19:31:27