Appendix G Windows

G.2 Functions for Operating on Windows Directly

You can use open-window-stream to give you a CLIM window without incorporating it into a frame. After calling open-window-stream, call window-expose to make the resulting window stream visible.

The following operators are available for manipulating the CLIM primitive layer for window streams.

open-window-stream [Function]

Arguments:
&key port left top right bottom width height borders console default-text-margin default-text-style depth display-device-type draw-p end-of-line-action end-of-page-action initial-cursor-visibility input-buffer label name output-record record-p save-under scroll-bars stream-background stream-foreground text-cursor text-margin viewport vsp window-class
Summary:
A handy function for creating a CLIM window, but one not normally used. Most often windows are created by an application frame or by the menu and dialog functions.

window-parent [Generic Function]
Arguments:
window
Summary:
Returns the window that is the parent (superior) of window.

window-children [Generic Function]
Arguments:
window
Summary:
Returns a list of all of the windows that are children (inferiors) of window.

window-label [Generic Function]
Arguments:
window
Summary:
Returns the label (a string) associated with window, or nil if there is none.

with-input-focus [Macro]
Arguments:
(stream)&body body
Summary:
Temporarily gives the keyboard input focus to the given window, most often an interactor pane. By default, a frame will give the input focus to the frame-query-io pane.

The following functions are most usefully applied to the top level sheet of a frame. For example:(clim:frame-top-level-sheet clim:*application-frame*).

window-expose [Generic Function]

Arguments:
window
Summary:
Makes the window visible on the screen.

window-stack-on-bottom [Generic Function]
Arguments:
window
Summary:
Puts the window underneath all other windows that it overlaps.

window-stack-on-top [Generic Function]
Arguments:
window
Summary:
Puts the window on top of all the others it overlaps so that you can see all of it.

window-visibility [Generic Function]
Arguments:
stream
Summary:
A predicate that returns t if the window is visible. You can use setf on window-visibility to expose or deexpose the window.

The following operators can be applied to a window to determine its position and size.

window-inside-edges [Generic Function]

Arguments:
window
Summary:
Returns four values, the coordinates of the left, top, right, and bottom inside edges of the window window.

window-inside-left [Function]
Arguments:
window
Summary:
Returns the coordinate of the left edge of the window window.

window-inside-top [Function]
Arguments:
window
Summary:
Returns the coordinate of the top edge of the window window.

window-inside-right [Function]
Arguments:
window
Summary:
Returns the coordinate of the right edge of the window window.

window-inside-bottom [Function]
Arguments:
window
Summary:
Returns the coordinate of the bottom edge of the window window.

window-inside-size [Generic Function]
Arguments:
window
Summary:
Returns the inside width and height of window as two values.

window-inside-width [Function]
Arguments:
window
Summary:
Returns the inside width of window.

window-inside-height [Function]
Arguments:
window
Summary:
Returns the inside height of window.


CLIM 2.0 User's Guide - OCT 1998

Generated with Harlequin WebMaker