com.l2fprod.common.swing
Class JCollapsiblePane

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by javax.swing.JComponent
              extended by javax.swing.JPanel
                  extended by com.l2fprod.common.swing.JCollapsiblePane
All Implemented Interfaces:
java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

public class JCollapsiblePane
extends javax.swing.JPanel

JCollapsiblePane 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 JCollapsiblePane is used to build a Search pane which can be shown and hidden on demand.

 
 JCollapsiblePane cp = new JCollapsiblePane();

 // JCollapsiblePane 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);
   
 JFrame frame = new JFrame();
 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(JCollapsiblePane.TOGGLE_ACTION));
 toggle.setText("Show/Hide Search Panel");
 frame.add("South", toggle);

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

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

See Also:
Serialized Form

Nested Class Summary
static interface JCollapsiblePane.JCollapsiblePaneContainer
          Tagging interface for containers in a JCollapsiblePane hierarchy who needs to be revalidated (invalidate/validate/repaint) when the pane is expanding or collapsing.
 
Nested classes/interfaces inherited from class javax.swing.JPanel
javax.swing.JPanel.AccessibleJPanel
 
Nested classes/interfaces inherited from class javax.swing.JComponent
javax.swing.JComponent.AccessibleJComponent
 
Nested classes/interfaces inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy
 
Field Summary
static java.lang.String ANIMATION_STATE_KEY
          Used when generating PropertyChangeEvents for the "animationState" property
static java.lang.String COLLAPSE_ICON
          The icon used by the "toggle" action when the JCollapsiblePane is expanded, i.e the icon which indicates the pane can be collapsed.
static java.lang.String EXPAND_ICON
          The icon used by the "toggle" action when the JCollapsiblePane is collapsed, i.e the icon which indicates the pane can be expanded.
static java.lang.String TOGGLE_ACTION
          JCollapsible 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
JCollapsiblePane()
          Constructs a new JCollapsiblePane with a JPanel as content pane and a vertical PercentLayout with a gap of 2 pixels as layout manager.
 
Method Summary
protected  void addImpl(java.awt.Component comp, java.lang.Object constraints, int index)
          Overriden to redirect call to the content pane.
 java.awt.Container getContentPane()
           
 java.awt.Dimension getMinimumSize()
           
 java.awt.Dimension getPreferredSize()
          The critical part of the animation of this JCollapsiblePane relies on the calculation of its preferred size.
 boolean isAnimated()
           
 boolean isCollapsed()
           
 void remove(java.awt.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 JCollapsiblePane.
 void setContentPane(java.awt.Container contentPanel)
          Sets the content pane of this JCollapsiblePane.
 void setLayout(java.awt.LayoutManager mgr)
          Overriden to redirect call to the content pane.
 
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, getBaseline, getBaselineResizeBehavior, 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, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, 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, 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, transferFocusBackward, 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 java.lang.String ANIMATION_STATE_KEY
Used when generating PropertyChangeEvents for the "animationState" property

See Also:
Constant Field Values

TOGGLE_ACTION

public static final java.lang.String TOGGLE_ACTION
JCollapsible has a built-in toggle action which can be bound to buttons. Accesses the action through collapsiblePane.getActionMap().get(JCollapsiblePane.TOGGLE_ACTION).

See Also:
Constant Field Values

COLLAPSE_ICON

public static final java.lang.String COLLAPSE_ICON
The icon used by the "toggle" action when the JCollapsiblePane is expanded, i.e the icon which indicates the pane can be collapsed.

See Also:
Constant Field Values

EXPAND_ICON

public static final java.lang.String EXPAND_ICON
The icon used by the "toggle" action when the JCollapsiblePane is collapsed, i.e the icon which indicates the pane can be expanded.

See Also:
Constant Field Values
Constructor Detail

JCollapsiblePane

public JCollapsiblePane()
Constructs a new JCollapsiblePane with a JPanel as content pane and a vertical PercentLayout with a gap of 2 pixels as layout manager.

Method Detail

setContentPane

public void setContentPane(java.awt.Container contentPanel)
Sets the content pane of this JCollapsiblePane. Components must be added to this content pane, not to the JCollapsiblePane.

Parameters:
contentPanel -
Throws:
java.lang.IllegalArgumentException - if contentPanel is null

getContentPane

public java.awt.Container getContentPane()
Returns:
the content pane

setLayout

public void setLayout(java.awt.LayoutManager mgr)
Overriden to redirect call to the content pane.

Overrides:
setLayout in class java.awt.Container

addImpl

protected void addImpl(java.awt.Component comp,
                       java.lang.Object constraints,
                       int index)
Overriden to redirect call to the content pane.

Overrides:
addImpl in class java.awt.Container

remove

public void remove(java.awt.Component comp)
Overriden to redirect call to the content pane

Overrides:
remove in class java.awt.Container

remove

public void remove(int index)
Overriden to redirect call to the content pane.

Overrides:
remove in class java.awt.Container

removeAll

public void removeAll()
Overriden to redirect call to the content pane.

Overrides:
removeAll in class java.awt.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 JCollapsiblePane 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 JCollapsiblePane 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)

isCollapsed

public boolean isCollapsed()
Returns:
true if the pane is collapsed, false if expanded

setCollapsed

public void setCollapsed(boolean val)
Expands or collapses this JCollapsiblePane.

If the component is collapsed and val is false, then this call expands the JCollapsiblePane, such that the entire JCollapsiblePane 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 JCollapsiblePane, such that the entire JCollapsiblePane will be invisible. If isAnimated() returns true, the collapse will be accompanied by an animation.

See Also:
isAnimated(), setAnimated(boolean)

getMinimumSize

public java.awt.Dimension getMinimumSize()
Overrides:
getMinimumSize in class javax.swing.JComponent

getPreferredSize

public java.awt.Dimension getPreferredSize()
The critical part of the animation of this JCollapsiblePane 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 javax.swing.JComponent
Returns:
this component preferred size