Next Prev Up Top Contents Index

6.3.2 Additional Functions for Operating on Presentations in CLIM

The following functions can be used to examine or modify presentations:

presentation   [Protocol Class]	

Summary: The protocol class that corresponds to a presentation and is a subclass of output-record . If you want to create a new class that behaves like a presentation, it should be a subclass of presentation . Subclasses of presentation obey the presentation protocol.

presentationp   [Function]	

Arguments: object

Summary: Returns t if and only if object is of type presentation .

presentation-object [Generic Function]

Arguments: presentation

Summary: Returns the object represented by the presentation presentation.

(setf presentation-object) [Generic Function]

Arguments: object presentation

Summary: Changes the object associated with the presentation presentation to object .

presentation-type [Generic Function]

Arguments: presentation

Summary: Returns the presentation type of the presentation presentation.

(setf presentation-type) [Generic Function]

Arguments: type presentation

Summary: Changes the type associated with the presentation presentation to type .

presentation-single-box [Generic Function]

Arguments: presentation

Summary: Returns the "single box" attribute of the presentation presentation , which controls how the presentation is highlighted and when it is sensitive. This will be one of four values:

nil (the default)--if the pointer is pointing at a visible piece of the output that was drawn as part of the presentation, then it is considered to be pointing at the presentation. The presentation is highlighted by highlighting each visible part of the output that was drawn as part of the presentation.

t --if the pointer is inside the bounding rectangle of the presentation, it is considered to be pointing at the presentation. The presentation is highlighted by drawing a thin border around the bounding rectangle.

:position --like t for determining whether the pointer is pointing at the presentation, but like nil for highlighting.

:highlighting --like nil for determining whether the pointer is pointing at the presentation, but like t for highlighting.

(setf presentation-single-box) [Generic Function]

Arguments: single-box presentation

Summary: Changes the "single box" attribute of the presentation presentation to single-box .

presentation-modifier [Generic Function]

Arguments: presentation

Summary: Returns the "modifier" associated with the presentation presentation . The modifier is some sort of object that describes how the presentation object might be modified. For example, it might be a function of one argument (the new value) that can be called in order to store a new value for object after a user somehow "edits" the presentation.

standard-presentation

Summary: The output record class that represents presentations. present normally creates output records of this class. Members of this class are mutable.

:object

:type

:view

:single-box

:modifier

All presentation classes must handle these five initargs, which are used to specify, respectively, the object, type, view, single-box, and modifier components of a presentation.


CommonLisp Interface Manager 2.0 User's Guide - 8 Aug 2003

Next Prev Up Top Contents Index