JXTaskPaneContainer.java
资源名称:swingx.zip [点击查看]
上传用户:zhengdagz
上传日期:2014-03-06
资源大小:1956k
文件大小:6k
源码类别:
xml/soap/webservice
开发平台:
Java
- /*
- * $Id: JXTaskPaneContainer.java,v 1.6 2005/10/10 18:01:59 rbair Exp $
- *
- * 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 java.awt.Dimension;
- import java.awt.Rectangle;
- import javax.swing.JComponent;
- import javax.swing.JViewport;
- import javax.swing.Scrollable;
- import org.jdesktop.swingx.plaf.JXTaskPaneContainerAddon;
- import org.jdesktop.swingx.plaf.LookAndFeelAddons;
- import org.jdesktop.swingx.plaf.TaskPaneContainerUI;
- /**
- * <code>JXTaskPaneContainer</code> provides an elegant view
- * to display a list of tasks ordered by groups ({@link org.jdesktop.swingx.JXTaskPane}.
- *
- * <p>
- * Although {@link org.jdesktop.swingx.JXTaskPane} can be added to any other
- * container, the <code>JXTaskPaneContainer</code> 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 <code>JXTaskPaneContainer</code> will be painted with light gradient
- * background. Also <code>JXTaskPaneContainer</code> takes care of using the
- * right {@link java.awt.LayoutManager} (as required by
- * {@link org.jdesktop.swingx.JXCollapsiblePane}) so that
- * {@link org.jdesktop.swingx.JXTaskPane} behaves correctly when collapsing and
- * expanding its content.
- *
- * <p>
- * <code>JXTaskPaneContainer<code> can be added to a JScrollPane.
- *
- * <p>
- * Example:
- * <pre>
- * <code>
- * 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);
- * </code>
- * </pre>
- *
- * @author <a href="mailto:fred@L2FProd.com">Frederic Lavigne</a>
- *
- * @javabean.attribute
- * name="isContainer"
- * value="Boolean.TRUE"
- * rtexpr="true"
- *
- * @javabean.class
- * name="JXTaskPaneContainer"
- * shortDescription="A component that contains JTaskPaneGroups."
- * stopClass="java.awt.Component"
- *
- * @javabean.icons
- * mono16="JXTaskPaneContainer16-mono.gif"
- * color16="JXTaskPaneContainer16.gif"
- * mono32="JXTaskPaneContainer32-mono.gif"
- * color32="JXTaskPaneContainer32.gif"
- */
- public class JXTaskPaneContainer extends JComponent implements Scrollable {
- public final static String uiClassID = "swingx/TaskPaneContainerUI";
- // ensure at least the default ui is registered
- static {
- LookAndFeelAddons.contribute(new JXTaskPaneContainerAddon());
- }
- /**
- * Creates a new empty taskpane.
- */
- public JXTaskPaneContainer() {
- updateUI();
- }
- /**
- * Notification from the <code>UIManager</code> that the L&F has changed.
- * Replaces the current UI object with the latest version from the <code>UIManager</code>.
- *
- * @see javax.swing.JComponent#updateUI
- */
- public void updateUI() {
- setUI((TaskPaneContainerUI)LookAndFeelAddons.getUI(this, TaskPaneContainerUI.class));
- }
- /**
- * Sets the L&F object that renders this component.
- *
- * @param ui the <code>TaskPaneContainerUI</code> L&F object
- * @see javax.swing.UIDefaults#getUI
- *
- * @beaninfo bound: true hidden: true description: The UI object that
- * implements the taskpane's LookAndFeel.
- */
- 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
- */
- public String getUIClassID() {
- return uiClassID;
- }
- /**
- * Adds a <code>JXTaskPane</code> to this JXTaskPaneContainer.
- *
- * @param group
- */
- public void add(JXTaskPane group) {
- super.add(group);
- }
- /**
- * Removes a <code>JXTaskPane</code> from this JXTaskPaneContainer.
- *
- * @param group
- */
- public void remove(JXTaskPane group) {
- super.remove(group);
- }
- /**
- * @see Scrollable#getPreferredScrollableViewportSize()
- */
- public Dimension getPreferredScrollableViewportSize() {
- return getPreferredSize();
- }
- /**
- * @see Scrollable#getScrollableBlockIncrement(java.awt.Rectangle, int, int)
- */
- public int getScrollableBlockIncrement(
- Rectangle visibleRect,
- int orientation,
- int direction) {
- return 10;
- }
- /**
- * @see Scrollable#getScrollableTracksViewportHeight()
- */
- public boolean getScrollableTracksViewportHeight() {
- if (getParent() instanceof JViewport) {
- return (((JViewport)getParent()).getHeight() > getPreferredSize().height);
- } else {
- return false;
- }
- }
- /**
- * @see Scrollable#getScrollableTracksViewportWidth()
- */
- public boolean getScrollableTracksViewportWidth() {
- return true;
- }
- /**
- * @see Scrollable#getScrollableUnitIncrement(java.awt.Rectangle, int, int)
- */
- public int getScrollableUnitIncrement(
- Rectangle visibleRect,
- int orientation,
- int direction) {
- return 10;
- }
- }