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 .

Note: The Common LispWorks development environment uses find-interface in many places.

See also

locate-interface
reinitialize-interface