switchable-layout Class

Summary

A layout which displays only one of its children at a time, and supports switching to another child.

Package

capi

Superclasses

simple-layout

Initargs

Accessors

switchable-layout-visible-child

Readers

switchable-layout-combine-child-constraints

Description

The class switchable-layout is a subclass of simple-layout which displays only one of its children at a time, and provides functionality for switching the displayed child to one of the other children.

The layout's description contains a list of its children. The argument visible-child specifies the initially visible child (which defaults to the first of the children).

switchable-layout inherits most of its layout behavior from simple-layout as it only ever lays out one child at a time.

combine-child-constraints influences the initial size of the layout. When combine-child-constraints is nil the constraints of the switchable layout depend only on its currently visible child pane. Switching to a different child pane might cause the layout to resize. When combine-child-constraints is non-nil, the constraints depend on all of the child panes, including those that are not visible. This might increase the time taken to create the switchable layout initially, but can prevent unexpected resizing later. The default value of combine-child-constraints is nil.

Examples

(setq children (list
                (make-instance 'capi:push-button
                               :text "Press Me")
                (make-instance 'capi:list-panel
                               :items '(1 2 3 4 5))))
 
(setq layout (capi:contain
              (make-instance
               'capi:switchable-layout
               :description children)))
 
(capi:apply-in-pane-process 
 layout #'(setf capi:switchable-layout-visible-child)
 (second children) layout)
 
(capi:apply-in-pane-process 
  layout #'(setf capi:switchable-layout-visible-child) 
  (first children) layout)

Here is a further example:

(example-edit-file "capi/layouts/switchable")

See also

simple-layout
switchable-layout-switchable-children
6 Laying Out CAPI Panes
7 Programming with CAPI Windows
9.9.1 Changing a non-standard toolbar dynamically