Function

Summary

The convert-to-screen function finds the appropriate screen or container for a CAPI object.

Package

capi

Signature

convert-to-screen &optional object => result

Arguments

object

A CAPI object, or nil .

Values

result

A screen or a container.

Description

This finds the appropriate screen or container for the CAPI object object .

If object is nil , result is the default screen. object defaults to nil .

If object is a pane inside a MDI interface, then result is the capi:container of the interface, rather than the real screen, because this is more useful in most cases. To obtain the real screen, call convert-to-screen on the top level interface. See document-frame for a description of MDI interfaces.

Example

(capi:convert-to-screen)

See also

document-frame
screen