All Manuals > CLIM 2.0 User Guide > Appendix E: Windows

E.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

open-window-stream &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

window-parent window

Summary: Returns the window that is the parent (superior) of window.

window-children Generic Function

window-children window

Summary: Returns a list of all of the windows that are children (inferiors) of window.

window-label Generic Function

window-label window

Summary: Returns the label (a string) associated with window, or nil if there is none.

with-input-focus Macro

with-input-focus (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

window-expose window

Summary: Makes the window visible on the screen.

window-stack-on-bottom Generic Function

window-stack-on-bottom window

Summary: Puts the window underneath all other windows that it overlaps.

window-stack-on-top Generic Function

window-stack-on-top 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

window-visibility 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

window-inside-edges window

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

window-inside-left Function

window-inside-left window

Summary: Returns the coordinate of the left edge of the window window.

window-inside-top Function

window-inside-top window

Summary: Returns the coordinate of the top edge of the window window.

window-inside-right Function

window-inside-right window

Summary: Returns the coordinate of the right edge of the window window.

window-inside-bottom Function

window-inside-bottom window

Summary: Returns the coordinate of the bottom edge of the window window.

window-inside-size Generic Function

window-inside-size window

Summary: Returns the inside width and height of window as two values.

window-inside-width Function

window-inside-width window

Summary: Returns the inside width of window.

window-inside-height Function

window-inside-height window

Summary: Returns the inside height of window.


CLIM 2.0 User Guide - 01 Dec 2021 19:39:02