|
Document revision: 2024-05-27
Refers to JDLG version: 2.0.18
Contents
Splitter class
The Splitter object is a layout element that contains exactly two objects
of type GroupBox or Splitter and offers
user-controlled resizing of its elements. The splitting may be vertical
or horizontal.
An embedded GroupBox is called a
splitter pane and may contain any number of child objects.
Notes:
- The size of an embedded GroupBox or
Splitter is ignored, it is resized as needed.
A virtual size may be
defined for an embedded GroupBox,
which then becomes scrollable if insufficient space is available.
- The border attribute of
an embedded GroupBox is ignored,
no border is displayed.
- The Splitter object itself never obtains the keyboard focus.
- border : integer, get/set
- Nonzero (default): The default Splitter border is displayed.
Zero: No border is displayed.
The Splitter border, if displayed, reduces the usable size for contained
child objects.
- class : string, get
- Returns "Splitter".
- dividersize : integer, get/set
- Size of the Splitter divider in pixel units.
The default value is zero, which causes the (platform or
look-and-feel specific) default
divider size to be used.
- orientation : integer, get/set
- Zero (default): Horizontal splitting.
Nonzero: Vertical splitting.
- position : integer, get/set
- Relative position of the Splitter divider in
Dialog raster units
or pixel units.
Note: Using pixel units
requires JDLG version 1.7.0 or newer.
- quickexpand : integer, get/set
- Zero (default): Quick-expand buttons are not displayed.
Nonzero: Quick-expand buttons are displayed on the divider,
which allow to quickly set the minimum or maximum or previous divider
position.
- rule : integer, get/set
- If nonzero, the rule value is returned to the program, along with the
path of the Splitter object, when
the user has moved the divider. When a rule is submitted, the
position attribute value is set.
The default rule value is zero.
See also the documentation of the
common rule attribute.
Note: Requires JDLG version 2.0.14 or newer.
|
|