9.4 DUIM-Frames Module

find-frame

Function

Summary

Returns a frame of the specified type, creating one if necessary.

Signature

find-frame frame-class #rest initargs #key create? activate? own-thread? port frame-manager test #all-keys => frame

Arguments

frame-class: An instance of type <object>.
initargs: An instance of type <object>.
create?: An instance of type <boolean>. Default value: #t.
activate?: An instance of type <boolean>. Default value: #t.
own-thread?: An instance of type <boolean>. Default value: #t.
port: An instance of type <port>.
frame-manager: An instance of type <frame-manager>.
test: An instance of type <function>. Default value: identity.

Values

frame: An instance of type <frame>.

Library

duim-frames

Module

duim-frames

Description

This function creates a frame of the specified type if one does not already exist, and then runs it, possibly in its own thread. If one already exists, then it is selected.

The frame-class argument specifies the class of frame that is being searched for. By default, if a match is not found, then an instance of this class will be created.

The init-args supplied are the slot values that should be passed to the instance of frame-class. Either an existing frame must be found that has the specified slot values, or a new one will be created.

If create? is #f, then a new frame will not be created if it does not already exist.

If own-thread? is true, the frame will run in its own thread if one is created.

The port and frame-manager arguments specify a port and frame manager which control the frame being searched for, or under the control of which a new frame should be created.

If desired, you can supply a test which must evaluate to true for a frame to match successfully.