| /* BasicDesktopPaneUI.java -- |
| Copyright (C) 2004 Free Software Foundation, Inc. |
| |
| This file is part of GNU Classpath. |
| |
| GNU Classpath is free software; you can redistribute it and/or modify |
| it under the terms of the GNU General Public License as published by |
| the Free Software Foundation; either version 2, or (at your option) |
| any later version. |
| |
| GNU Classpath 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 |
| General Public License for more details. |
| |
| You should have received a copy of the GNU General Public License |
| along with GNU Classpath; see the file COPYING. If not, write to the |
| Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA |
| 02110-1301 USA. |
| |
| Linking this library statically or dynamically with other modules is |
| making a combined work based on this library. Thus, the terms and |
| conditions of the GNU General Public License cover the whole |
| combination. |
| |
| As a special exception, the copyright holders of this library give you |
| permission to link this library with independent modules to produce an |
| executable, regardless of the license terms of these independent |
| modules, and to copy and distribute the resulting executable under |
| terms of your choice, provided that you also meet, for each linked |
| independent module, the terms and conditions of the license of that |
| module. An independent module is a module which is not derived from |
| or based on this library. If you modify this library, you may extend |
| this exception to your version of the library, but you are not |
| obligated to do so. If you do not wish to do so, delete this |
| exception statement from your version. */ |
| |
| |
| package javax.swing.plaf.basic; |
| |
| import java.awt.Color; |
| import java.awt.Dimension; |
| import java.awt.event.ActionEvent; |
| import java.beans.PropertyVetoException; |
| |
| import javax.swing.AbstractAction; |
| import javax.swing.DefaultDesktopManager; |
| import javax.swing.DesktopManager; |
| import javax.swing.JComponent; |
| import javax.swing.JDesktopPane; |
| import javax.swing.JInternalFrame; |
| import javax.swing.KeyStroke; |
| import javax.swing.UIManager; |
| import javax.swing.plaf.ComponentUI; |
| import javax.swing.plaf.DesktopPaneUI; |
| import javax.swing.plaf.UIResource; |
| |
| /** |
| * This class is the UI delegate for JDesktopPane for the Basic look and feel. |
| */ |
| public class BasicDesktopPaneUI extends DesktopPaneUI |
| { |
| /** |
| * This helper class is used to handle key events that cause JInternalFrames |
| * to be closed. |
| */ |
| protected class CloseAction extends AbstractAction |
| { |
| /** |
| * This method is called when the action is performed. |
| * |
| * @param e The ActionEvent. |
| */ |
| public void actionPerformed(ActionEvent e) |
| { |
| if (desktop.getSelectedFrame() != null) |
| { |
| try |
| { |
| desktop.getSelectedFrame().setClosed(true); |
| } |
| catch (PropertyVetoException pve) |
| { |
| // We do nothing if the attempts has been vetoed. |
| } |
| } |
| } |
| |
| /** |
| * This method returns whether the action is enabled. |
| * |
| * @return Whether the action is enabled. |
| */ |
| public boolean isEnabled() |
| { |
| if (desktop.getSelectedFrame() != null) |
| return desktop.getSelectedFrame().isClosable(); |
| return false; |
| } |
| } |
| |
| /** |
| * This helper class is used to handle key events that cause JInternalFrames |
| * to be maximized. |
| */ |
| protected class MaximizeAction extends AbstractAction |
| { |
| /** |
| * This method is called when the action is performed. |
| * |
| * @param e The ActionEvent. |
| */ |
| public void actionPerformed(ActionEvent e) |
| { |
| if (desktop.getSelectedFrame() != null) |
| { |
| try |
| { |
| desktop.getSelectedFrame().setMaximum(true); |
| } |
| catch (PropertyVetoException pve) |
| { |
| // We do nothing if the attempts has been vetoed. |
| } |
| } |
| } |
| |
| /** |
| * This method returns whether the action is enabled. |
| * |
| * @return Whether the action is enabled. |
| */ |
| public boolean isEnabled() |
| { |
| if (desktop.getSelectedFrame() != null) |
| return desktop.getSelectedFrame().isMaximizable(); |
| return false; |
| } |
| } |
| |
| /** |
| * This helper class is used to handle key events that cause JInternalFrames |
| * to be minimized. |
| */ |
| protected class MinimizeAction extends AbstractAction |
| { |
| /** |
| * This method is called when the action is performed. |
| * |
| * @param e The ActionEvent. |
| */ |
| public void actionPerformed(ActionEvent e) |
| { |
| if (desktop.getSelectedFrame() != null) |
| { |
| try |
| { |
| desktop.getSelectedFrame().setIcon(true); |
| } |
| catch (PropertyVetoException pve) |
| { |
| // We do nothing if the attempt has been vetoed. |
| } |
| } |
| } |
| |
| /** |
| * This method returns whether the action is enabled. |
| * |
| * @return Whether the action is enabled. |
| */ |
| public boolean isEnabled() |
| { |
| if (desktop.getSelectedFrame() != null) |
| return desktop.getSelectedFrame().isIconifiable(); |
| return false; |
| } |
| } |
| |
| /** |
| * This helper class is used to handle key events that pass the SELECTED |
| * property to the next JInternalFrame in the JDesktopPane's list of |
| * children. |
| */ |
| protected class NavigateAction extends AbstractAction |
| { |
| /** |
| * This method is called when the action is performed. |
| * |
| * @param e The ActionEvent. |
| */ |
| public void actionPerformed(ActionEvent e) |
| { |
| // This is supposed to set the next selected frame. |
| JInternalFrame[] frames = desktop.getAllFrames(); |
| if (frames.length == 0) |
| return; |
| |
| JInternalFrame sFrame = frames[0]; |
| if (desktop.getSelectedFrame() != null) |
| sFrame = desktop.getSelectedFrame(); |
| |
| int i = 0; |
| for (; i < frames.length; i++) |
| if (frames[i] == sFrame) |
| break; |
| |
| // FIXME: Navigate actions go reverse too. |
| if (i == frames.length) |
| i = 0; |
| |
| desktop.setSelectedFrame(frames[i]); |
| } |
| |
| /** |
| * This method returns whether the action is enabled. |
| * |
| * @return Whether this action is enabled. |
| */ |
| public boolean isEnabled() |
| { |
| // Always true. |
| return true; |
| } |
| } |
| |
| /** |
| * This helper class is used to restore the JInternalFrame to its original |
| * size before maximizing or iconifying. |
| */ |
| protected class OpenAction extends AbstractAction |
| { |
| /** |
| * This method is called when the action is performed. |
| * |
| * @param e The ActionEvent. |
| */ |
| public void actionPerformed(ActionEvent e) |
| { |
| JInternalFrame frame = desktop.getSelectedFrame(); |
| if (frame != null) |
| { |
| try |
| { |
| if (frame.isIcon()) |
| frame.setIcon(false); |
| else if (frame.isMaximum()) |
| frame.setMaximum(false); |
| } |
| catch (PropertyVetoException pve) |
| { |
| // We do nothing if the attempt has been vetoed. |
| } |
| } |
| } |
| |
| /** |
| * This method returns whether the action is enabled. |
| * |
| * @return Whether this action is enabled. |
| */ |
| public boolean isEnabled() |
| { |
| // JInternalFrames are always restorable. |
| return true; |
| } |
| } |
| |
| /** |
| * The KeyStroke associated with closing JInternalFrames. |
| * @deprecated |
| */ |
| protected KeyStroke closeKey; |
| |
| /** |
| * The KeyStroke associated with maximizing JInternalFrames. |
| * @deprecated |
| */ |
| protected KeyStroke maximizeKey; |
| |
| /** |
| * The KeyStroke associated with minimizing JInternalFrames. |
| * @deprecated |
| */ |
| protected KeyStroke minimizeKey; |
| |
| /** |
| * The KeyStroke associated with navigating (forward?) through |
| * JInternalFrames. |
| * @deprecated |
| */ |
| protected KeyStroke navigateKey; |
| |
| /** |
| * The KeyStroke associated with navigating (backward?) through |
| * JInternalFrames. |
| * @deprecated |
| */ |
| protected KeyStroke navigateKey2; |
| |
| /** The default desktop manager used with JDesktopPane. */ |
| protected DesktopManager desktopManager; |
| |
| /** The JDesktopPane this UI is used with. */ |
| protected JDesktopPane desktop; |
| |
| /** |
| * Creates a new BasicDesktopPaneUI object. |
| */ |
| public BasicDesktopPaneUI() |
| { |
| // Nothing to do here. |
| } |
| |
| /** |
| * This method creates a BasicDesktopPaneUI for the given JComponent. |
| * |
| * @param c The JComponent to create a UI for. |
| * |
| * @return A new BasicDesktopPaneUI. |
| */ |
| public static ComponentUI createUI(JComponent c) |
| { |
| return new BasicDesktopPaneUI(); |
| } |
| |
| /** |
| * This method returns the maximum size for the given JComponent. |
| * |
| * @param c The JComponent to find a maximum size for. |
| * |
| * @return The maximum size for the given JComponent. |
| */ |
| public Dimension getMaximumSize(JComponent c) |
| { |
| return getPreferredSize(c); |
| } |
| |
| /** |
| * This method returns the minimum size for the given JComponent. |
| * |
| * @param c The JComponent to find a minimum size for. |
| * |
| * @return The minimum size for the given JComponent. |
| */ |
| public Dimension getMinimumSize(JComponent c) |
| { |
| return getPreferredSize(c); |
| } |
| |
| /** |
| * This method returns the preferred size for the given JComponent. |
| * |
| * @param c The JComponent to find a preferred size for. |
| * |
| * @return The preferred size for the given JComponent. |
| */ |
| public Dimension getPreferredSize(JComponent c) |
| { |
| // return null because JDesktopPanes don't have preferred sizes. |
| return null; |
| } |
| |
| /** |
| * This method installs the defaults for the JDesktopPane provided by the |
| * current look and feel. |
| */ |
| protected void installDefaults() |
| { |
| Color bg = desktop.getBackground(); |
| if (bg == null || bg instanceof UIResource) |
| desktop.setBackground(UIManager.getColor("desktop")); |
| } |
| |
| /** |
| * This method installs the desktop manager for the JDesktopPane. |
| */ |
| protected void installDesktopManager() |
| { |
| desktopManager = new DefaultDesktopManager(); |
| desktop.setDesktopManager(desktopManager); |
| } |
| |
| /** |
| * This method installs the keyboard actions for the JDesktopPane. |
| */ |
| protected void installKeyboardActions() |
| { |
| // FIXME: create actions and keystrokes. |
| registerKeyboardActions(); |
| } |
| |
| /** |
| * This method installs the UI for the given JComponent. |
| * |
| * @param c The JComponent to install this UI for. |
| */ |
| public void installUI(JComponent c) |
| { |
| if (c instanceof JDesktopPane) |
| { |
| desktop = (JDesktopPane) c; |
| |
| installDefaults(); |
| installDesktopManager(); |
| installKeyboardActions(); |
| } |
| } |
| |
| /** |
| * This method registers the actions to the appropriate Action and Input |
| * maps. |
| */ |
| protected void registerKeyboardActions() |
| { |
| // FIXME: Do the binding. |
| // XXX: the gtk windows tend to intercept a lot of the |
| // key events for themselves. must figure a way past that |
| // before binding |
| } |
| |
| /** |
| * This method reverses the work done by the installDefaults method. |
| */ |
| protected void uninstallDefaults() |
| { |
| desktop.setBackground(null); |
| } |
| |
| /** |
| * This method reverses the work done by the installDesktopManager method. |
| */ |
| protected void uninstallDesktopManager() |
| { |
| desktopManager = null; |
| desktop.setDesktopManager(null); |
| } |
| |
| /** |
| * This method reverses the work done by the installKeyboardActions method. |
| */ |
| protected void uninstallKeyboardActions() |
| { |
| unregisterKeyboardActions(); |
| // FIXME: null the actions and keystrokes. |
| } |
| |
| /** |
| * This method reverses the work done by the registerKeyboardActions method. |
| */ |
| protected void unregisterKeyboardActions() |
| { |
| // FIXME: unmap the keystrokes |
| } |
| |
| /** |
| * This method uninstalls the UI for the given JComponent. It should reverse |
| * all the work done by the installUI method. |
| * |
| * @param c The JComponent to uninstall this UI for. |
| */ |
| public void uninstallUI(JComponent c) |
| { |
| uninstallKeyboardActions(); |
| uninstallDesktopManager(); |
| uninstallDefaults(); |
| |
| desktop = null; |
| } |
| } |