The element containing this element.
The interface containing this element.
An object used for lookup of help. Default value
A string designator.
The x position of the element in a pinboard.
The y position of the element in a pinboard.
contains the slots
which contain the element and the interface that the element is contained in respectively. The writer method
can be used to re-parent an element into another parent (or to remove it from a container entirely by setting its parent to
). Note that an element should not be used in more than one place at a time.
specifies that the element can accept input. The default value is
. In some subclasses including display-pane and title-pane the default value of
. A pane accepts the input focus if and only if the function accepts-focus-p returns true.
also influences whether a pane is a tabstop on Microsoft Windows, where a pane acts as a tabstop if and only if the function accepts-focus-p returns true and the
initarg value is
. On Motif and Cocoa, a pane acts as a tabstop if and only if the function accepts-focus-p returns true.
is used to determine how help is displayed for the pane. The value
means that no help is displayed. Otherwise,
is passed to the
, except when
, when the name of the pane is passed to the
. For details of
, see interface.
widget-name specifies the widget name of the element. This is used to match resources on GTK+ and Motif. Note that this name will be in the path only if the element has a representation. tab-layout and pinboard-layout always have a representation, as do all elements that show anything on the screen. Other layouts may or may not have a representation and so you should not supply widget-name for these.
If widget-name is not supplied, the system contructs a default widget name which is the name of the class of the widget (downcased), except for top level interfaces on GTK+ where the application-class is prepended followed by a dot.
gets and (with
) sets the
is used when the widget is created, that is when display is called on the top level interface of the element. Setting
afterwards has no effect.
All elements accept initargs (listed above) representing hints as to the initial size and position of the element. By default elements have a minimum pixel size of one by one, and a maximum size of
(meaning no maximum), but the hints can be specified to change these values. The possible values for these hints are as follows:
The size in pixels.
means use the value of
The width of any text in the element.
The width of the screen.
The height of the screen.
The maximum size of the hints.
The minimum size of the hints.
The sum of the hints.
The subtraction of hints from the first.
The multiplication of the hints.
The division of hints from the first.
The hints of an element can be changed dynamically using set-hint-table: such a call might change the geometry.
Note: If the visible-max-width is the same as the visible-min-width , then the element is not horizontally resizable. If the visible-max-height is the same as the visible-min-height , then the element is not vertically resizable.
Some classes have default initargs providing useful hints. For example, display-pane has
as the default value of
, ensuring that the text is visible.
settings in some layouts (for example grid-layout) also control the actual size of the pane when the constraints are not specified. In particular, if
is used in the ratios then the associated pane(s) will be fixed at their minimum size.
In LispWorks 4,
means the same as
, but takes precedence if both are specified. The use of
can lead to confusion because some CAPI classes have default values for
which will override
. Similarly for :
. Therefore, your code should use