/* $Id: UMLComboBoxNavigator.java 18735 2010-09-13 11:37:06Z bobtarling $

  *****************************************************************************

  * Copyright (c) 2009 Contributors - see below

  * All rights reserved. This program and the accompanying materials

  * are made available under the terms of the Eclipse Public License v1.0

  * which accompanies this distribution, and is available at

  * http://www.eclipse.org/legal/epl-v10.html

  *

  * Contributors:

  *    tfmorris

  *****************************************************************************

  *

  * Some portions of this file was previously release using the BSD License:

  */

 // Copyright (c) 1996-2007 The Regents of the University of California. All

 // Rights Reserved. Permission to use, copy, modify, and distribute this

 // software and its documentation without fee, and without a written

 // agreement is hereby granted, provided that the above copyright notice

 // and this paragraph appear in all copies.  This software program and

 // documentation are copyrighted by The Regents of the University of

 // California. The software program and documentation are supplied "AS

 // IS", without any accompanying services from The Regents. The Regents

 // does not warrant that the operation of the program will be

 // uninterrupted or error-free. The end-user understands that the program

 // was developed for research purposes and is advised not to rely

 // exclusively on the program for any reason.  IN NO EVENT SHALL THE

 // UNIVERSITY OF CALIFORNIA BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT,

 // SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS,

 // ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF

 // THE UNIVERSITY OF CALIFORNIA HAS BEEN ADVISED OF THE POSSIBILITY OF

 // SUCH DAMAGE. THE UNIVERSITY OF CALIFORNIA SPECIFICALLY DISCLAIMS ANY

 // WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF

 // MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE

 // PROVIDED HEREUNDER IS ON AN "AS IS" BASIS, AND THE UNIVERSITY OF

 // CALIFORNIA HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT,

 // UPDATES, ENHANCEMENTS, OR MODIFICATIONS.

 package org.argouml.uml.ui;

 import java.awt.BorderLayout;

 import java.awt.Dimension;

 import java.awt.event.ActionListener;

 import java.awt.event.ItemEvent;

 import java.awt.event.ItemListener;

 import javax.swing.ImageIcon;

 import javax.swing.JButton;

 import javax.swing.JComboBox;

 import javax.swing.JPanel;

 import org.argouml.application.helpers.ResourceLoaderWrapper;

 import org.argouml.ui.targetmanager.TargetManager;

 /**

  * This class implements a panel that adds a navigation button to the right of

  * the combo box

  * 

  * @author Curt Arnold

  * @since 0.9

  * @deprecated in 0.31.5 by Bob Tarling. Property panel controls are now

  * internal to the property panel component

  */

 @Deprecated

 public class UMLComboBoxNavigator extends JPanel implements ActionListener,

         ItemListener {

     private static ImageIcon icon = ResourceLoaderWrapper

             .lookupIconResource("ComboNav");

     private JComboBox theComboBox;

     private JButton theButton;

     /**

      * Constructor

      * 

      * @param tooltip

      *            Tooltip key for button

      * @param box

      *            Associated combo box

      */

     public UMLComboBoxNavigator(String tooltip, JComboBox box) {

         super(new BorderLayout());

         theButton = new JButton(icon);

         theComboBox = box;

         theButton.setPreferredSize(new Dimension(icon.getIconWidth() + 6, icon

                 .getIconHeight() + 6));

         theButton.setToolTipText(tooltip);

         theButton.addActionListener(this);

         box.addActionListener(this);

         box.addItemListener(this);

         add(theComboBox, BorderLayout.CENTER);

         add(theButton, BorderLayout.EAST);

         Object item = theComboBox.getSelectedItem();

         setButtonEnabled(item);

     }

     /**

      * Enforce that the preferred height is the minimum height.

      * This works around a bug in Windows LAF of JRE5 where a change

      * in the preferred/min size of a combo has changed and has a knock

      * on effect here.

      * If the layout manager for prop panels finds the preferred

      * height is greater than the minimum height then it will allow

      * this component to resize in error.

      * See issue 4333 - Sun has now fixed this bug in JRE6 and so this

      * method can be removed once JRE5 is no longer supported.

      * @return the preferred size

      */

     @Override

     public Dimension getPreferredSize() {

         return new Dimension(

                 super.getPreferredSize().width,

                 getMinimumSize().height);

     }

     /**

      * Fired when the button is pushed. Navigates to the currently selected item

      * in the combo box.

      * 

      * @see java.awt.event.ActionListener#actionPerformed(java.awt.event.ActionEvent)

      */

     public void actionPerformed(final java.awt.event.ActionEvent event) {

         // button action:

         if (event.getSource() == theButton) {

             Object item = theComboBox.getSelectedItem();

             if (item != null) {

                 TargetManager.getInstance().setTarget(item);

             }

         }

         if (event.getSource() == theComboBox) {

             Object item = theComboBox.getSelectedItem();

             setButtonEnabled(item);

         }

     }

     public void itemStateChanged(ItemEvent event) {

         if (event.getSource() == theComboBox) {

             Object item = theComboBox.getSelectedItem();

             setButtonEnabled(item);

         }

     }

     private void setButtonEnabled(Object item) {

         if (item != null) {

             theButton.setEnabled(true);

         } else {

             theButton.setEnabled(false);

         }

     }

     public void setEnabled(boolean enabled) {

         theComboBox.setEnabled(enabled);

         theComboBox.setEditable(enabled);

     }

 }