org.jdesktop.swingx.JXTaskPaneContainer Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of swingx-all Show documentation
Fork of the inactive swingx-all library
There is a newer version: 1.7.2
/*
 * $Id: JXTaskPaneContainer.java 4226 2012-08-07 16:09:19Z kschaefe $
 *
 * Copyright 2004 Sun Microsystems, Inc., 4150 Network Circle,
 * Santa Clara, California 95054, U.S.A. All rights reserved.
 *
 * This library 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 2.1 of the License, or (at your option) any later version.
 *
 * This library 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 this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
 */
package org.jdesktop.swingx;

import org.jdesktop.beans.JavaBean;
import org.jdesktop.swingx.plaf.LookAndFeelAddons;
import org.jdesktop.swingx.plaf.TaskPaneContainerAddon;
import org.jdesktop.swingx.plaf.TaskPaneContainerUI;

import java.awt.event.ContainerAdapter;
import java.awt.event.ContainerEvent;

/**
 * JXTaskPaneContainer provides an elegant view
 * to display a list of tasks ordered by groups ({@link JXTaskPane}s).
 *
 * 
 * Although {@link JXTaskPane} can be added to any other
 * container, the JXTaskPaneContainer will provide better
 * fidelity when it comes to matching the look and feel of the host operating
 * system than any other panel. As example, when using on a Windows platform,
 * the JXTaskPaneContainer will be painted with a light gradient
 * background. Also JXTaskPaneContainer takes care of using the
 * right {@link java.awt.LayoutManager} (as required by
 * {@link JXCollapsiblePane}) so that
 * {@link JXTaskPane} behaves correctly when collapsing and
 * expanding its content.
 *
 * 

 * JXTaskPaneContainer can be added to a JScrollPane.
 *
 * 

 * Example:
 * 
 * 
 * JXFrame frame = new JXFrame();
 *
 * // a container to put all JXTaskPane together
 * JXTaskPaneContainer taskPaneContainer = new JXTaskPaneContainer();
 *
 * // add JXTaskPanes to the container
 * JXTaskPane actionPane = createActionPane();
 * JXTaskPane miscActionPane = createMiscActionPane();
 * JXTaskPane detailsPane = createDetailsPane();
 * taskPaneContainer.add(actionPane);
 * taskPaneContainer.add(miscActionPane);
 * taskPaneContainer.add(detailsPane);
 *
 * // put the action list on the left in a JScrollPane
 * // as we have several taskPane and we want to make sure they
 * // all get visible.
 * frame.add(new JScrollPane(taskPaneContainer), BorderLayout.EAST);
 *
 * // and a file browser in the middle
 * frame.add(fileBrowser, BorderLayout.CENTER);
 *
 * frame.pack().
 * frame.setVisible(true);
 * 
 * 
 *
 * @author Frederic Lavigne
 */
@JavaBean
public class JXTaskPaneContainer extends JXPanel {

    public static final String uiClassID = "swingx/TaskPaneContainerUI";

    // ensure at least the default ui is registered
    static {
        LookAndFeelAddons.contribute(new TaskPaneContainerAddon());
    }

    /**
     * Creates a new empty task pane.
     */
    public JXTaskPaneContainer() {
        super(null);
        updateUI();

        addContainerListener(new ContainerAdapter() {
            @Override
            public void componentRemoved(ContainerEvent e) {
                repaint();
            }
        });
        setScrollableHeightHint(ScrollableSizeHint.PREFERRED_STRETCH);
    }

    /**
     * {@inheritDoc}
     */
    @Override
    public TaskPaneContainerUI getUI() {
        return (TaskPaneContainerUI) super.getUI();
    }

    /**
     * Notification from the UIManager that the L&F has changed.
     * Replaces the current UI object with the latest version from the
     * UIManager.
     *
     * @see javax.swing.JComponent#updateUI
     */
    @Override
    public void updateUI() {
        setUI((TaskPaneContainerUI) LookAndFeelAddons.getUI(this, TaskPaneContainerUI.class));
    }

    /**
     * Sets the L&F object that renders this component.
     *
     * @param ui the TaskPaneContainerUI L&F object
     * @see javax.swing.UIDefaults#getUI
     */
    public void setUI(TaskPaneContainerUI ui) {
        super.setUI(ui);
    }

    /**
     * Returns the name of the L&F class that renders this component.
     *
     * @return the string {@link #uiClassID}
     * @see javax.swing.JComponent#getUIClassID
     * @see javax.swing.UIDefaults#getUI
     */
    @Override
    public String getUIClassID() {
        return uiClassID;
    }
}