Class

Summary

A screen is an object that represents the known monitor screens.

Package

capi

Superclasses

capi-object

Subclasses

color-screen
mono-screen

Initargs

:width

The width in pixels of the screen.

:height

The height in pixels of the screen.

:number

The screen number.

:depth

The number of color planes in the screen.

:interfaces

A list of all of the interfaces visible on the screen.

Readers

screen-width
screen-height
screen-number
screen-depth
screen-interfaces
screen-width-in-millimeters
screen-height-in-millimeters

Description

When the CAPI initializes itself it creates one or more screen objects and they are then used to specify where a window is to appear. A screen object can also be queried for information that the program may need to know about the screen that it is working on, such as its width, height and depth.

On Microsoft Windows and Cocoa there is exactly one CAPI screen. When there are multiple monitors, there are several rectangles of pixels within the single CAPI screen.

On Motif, there is one CAPI screen for each X11 screen.

Compatibility note

In LispWorks for Macintosh 4.3 there is one CAPI screen for each Cocoa screen. In LispWorks for Macintosh 4.4 and later, there is exactly one CAPI screen.

Example

(setq screen (capi:convert-to-screen)) (capi:screen-width screen) (capi:screen-height screen)

(capi:display (make-instance 

               'capi:interface :title "Test")

                               :screen screen)

(capi:screen-interfaces screen)

See also

convert-to-screen
Screens
Dialog Owners
Defining Interface Classes - top level windows