Java Doc for JTaskPaneGroup.java in  » Swing-Library » l2fprod-common » com » l2fprod » common » swing » Java Source Code / Java DocumentationJava Source Code and Java Documentation

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

JTaskPaneGroup 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 JTaskPaneGroup 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).

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

Example:

 
 JXFrame frame = new JXFrame();
 // a container to put all JTaskPaneGroup together
 JTaskPane taskPaneContainer = new JTaskPane();
 // create a first taskPane with common actions
 JTaskPaneGroup actionPane = new JTaskPaneGroup();
 actionPane.setTitle("Files and Folders");
 actionPane.setSpecial(true);
 // actions can be added, an 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
 JTaskPaneGroup details = new JTaskPaneGroup();
 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);
 
 

Usually the first JTaskPaneGroup in a JTaskPane 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