org.jdesktop.swingx
Class JXCollapsiblePane

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.JPanel
                  org.jdesktop.swingx.JXPanel
                      org.jdesktop.swingx.JXCollapsiblePane

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

public class JXCollapsiblePane
extends JXPanel

JXCollapsiblePane provides a component which can collapse or expand its content area with animation and fade in/fade out effects. It also acts as a standard container for other Swing components.

In this example, the JXCollapsiblePane is used to build a Search pane which can be shown and hidden on demand.

 
 JXCollapsiblePane cp = new JXCollapsiblePane();

 // JXCollapsiblePane can be used like any other container
 cp.setLayout(new BorderLayout());

 // the Controls panel with a textfield to filter the tree
 JPanel controls = new JPanel(new FlowLayout(FlowLayout.LEFT, 4, 0));
 controls.add(new JLabel("Search:"));
 controls.add(new JTextField(10));
 controls.add(new JButton("Refresh"));
 controls.setBorder(new TitledBorder("Filters"));
 cp.add("Center", controls);

 JXFrame frame = new JXFrame();
 frame.setLayout(new BorderLayout());

 // Put the "Controls" first
 frame.add("North", cp);

 // Then the tree - we assume the Controls would somehow filter the tree
 JScrollPane scroll = new JScrollPane(new JTree());
 frame.add("Center", scroll);

 // Show/hide the "Controls"
 JButton toggle = new JButton(cp.getActionMap().get(JXCollapsiblePane.TOGGLE_ACTION));
 toggle.setText("Show/Hide Search Panel");
 frame.add("South", toggle);

 frame.pack();
 frame.setVisible(true);
 
 

The JXCollapsiblePane has a default toggle action registered under the name TOGGLE_ACTION. Bind this action to a button and pressing the button will automatically toggle the pane between expanded and collapsed states. Additionally, you can define the icons to use through the EXPAND_ICON and COLLAPSE_ICON properties on the action. Example

 
 // get the built-in toggle action
 Action toggleAction = collapsible.getActionMap().
   get(JXCollapsiblePane.TOGGLE_ACTION);

 // use the collapse/expand icons from the JTree UI
 toggleAction.putValue(JXCollapsiblePane.COLLAPSE_ICON,
                       UIManager.getIcon("Tree.expandedIcon"));
 toggleAction.putValue(JXCollapsiblePane.EXPAND_ICON,
                       UIManager.getIcon("Tree.collapsedIcon"));
 
 

Note: JXCollapsiblePane requires its parent container to have a LayoutManager using getPreferredSize() when calculating its layout (example VerticalLayout, BorderLayout).

See Also:

Serialized Form

Nested Class Summary

static interface	JXCollapsiblePane.JCollapsiblePaneContainer Tagging interface for containers in a JXCollapsiblePane hierarchy who needs to be revalidated (invalidate/validate/repaint) when the pane is expanding or collapsing.
static class	JXCollapsiblePane.Orientation The orientation defines in which direction the collapsible pane will expand.

Nested classes/interfaces inherited from class javax.swing.JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

static String	ANIMATION_STATE_KEY Used when generating PropertyChangeEvents for the "animationState" property.
static String	COLLAPSE_ICON The icon used by the "toggle" action when the JXCollapsiblePane is expanded, i.e the icon which indicates the pane can be collapsed.
static String	EXPAND_ICON The icon used by the "toggle" action when the JXCollapsiblePane is collapsed, i.e the icon which indicates the pane can be expanded.
static String	TOGGLE_ACTION JXCollapsible has a built-in toggle action which can be bound to buttons.

Fields inherited from class javax.swing.JComponent

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

JXCollapsiblePane()
Constructs a new JXCollapsiblePane with a JPanel as content pane and a vertical VerticalLayout with a gap of 2 pixels as layout manager and a vertical orientation.

JXCollapsiblePane(JXCollapsiblePane.Orientation orientation)
Constructs a new JXCollapsiblePane with a JPanel as content pane and the specified orientation.

JXCollapsiblePane(JXCollapsiblePane.Orientation orientation, LayoutManager layout)
Constructs a new JXCollapsiblePane with a JPanel as content pane and the given LayoutManager and orientation.

JXCollapsiblePane(LayoutManager layout)
Constructs a new JXCollapsiblePane with a JPanel as content pane and the given LayoutManager and a vertical orientation

Method Summary

protected void	addImpl(Component comp, Object constraints, int index) Overriden to redirect call to the content pane.
Container	getContentPane()
Dimension	getMinimumSize()
JXCollapsiblePane.Orientation	getOrientation()
Dimension	getPreferredSize() The critical part of the animation of this JXCollapsiblePane relies on the calculation of its preferred size.
boolean	isAnimated()
boolean	isCollapsed()
void	remove(Component comp) Overriden to redirect call to the content pane
void	remove(int index) Overriden to redirect call to the content pane.
void	removeAll() Overriden to redirect call to the content pane.
void	setAnimated(boolean animated) If true, enables the animation when pane is collapsed/expanded.
void	setCollapsed(boolean val) Expands or collapses this JXCollapsiblePane.
void	setContentPane(Container contentPanel) Sets the content pane of this JXCollapsiblePane.
void	setLayout(LayoutManager mgr) Overriden to redirect call to the content pane.
void	setOrientation(JXCollapsiblePane.Orientation orientation) Changes the orientation of this collapsible pane.

Methods inherited from class org.jdesktop.swingx.JXPanel

