9.4 DUIM-Frames Module

layout-frame

Generic function

Summary

Resizes the specified frame and lays out the current pane hierarchy inside it.

Signature

layout-frame frame #key width height => ()

Arguments

frame: An instance of type <frame>.
width: An instance of type false-or(<integer>).
height: An instance of type false-or(<integer>).

Values

None

Library

duim-frames

Module

duim-frames

Description

Resizes the frame and lays out the current pane hierarchy according to the layout protocol. 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 invoked on the top-level pane.