public class MultiSplitLayout extends java.lang.Object implements java.awt.LayoutManager
Although MultiSplitLayout can be used with any Container, it's the default layout manager for MultiSplitPane. MultiSplitPane supports interactively dragging the Dividers, accessibility, and other features associated with split panes.
All properties in this class are bound: when a properties value is changed, all PropertyChangeListeners are fired.
MultiSplitPane
Modifier and Type | Class and Description |
---|---|
static class |
MultiSplitLayout.Divider
Models a single vertical/horiztonal divider.
|
static class |
MultiSplitLayout.InvalidLayoutException
The specified Node is either the wrong type or was configured incorrectly.
|
static class |
MultiSplitLayout.Leaf
Models a java.awt Component child.
|
static class |
MultiSplitLayout.Node
Base class for the nodes that model a MultiSplitLayout.
|
static class |
MultiSplitLayout.Split
Defines a vertical or horizontal subdivision into two or more
tiles.
|
Modifier and Type | Field and Description |
---|---|
private java.util.Map<java.lang.String,java.awt.Component> |
childMap |
private int |
dividerSize |
private boolean |
floatingDividers |
private MultiSplitLayout.Node |
model |
private java.beans.PropertyChangeSupport |
pcs |
Constructor and Description |
---|
MultiSplitLayout()
Create a MultiSplitLayout with a default model with a single
Leaf node named "default".
|
MultiSplitLayout(MultiSplitLayout.Node model)
Create a MultiSplitLayout with the specified model.
|
Modifier and Type | Method and Description |
---|---|
void |
addLayoutComponent(java.lang.String name,
java.awt.Component child)
Add a component to this MultiSplitLayout.
|
void |
addPropertyChangeListener(java.beans.PropertyChangeListener listener) |
private static void |
addSplitChild(MultiSplitLayout.Split parent,
MultiSplitLayout.Node child) |
private static java.awt.Rectangle |
boundsWithXandWidth(java.awt.Rectangle bounds,
double x,
double width) |
private static java.awt.Rectangle |
boundsWithYandHeight(java.awt.Rectangle bounds,
double y,
double height) |
private void |
checkLayout(MultiSplitLayout.Node root) |
private java.awt.Component |
childForNode(MultiSplitLayout.Node node) |
MultiSplitLayout.Divider |
dividerAt(int x,
int y)
Return the Divider whose bounds contain the specified
point, or null if there isn't one.
|
private MultiSplitLayout.Divider |
dividerAt(MultiSplitLayout.Node root,
int x,
int y) |
private java.util.List<MultiSplitLayout.Divider> |
dividersThatOverlap(MultiSplitLayout.Node root,
java.awt.Rectangle r) |
java.util.List<MultiSplitLayout.Divider> |
dividersThatOverlap(java.awt.Rectangle r)
Return the Dividers whose bounds overlap the specified
Rectangle.
|
private void |
firePCS(java.lang.String propertyName,
java.lang.Object oldValue,
java.lang.Object newValue) |
int |
getDividerSize()
Returns the width of Dividers in Split rows, and the height of
Dividers in Split columns.
|
boolean |
getFloatingDividers() |
MultiSplitLayout.Node |
getModel()
Return the root of the tree of Split, Leaf, and Divider nodes
that define this layout.
|
java.beans.PropertyChangeListener[] |
getPropertyChangeListeners() |
private void |
layout1(MultiSplitLayout.Node root,
java.awt.Rectangle bounds) |
private void |
layout2(MultiSplitLayout.Node root,
java.awt.Rectangle bounds) |
void |
layoutContainer(java.awt.Container parent)
Compute the bounds of all of the Split/Divider/Leaf Nodes in
the layout model, and then set the bounds of each child component
with a matching Leaf Node.
|
private void |
layoutGrow(MultiSplitLayout.Split split,
java.awt.Rectangle bounds) |
private void |
layoutShrink(MultiSplitLayout.Split split,
java.awt.Rectangle bounds) |
private void |
minimizeSplitBounds(MultiSplitLayout.Split split,
java.awt.Rectangle bounds) |
java.awt.Dimension |
minimumLayoutSize(java.awt.Container parent) |
private java.awt.Dimension |
minimumNodeSize(MultiSplitLayout.Node root) |
private boolean |
nodeOverlapsRectangle(MultiSplitLayout.Node node,
java.awt.Rectangle r2) |
private static void |
parseAttribute(java.lang.String name,
java.io.StreamTokenizer st,
MultiSplitLayout.Node node) |
private static void |
parseLeaf(java.io.StreamTokenizer st,
MultiSplitLayout.Split parent) |
private static MultiSplitLayout.Node |
parseModel(java.io.Reader r) |
static MultiSplitLayout.Node |
parseModel(java.lang.String s)
A convenience method that converts a string to a MultiSplitLayout model (a tree of Nodes) using a
a simple syntax.
|
private static void |
parseSplit(java.io.StreamTokenizer st,
MultiSplitLayout.Split parent) |
private java.awt.Dimension |
preferredComponentSize(MultiSplitLayout.Node node) |
java.awt.Dimension |
preferredLayoutSize(java.awt.Container parent) |
private java.awt.Dimension |
preferredNodeSize(MultiSplitLayout.Node root) |
void |
removeLayoutComponent(java.awt.Component child)
Removes the specified component from the layout.
|
void |
removePropertyChangeListener(java.beans.PropertyChangeListener listener) |
void |
setDividerSize(int dividerSize)
Sets the width of Dividers in Split rows, and the height of
Dividers in Split columns.
|
void |
setFloatingDividers(boolean floatingDividers)
If true, Leaf node bounds match the corresponding component's
preferred size and Splits/Dividers are resized accordingly.
|
void |
setModel(MultiSplitLayout.Node model)
Set the root of the tree of Split, Leaf, and Divider nodes
that define this layout.
|
private static java.awt.Dimension |
sizeWithInsets(java.awt.Container parent,
java.awt.Dimension size) |
private void |
throwInvalidLayout(java.lang.String msg,
MultiSplitLayout.Node node) |
private static void |
throwParseException(java.io.StreamTokenizer st,
java.lang.String msg) |
private final java.util.Map<java.lang.String,java.awt.Component> childMap
private final java.beans.PropertyChangeSupport pcs
private MultiSplitLayout.Node model
private int dividerSize
private boolean floatingDividers
public MultiSplitLayout()
public MultiSplitLayout(MultiSplitLayout.Node model)
model
- modelpublic void addPropertyChangeListener(java.beans.PropertyChangeListener listener)
public void removePropertyChangeListener(java.beans.PropertyChangeListener listener)
public java.beans.PropertyChangeListener[] getPropertyChangeListeners()
private void firePCS(java.lang.String propertyName, java.lang.Object oldValue, java.lang.Object newValue)
public MultiSplitLayout.Node getModel()
setModel(org.openstreetmap.josm.gui.widgets.MultiSplitLayout.Node)
public void setModel(MultiSplitLayout.Node model)
model
- the root of the tree of Split, Leaf, and Divider nodejava.lang.IllegalArgumentException
- if model is a Divider or nullgetModel()
public int getDividerSize()
setDividerSize(int)
public void setDividerSize(int dividerSize)
dividerSize
- the size of dividers (pixels)java.lang.IllegalArgumentException
- if dividerSize < 0getDividerSize()
public boolean getFloatingDividers()
setFloatingDividers(boolean)
public void setFloatingDividers(boolean floatingDividers)
floatingDividers
- boolean valuegetFloatingDividers()
public void addLayoutComponent(java.lang.String name, java.awt.Component child)
name
should match the name property of the Leaf
node that represents the bounds of child
. After
layoutContainer() recomputes the bounds of all of the nodes in
the model, it will set this child's bounds to the bounds of the
Leaf node with name
. Note: if a component was already
added with the same name, this method does not remove it from
its parent.addLayoutComponent
in interface java.awt.LayoutManager
name
- identifies the Leaf node that defines the child's boundschild
- the component to be addedremoveLayoutComponent(java.awt.Component)
public void removeLayoutComponent(java.awt.Component child)
removeLayoutComponent
in interface java.awt.LayoutManager
child
- the component to be removedaddLayoutComponent(java.lang.String, java.awt.Component)
private java.awt.Component childForNode(MultiSplitLayout.Node node)
private java.awt.Dimension preferredComponentSize(MultiSplitLayout.Node node)
private java.awt.Dimension preferredNodeSize(MultiSplitLayout.Node root)
private java.awt.Dimension minimumNodeSize(MultiSplitLayout.Node root)
private static java.awt.Dimension sizeWithInsets(java.awt.Container parent, java.awt.Dimension size)
public java.awt.Dimension preferredLayoutSize(java.awt.Container parent)
preferredLayoutSize
in interface java.awt.LayoutManager
public java.awt.Dimension minimumLayoutSize(java.awt.Container parent)
minimumLayoutSize
in interface java.awt.LayoutManager
private static java.awt.Rectangle boundsWithYandHeight(java.awt.Rectangle bounds, double y, double height)
private static java.awt.Rectangle boundsWithXandWidth(java.awt.Rectangle bounds, double x, double width)
private void minimizeSplitBounds(MultiSplitLayout.Split split, java.awt.Rectangle bounds)
private void layoutShrink(MultiSplitLayout.Split split, java.awt.Rectangle bounds)
private void layoutGrow(MultiSplitLayout.Split split, java.awt.Rectangle bounds)
private void layout2(MultiSplitLayout.Node root, java.awt.Rectangle bounds)
private void layout1(MultiSplitLayout.Node root, java.awt.Rectangle bounds)
private void throwInvalidLayout(java.lang.String msg, MultiSplitLayout.Node node)
private void checkLayout(MultiSplitLayout.Node root)
public void layoutContainer(java.awt.Container parent)
layoutContainer
in interface java.awt.LayoutManager
private MultiSplitLayout.Divider dividerAt(MultiSplitLayout.Node root, int x, int y)
public MultiSplitLayout.Divider dividerAt(int x, int y)
x
- x coordinatey
- y coordinateprivate boolean nodeOverlapsRectangle(MultiSplitLayout.Node node, java.awt.Rectangle r2)
private java.util.List<MultiSplitLayout.Divider> dividersThatOverlap(MultiSplitLayout.Node root, java.awt.Rectangle r)
public java.util.List<MultiSplitLayout.Divider> dividersThatOverlap(java.awt.Rectangle r)
r
- target Rectanglejava.lang.IllegalArgumentException
- if the Rectangle is nullprivate static void throwParseException(java.io.StreamTokenizer st, java.lang.String msg) throws java.lang.Exception
java.lang.Exception
private static void parseAttribute(java.lang.String name, java.io.StreamTokenizer st, MultiSplitLayout.Node node) throws java.lang.Exception
java.lang.Exception
private static void addSplitChild(MultiSplitLayout.Split parent, MultiSplitLayout.Node child)
private static void parseLeaf(java.io.StreamTokenizer st, MultiSplitLayout.Split parent) throws java.lang.Exception
java.lang.Exception
private static void parseSplit(java.io.StreamTokenizer st, MultiSplitLayout.Split parent) throws java.lang.Exception
java.lang.Exception
private static MultiSplitLayout.Node parseModel(java.io.Reader r)
public static MultiSplitLayout.Node parseModel(java.lang.String s)
For example, the following expression generates a horizontal Split node with three children: the Leafs named left and right, and a Divider in between:
(ROW (LEAF name=left) (LEAF name=right weight=1.0))
Dividers should not be included in the string, they're added automatcially as needed. Because Leaf nodes often only need to specify a name, one can specify a Leaf by just providing the name. The previous example can be written like this:
(ROW left (LEAF name=right weight=1.0))
Here's a more complex example. One row with three elements, the first and last of which are columns with two leaves each:
(ROW (COLUMN weight=0.5 left.top left.bottom) (LEAF name=middle) (COLUMN weight=0.5 right.top right.bottom))
This syntax is not intended for archiving or configuration files . It's just a convenience for examples and tests.
s
- model as string