Next Prev Up Top Contents Index
F.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.


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

Next Prev Up Top Contents Index