org.jdesktop.swingx.StackLayout Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of jtstand-desktop Show documentation
Show all versions of jtstand-desktop Show documentation
jtstand-desktop is a gui library, an extension of swing. jtstand-desktop is derived from swingx.
/*
* Copyright (c) 2009 Albert Kurucz.
*
* This file, StackLayout.java is part of JTStand.
*
* JTStand is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* JTStand is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public License
* along with JTStand. If not, see StackLayout is a Swing layout aimed to act as the layers
* stack of most popuplar graphics editing tools like The GIMP or
* Photoshop. While similar to CardLayout, this layout
* displays all the components of the container. If you are using non-rectangular
* components (i.e. transparent) you will see them from top to bottom of the
* stack.
* When using this layout, each component can be added in the container
* either on top of the stack or at the bootom:
*
* JPanel panel = new JPanel(new StackLayout());
* panel.add(new JLabel("On top"), StackLayout.TOP);
* panel.add(new JLabel("At bottom"), StackLayout.BOTTOM);
*
* If you don't specify the constraint, the component will be added at the top
* of the components stack.
* All the components managed by this layout will be given the same size as
* the container itself. The minimum, maximum and preferred size of the
* container are based upon the largest minimum, maximum and preferred size of
* the children components.
* StackLayout works only with JSE 1.5 and Java SE 6 and
* greater.
*
* @author Romain Guy
*/
public class StackLayout implements LayoutManager2 {
/** Use this constraint to add a component at the bottom of the stack. */
public static final String BOTTOM = "bottom";
/** Use this contrainst to add a component at the top of the stack. */
public static final String TOP = "top";
// removing components does not happen often compared to adding components
// hence we choose a linked list to make insertion at the bottom faster
private List components = new LinkedList();
/**
* {@inheritDoc}
*/
public void addLayoutComponent(final Component comp,
final Object constraints) {
synchronized (comp.getTreeLock()) {
if (BOTTOM.equals(constraints)) {
components.add(0, comp);
} else if (TOP.equals(constraints)) {
components.add(comp);
} else {
components.add(comp);
}
}
}
/**
* {@inheritDoc}
*/
public void addLayoutComponent(final String name, final Component comp) {
addLayoutComponent(comp, TOP);
}
/**
* {@inheritDoc}
*/
public void removeLayoutComponent(final Component comp) {
synchronized (comp.getTreeLock()) {
components.remove(comp);
}
}
/**
* {@inheritDoc}
*/
public float getLayoutAlignmentX(final Container target) {
return 0.5f;
}
/**
* {@inheritDoc}
*/
public float getLayoutAlignmentY(final Container target) {
return 0.5f;
}
/**
* {@inheritDoc}
*/
public void invalidateLayout(final Container target) {
}
/**
* {@inheritDoc}
*/
public Dimension preferredLayoutSize(final Container parent) {
synchronized (parent.getTreeLock()) {
int width = 0;
int height = 0;
for (Component comp: components) {
Dimension size = comp.getPreferredSize();
width = Math.max(size.width, width);
height = Math.max(size.height, height);
}
Insets insets = parent.getInsets();
width += insets.left + insets.right;
height += insets.top + insets.bottom;
return new Dimension(width, height);
}
}
/**
* {@inheritDoc}
*/
public Dimension minimumLayoutSize(final Container parent) {
synchronized (parent.getTreeLock()) {
int width = 0;
int height = 0;
for (Component comp: components) {
Dimension size = comp.getMinimumSize();
width = Math.max(size.width, width);
height = Math.max(size.height, height);
}
Insets insets = parent.getInsets();
width += insets.left + insets.right;
height += insets.top + insets.bottom;
return new Dimension(width, height);
}
}
/**
* {@inheritDoc}
*/
public Dimension maximumLayoutSize(final Container target) {
return new Dimension(Integer.MAX_VALUE,
Integer.MAX_VALUE);
}
/**
* {@inheritDoc}
*/
public void layoutContainer(final Container parent) {
synchronized (parent.getTreeLock()) {
int width = parent.getWidth();
int height = parent.getHeight();
Rectangle bounds = new Rectangle(0, 0, width, height);
int componentsCount = components.size();
for (int i = 0; i < componentsCount; i++) {
Component comp = components.get(i);
comp.setBounds(bounds);
parent.setComponentZOrder(comp, componentsCount - i - 1);
}
}
}
}