Macro

Summary

The with-geometry macro is used for defining layouts and for creating new pinboard-object subclasses, by binding a set of variables to a pane's geometry.

Package

capi

Signature

with-geometry pane &body body

Description

The main uses of the macro with-geometry are defining layouts and for creating new pinboard-object subclasses.

with-geometry binds the following variables across the forms in body to slots in the pane's geometry in much the same way as the Common Lisp macro with-slots :

%x%

The x position of the pane.

%y%

The y position of the pane.

%object%

The object whose geometry this is.

%child%

The same as %object% (kept for 3.1 compatibility).

%ratio%

Ratio information.

The following variables give the external size and external constraints (see the LispWorks CAPI User Guide for a description of width and height constraints):

%width%

The width in pixels of the pane.

%height%

The height in pixels of the pane.

%min-width%

The minimum width of the pane.

%min-height%

The minimum height of the pane.

%max-width%

The maximum width of the pane.

%max-height%

The maximum height of the pane.

The following variables are also bound but apply only to classes with internal scrolling, such as editor-pane. They can be retrieved by get-horizontal-scroll-parameters and get-vertical-scroll-parameters. They can be set by set-horizontal-scroll-parameters and set-vertical-scroll-parameters.

%scroll-width%

The extent of the horizontal scroll range.

%scroll-height%

The extent of the vertical scroll range.

%scroll-horizontal-page-size%

The horizontal scroll page size.

%scroll-horizontal-slug-size%

The width of the scroll bar slug.

%scroll-horizontal-step-size%

The horizontal scroll step size.

%scroll-start-x%

The start of the horizontal scroll range.

%scroll-start-y%

The start of the vertical scroll range.

%scroll-vertical-page-size%

The vertical scroll page size.

%scroll-vertical-slug-size%

The height of the scroll bar slug.

%scroll-vertical-step-size%

The vertical scroll step size.

%scroll-x%

x coordinate of the current scroll position.

%scroll-y%

y coordinate of the current scroll position

See also

convert-relative-position
element
get-horizontal-scroll-parameters
get-vertical-scroll-parameters
scroll
set-horizontal-scroll-parameters
set-vertical-scroll-parameters