getAlpha, getBackgroundPainter, getEffectiveAlpha, getGradientPaint, getPreferredScrollableViewportSize, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, isDrawGradient, isGradientTrackHeight, isGradientTrackWidth, isInheritAlpha, paint, paintComponent, setAlpha, setBackgroundPainter, setDrawGradient, setGradientPaint, setGradientTrackHeight, setGradientTrackWidth, setInheritAlpha, setScrollableTracksViewportHeight, setScrollableTracksViewportWidth

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getNextFocusableComponent, getPopupLocation, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, transferFocusBackward, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

ANIMATION_STATE_KEY

public static final String ANIMATION_STATE_KEY

Used when generating PropertyChangeEvents for the "animationState" property. The PropertyChangeEvent will takes the following different values for PropertyChangeEvent.getNewValue():

• reinit every time the animation starts
• expanded when the animation ends and the pane is expanded
• collapsed when the animation ends and the pane is collapsed

See Also:

Constant Field Values

TOGGLE_ACTION

public static final String TOGGLE_ACTION

JXCollapsible has a built-in toggle action which can be bound to buttons. Accesses the action through collapsiblePane.getActionMap().get(JXCollapsiblePane.TOGGLE_ACTION).

See Also:

Constant Field Values

COLLAPSE_ICON

public static final String COLLAPSE_ICON

The icon used by the "toggle" action when the JXCollapsiblePane is expanded, i.e the icon which indicates the pane can be collapsed.

See Also:

Constant Field Values

EXPAND_ICON

public static final String EXPAND_ICON

The icon used by the "toggle" action when the JXCollapsiblePane is collapsed, i.e the icon which indicates the pane can be expanded.

See Also:

Constant Field Values

Constructor Detail

JXCollapsiblePane

public JXCollapsiblePane()

Constructs a new JXCollapsiblePane with a JPanel as content pane and a vertical VerticalLayout with a gap of 2 pixels as layout manager and a vertical orientation.

JXCollapsiblePane

public JXCollapsiblePane(JXCollapsiblePane.Orientation orientation)

Constructs a new JXCollapsiblePane with a JPanel as content pane and the specified orientation.

JXCollapsiblePane

public JXCollapsiblePane(LayoutManager layout)

Constructs a new JXCollapsiblePane with a JPanel as content pane and the given LayoutManager and a vertical orientation

JXCollapsiblePane

public JXCollapsiblePane(JXCollapsiblePane.Orientation orientation,
                         LayoutManager layout)

Constructs a new JXCollapsiblePane with a JPanel as content pane and the given LayoutManager and orientation. A vertical orientation enables a vertical VerticalLayout with a gap of 2 pixels as layout manager. A horizontal orientation enables a horizontal HorizontalLayout with a gap of 2 pixels as layout manager

Method Detail

setContentPane

public void setContentPane(Container contentPanel)

Sets the content pane of this JXCollapsiblePane.

Parameters:

contentPanel -

Throws:

IllegalArgumentException - if contentPanel is null

getContentPane

public Container getContentPane()

Returns:

the content pane

setLayout

public void setLayout(LayoutManager mgr)

Overriden to redirect call to the content pane.

Overrides:

setLayout in class Container

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

Overriden to redirect call to the content pane.

Overrides:

addImpl in class Container

remove

public void remove(Component comp)

Overriden to redirect call to the content pane

Overrides:

remove in class Container

remove

public void remove(int index)

Overriden to redirect call to the content pane.

Overrides:

remove in class Container

removeAll

public void removeAll()

Overriden to redirect call to the content pane.

Overrides:

removeAll in class Container

setAnimated

public void setAnimated(boolean animated)

If true, enables the animation when pane is collapsed/expanded. If false, animation is turned off.

When animated, the JXCollapsiblePane will progressively reduce (when collapsing) or enlarge (when expanding) the height of its content area until it becomes 0 or until it reaches the preferred height of the components it contains. The transparency of the content area will also change during the animation.

If not animated, the JXCollapsiblePane will simply hide (collapsing) or show (expanding) its content area.

Parameters:

animated -

isAnimated

public boolean isAnimated()

Returns:

true if the pane is animated, false otherwise

See Also:

setAnimated(boolean)

setOrientation

public void setOrientation(JXCollapsiblePane.Orientation orientation)

Changes the orientation of this collapsible pane. Doing so changes the layout of the underlying content pane. If the chosen orientation is vertical, a vertical layout with a gap of 2 pixels is chosen. Otherwise, a horizontal layout with a gap of 2 pixels is chosen.

Parameters:

orientation - the new JXCollapsiblePane.Orientation for this collapsible pane

Throws:

IllegalStateException - when this method is called while a collapsing/restore operation is running

See Also:

getOrientation()

getOrientation

public JXCollapsiblePane.Orientation getOrientation()

Returns:

the current JXCollapsiblePane.Orientation

See Also:

setOrientation(Orientation)

isCollapsed

public boolean isCollapsed()

Returns:

true if the pane is collapsed, false if expanded

setCollapsed

public void setCollapsed(boolean val)

Expands or collapses this JXCollapsiblePane.

If the component is collapsed and val is false, then this call expands the JXCollapsiblePane, such that the entire JXCollapsiblePane will be visible. If isAnimated() returns true, the expansion will be accompanied by an animation.

However, if the component is expanded and val is true, then this call collapses the JXCollapsiblePane, such that the entire JXCollapsiblePane will be invisible. If isAnimated() returns true, the collapse will be accompanied by an animation.

See Also:

isAnimated(), setAnimated(boolean)

getMinimumSize

public Dimension getMinimumSize()

Overrides:

getMinimumSize in class JComponent

getPreferredSize

public Dimension getPreferredSize()

The critical part of the animation of this JXCollapsiblePane relies on the calculation of its preferred size. During the animation, its preferred size (specially its height) will change, when expanding, from 0 to the preferred size of the content pane, and the reverse when collapsing.

Overrides:

getPreferredSize in class JComponent

Returns:

this component preferred size