Generic Function

Summary

Calculates how to place a pane correctly within a layout, given a minimum and maximum position.

Package

capi

Signature

pane-adjusted-position pane adjust min-position max-position
&key &allow-other-keys

Description

The pane-adjusted-position generic function calculates the position required by the adjust argument so that the pane pane is placed correctly within the available space in its parent layout, given a minimum and maximum position. It is a complementary function to pane-adjusted-offset, and the default method actually calls pane-adjusted-offset with the gap between the two positions, and then adds on the minimum position to get the new position.

The default method accepts the following values for adjust .

:top

Place pane at the top of the region.

:bottom

Place pane at the bottom of the region.

:left

Place pane at the left of the region.

:right

Place pane at the right of the region.

:center

Place pane in the center of the region.

(:top n )

Place the top of pane n pixels below the top of the region.

(:bottom n )

Place the bottom of pane n pixels above the bottom of the region.

(:left n )

Place the left of pane n pixels after the left of the region.

(:right n )

Place the right of pane n pixels before the right of the region.

(:center n )

Place the center of pane n pixels below the center of the region.

However, new methods can accept alternative values for adjust where required and can also add extra keywords. For example, grid-layout allows adjust to be a list of adjust values, and then passes the offset into this list as an additional keyword. It is preferable to add new methods to pane-adjusted-offset as these changes will be seen by the default method of pane-adjusted-position .

Example

(setq button-panel (make-instance 'capi:button-panel

                                  :items '(1 2 3)))

(capi:pane-adjusted-position button-panel

                             :center 100 200)

(capi:pane-adjusted-position button-panel

                             :right 100 200)

(capi:pane-adjusted-position button-panel

                             :left 100 200)

See also

layout
graph-pane
x-y-adjustable-layout