Page 291 Table of Contents Index Page 293
Chapters
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
A, B, C, D, E



CHAPTER 28. APPLICATION FRAMES

Returns a list of those named panes in the frame frame's current layout. If there are no named
panes (that is, the :pane option was used), only the single, top level pane is returned. This
function returns objects that reveal CLIM's internal state; do not modify those objects.

=> get-frame-pane frame pane-name [Generic Function]
Returns the named CLIM stream pane in the frame frame whose name is pane-name.

=> find-pane-named frame pane-name [Generic Function]
Returns the pane in the frame frame whose name is pane-name. This can return any type of
pane, not just CLIM stream panes.

=> frame-top-level-sheet frame [Generic Function]
Returns the sheet that is the top-level sheet for the frame frame. This is the sheet that has as
its descendents all of the panes of frame.

=> frame-pane frame [Generic Function]
Returns the pane that is the top level pane of the current layout of the frame.

=> frame-current-layout frame [Generic Function]
Returns the current layout for the frame frame. The layout is named by a symbol.

=> (setf frame-current-layout) layout frame [Generic Function]
Sets the layout of the frame frame to be the new layout specified by new-layout. layout must be
a symbol that names one of the possible layouts.

Changing the layout of the frame must recompute what panes are used for the bindings of the
standard stream variables (such as *standard-input*). Some implementations of CLIM may
cause the application to "throw" all the way back to run-frame-top-level in order to do this.
After the new layout has been computed, the contents of each of the panes must be displayed to
the degree necessary to ensure that all output is visible.

=> layout-frame frame &optional width height [Generic Function]
Resizes the frame and lays out the current pane hierarchy using the layout specified by frame-
current-layout
, according to the layout protocol. The basics of the layout protocols are de-
scribed in Section 29.3.4. This function is automatically invoked on a frame when it is adopted,
after its pane hierarchy has been generated.

If width and height are provided, then this function resizes the frame to the specified size. It is
an error to provide just width.

If no optional arguments are provided, this function resizes the frame to the preferred size of the
top-level pane as determined by the space composition pass of the layout protocol.

In either case, after the frame is resized, the space allocation pass of the layout protocol is


Page 291 Table of Contents Index Page 293
Chapters
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
A, B, C, D, E