Package org.jdesktop.swingx

Class JXTaskPane

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JPanel
org.jdesktop.swingx.JXTaskPane
All Implemented Interfaces:
ImageObserver, MenuContainer, Serializable, Accessible, JXCollapsiblePane.CollapsiblePaneContainer
@JavaBean public class JXTaskPane extends JPanel implements JXCollapsiblePane.CollapsiblePaneContainer
JXTaskPane is a container for tasks and other arbitrary components.

Several JXTaskPanes are usually grouped together within a JXTaskPaneContainer. However it is not mandatory to use a JXTaskPaneContainer as the parent for JXTaskPane. The JXTaskPane can be added to any other container. See JXTaskPaneContainer to understand the benefits of using it as the parent container.

JXTaskPane provides control to expand and collapse the content area in order to show or hide the task list. It can have an icon, a title and can be marked as special. Marking a JXTaskPane as special (setSpecial(boolean) is only a hint for the pluggable UI which will usually paint it differently (by example by using another color for the border of the pane).

When the JXTaskPane is expanded or collapsed, it will be animated with a fade effect. The animated can be disabled on a per component basis through setAnimated(boolean). To disable the animation for all newly created JXTaskPane, use the UIManager property: UIManager.put("TaskPane.animate", Boolean.FALSE);.

Example: 

 
 JXFrame frame = new JXFrame();
 
 // a container to put all JXTaskPane together
 JXTaskPaneContainer taskPaneContainer = new JXTaskPaneContainer();
 
 // create a first taskPane with common actions
 JXTaskPane actionPane = new JXTaskPane();
 actionPane.setTitle("Files and Folders");
 actionPane.setSpecial(true);
 
 // actions can be added, a hyperlink will be created
 Action renameSelectedFile = createRenameFileAction();
 actionPane.add(renameSelectedFile);
 actionPane.add(createDeleteFileAction());
 
 // add this taskPane to the taskPaneContainer
 taskPaneContainer.add(actionPane);
 
 // create another taskPane, it will show details of the selected file
 JXTaskPane details = new JXTaskPane();
 details.setTitle("Details");
  
 // add standard components to the details taskPane
 JLabel searchLabel = new JLabel("Search:");
 JTextField searchField = new JTextField("");
 details.add(searchLabel);
 details.add(searchField);
 
 taskPaneContainer.add(details);
 
 // put the action list on the left 
 frame.add(taskPaneContainer, BorderLayout.EAST);
 
 // and a file browser in the middle
 frame.add(fileBrowser, BorderLayout.CENTER);
 
 frame.pack();
 frame.setVisible(true);
Author:
Frederic Lavigne, Karl George Schaefer
See Also:

  • Field Details

    • uiClassID

      public static final String uiClassID
      JXTaskPane pluggable UI key swingx/TaskPaneUI
      See Also:

    • SCROLL_ON_EXPAND_CHANGED_KEY

      public static final String SCROLL_ON_EXPAND_CHANGED_KEY
      Used when generating PropertyChangeEvents for the "scrollOnExpand" property
      See Also:

    • TITLE_CHANGED_KEY

      public static final String TITLE_CHANGED_KEY
      Used when generating PropertyChangeEvents for the "title" property
      See Also:

    • ICON_CHANGED_KEY

      public static final String ICON_CHANGED_KEY
      Used when generating PropertyChangeEvents for the "icon" property
      See Also:

    • SPECIAL_CHANGED_KEY

      public static final String SPECIAL_CHANGED_KEY
      Used when generating PropertyChangeEvents for the "special" property
      See Also:

    • ANIMATED_CHANGED_KEY

      public static final String ANIMATED_CHANGED_KEY
      Used when generating PropertyChangeEvents for the "animated" property
      See Also:

  • Constructor Details

    • JXTaskPane

      public JXTaskPane()
      Creates a new empty JXTaskPane.

    • JXTaskPane

      public JXTaskPane(String title)
      Creates a new task pane with the specified title.
      Parameters:
      title - the title to use

    • JXTaskPane

      public JXTaskPane(Icon icon)
      Creates a new task pane with the specified icon.
      Parameters:
      icon - the icon to use

    • JXTaskPane

      public JXTaskPane(String title, Icon icon)
      Creates a new task pane with the specified title and icon.
      Parameters:
      title - the title to use
      icon - the icon to use

  • Method Details

    • getContentPane

      public Container getContentPane()
      Returns the contentPane object for this JXTaskPane.
      Returns:
      the contentPane property

    • updateUI

      public void updateUI()
      Notification from the UIManager that the Linvalid input: '&F' has changed. Replaces the current UI object with the latest version from the UIManager.
      Overrides:
      updateUI in class JPanel
      See Also:

    • setUI

      public void setUI(TaskPaneUI ui)
      Sets the Linvalid input: '&F' object that renders this component.
      Parameters:
      ui - the TaskPaneUI Linvalid input: '&F' object
      See Also:

    • getUIClassID

      public String getUIClassID()
      Returns the name of the Linvalid input: '&F' class that renders this component.
      Overrides:
      getUIClassID in class JPanel
      Returns:
      the string uiClassID
      See Also:

    • getTitle

      public String getTitle()
      Returns the title currently displayed in the border of this pane.
      Returns:
      the title currently displayed in the border of this pane

    • setTitle

      public void setTitle(String title)
      Sets the title to be displayed in the border of this pane.
      Parameters:
      title - the title to be displayed in the border of this pane

    • getIcon

      public Icon getIcon()
      Returns the icon currently displayed in the border of this pane.
      Returns:
      the icon currently displayed in the border of this pane

    • setIcon

      public void setIcon(Icon icon)
      Sets the icon to be displayed in the border of this pane. Some pluggable UIs may impose size constraints for the icon. A size of 16x16 pixels is the recommended icon size.
      Parameters:
      icon - the icon to be displayed in the border of this pane

    • isSpecial

      public boolean isSpecial()
      Returns true if this pane is "special".
      Returns:
      true if this pane is "special"
      See Also:

    • setSpecial

      public void setSpecial(boolean special)
      Sets this pane to be "special" or not. Marking a JXTaskPane as special is only a hint for the pluggable UI which will usually paint it differently (by example by using another color for the border of the pane).

      Usually the first JXTaskPane in a JXTaskPaneContainer is marked as special because it contains the default set of actions which can be executed given the current context.

      Parameters:
      special - true if this pane is "special", false otherwise

    • setScrollOnExpand

      public void setScrollOnExpand(boolean scrollOnExpand)
      Should this group be scrolled to be visible on expand.
      Parameters:
      scrollOnExpand - true to scroll this group to be visible if this group is expanded.
      See Also:

    • isScrollOnExpand

      public boolean isScrollOnExpand()
      Should this group scroll to be visible after this group was expanded.
      Returns:
      true if we should scroll false if nothing should be done.

    • setCollapsed

      public void setCollapsed(boolean collapsed)
      Expands or collapses this group.

      As of SwingX 1.6.3, the property change event only fires when the state is accurate. As such, animated task panes fire once the animation is complete.

      Parameters:
      collapsed - true to collapse the group, false to expand it

    • isCollapsed

      public boolean isCollapsed()
      Returns the collapsed state of this task pane.
      Returns:
      true if the task pane is collapsed; false otherwise

    • setAnimated

      public void setAnimated(boolean animated)
      Enables or disables animation during expand/collapse transition.
      Parameters:
      animated -

    • isAnimated

      public boolean isAnimated()
      Returns true if this task pane is animated during expand/collapse transition.
      Returns:
      true if this task pane is animated during expand/collapse transition.

    • getMnemonic

      public int getMnemonic()

      If the character defined by the mnemonic is found within the task pane's text string, the first occurrence of it will be underlined to indicate the mnemonic to the user.

    • setMnemonic

      public void setMnemonic(int mnemonic)

    • getDisplayedMnemonicIndex

      public int getDisplayedMnemonicIndex()

    • setDisplayedMnemonicIndex

      public void setDisplayedMnemonicIndex(int index) throws IllegalArgumentException
      Throws:
      IllegalArgumentException

    • add

      public Component add(Action action)
      Adds an action to this JXTaskPane. Returns a component built from the action. The returned component has been added to the JXTaskPane.
      Parameters:
      action -
      Returns:
      a component built from the action

    • getValidatingContainer

      public Container getValidatingContainer()
      Specified by:
      getValidatingContainer in interface JXCollapsiblePane.CollapsiblePaneContainer
      See Also:

    • addImpl

      protected void addImpl(Component comp, Object constraints, int index)
      Overridden to redirect call to the content pane.
      Overrides:
      addImpl in class Container

    • setLayout

      public void setLayout(LayoutManager mgr)
      Overridden to redirect call to the content pane.
      Overrides:
      setLayout in class Container

    • remove

      public void remove(Component comp)
      Overridden to redirect call to the content pane
      Overrides:
      remove in class Container

    • remove

      public void remove(int index)
      Overridden to redirect call to the content pane.
      Overrides:
      remove in class Container

    • removeAll

      public void removeAll()
      Overridden to redirect call to the content pane.
      Overrides:
      removeAll in class Container

    • paramString

      protected String paramString()
      Overrides:
      paramString in class JPanel
      See Also: