/[schmitzm]/trunk/src/skrueger/geotools/MapPaneToolBar.java
ViewVC logotype

Diff of /trunk/src/skrueger/geotools/MapPaneToolBar.java

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

trunk/src/skrueger/geotools/MapPaneToolBar.java revision 111 by alfonx, Tue May 12 23:33:14 2009 UTC branches/2.0-RC1/src/skrueger/geotools/MapPaneToolBar.java revision 604 by alfonx, Wed Dec 9 14:15:53 2009 UTC
# Line 1  Line 1 
1  package skrueger.geotools;  /*******************************************************************************
2     * Copyright (c) 2009 Martin O. J. Schmitz.
3  import java.awt.Dimension;   *
4  import java.awt.event.ActionEvent;   * This file is part of the SCHMITZM library - a collection of utility
5  import java.util.ArrayList;   * classes based on Java 1.6, focusing (not only) on Java Swing
6  import java.util.SortedMap;   * and the Geotools library.
7  import java.util.TreeMap;   *
8     * The SCHMITZM project is hosted at:
9  import javax.swing.AbstractAction;   * http://wald.intevation.org/projects/schmitzm/
10  import javax.swing.AbstractButton;   *
11  import javax.swing.BorderFactory;   * This program is free software; you can redistribute it and/or
12  import javax.swing.Icon;   * modify it under the terms of the GNU Lesser General Public License
13  import javax.swing.ImageIcon;   * as published by the Free Software Foundation; either version 3
14  import javax.swing.JButton;   * of the License, or (at your option) any later version.
15  import javax.swing.JComponent;   *
16  import javax.swing.JToggleButton;   * This program is distributed in the hope that it will be useful,
17  import javax.swing.JToolBar;   * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  import javax.swing.JToolBar.Separator;   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19     * GNU General Public License for more details.
20  import jj2000.j2k.NotImplementedError;   *
21     * You should have received a copy of the GNU Lesser General Public License (license.txt)
22  import org.apache.log4j.Logger;   * along with this program; if not, write to the Free Software
23     * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
24  import schmitzm.geotools.gui.JMapPane;   * or try this link: http://www.gnu.org/licenses/lgpl.html
25  import schmitzm.geotools.map.event.JMapPaneEvent;   *
26  import schmitzm.geotools.map.event.JMapPaneListener;   * Contributors:
27  import schmitzm.geotools.map.event.MapAreaChangedEvent;   *     Martin O. J. Schmitz - initial API and implementation
28  import schmitzm.swing.ButtonGroup;   *     Stefan A. Krüger - additional utility classes
29  import schmitzm.swing.SwingUtil;   ******************************************************************************/
30    package skrueger.geotools;
31  import com.vividsolutions.jts.geom.Envelope;  
32    import java.awt.Color;
33  /**  import java.awt.Graphics;
34   * A toolbar to control an {@link JMapPane} (Atlas visualization). This contains two types  import java.awt.event.ActionEvent;
35   * of buttons. A group of <i>tools</i> for the mouse actions on the map represented  import java.awt.event.ActionListener;
36   * by {@link JToggleButton JToggleButtons}, where only one tool can be activated  import java.util.ArrayList;
37   * every time. And some (general) <i>actions</i>, represented by normal  import java.util.HashSet;
38   * {@link JButton JButtons}.  import java.util.Locale;
39   * @author <a href="mailto:[email protected]">Martin Schmitz</a> (University of Bonn/Germany)  import java.util.Set;
40   * @version 1.2 Stefan Krüger  import java.util.SortedMap;
41   */  import java.util.TreeMap;
42  public class MapPaneToolBar extends JToolBar {  
43          private static final Logger LOGGER = Logger.getLogger(MapPaneToolBar.class.getName());  import javax.swing.AbstractAction;
44          /** Constant for the tool "Panning" (10). */  import javax.swing.AbstractButton;
45          public static final int TOOL_PAN = 10;  import javax.swing.Action;
46          /** Constant for the tool "Info" (20). */  import javax.swing.Icon;
47          public static final int TOOL_INFO = 20;  import javax.swing.ImageIcon;
48          public static final int SEPERATOR0 = 99;  import javax.swing.JButton;
49            import javax.swing.JComponent;
50          /** Constant for the tool "Zoom In" (110). */  import javax.swing.JToggleButton;
51          public static final int TOOL_ZOOMIN = 110;  import javax.swing.JToolBar;
52          /** Constant for the tool "Zoom Out" (120). */  
53          public static final int TOOL_ZOOMOUT = 120;  import org.apache.log4j.Logger;
54          /** Constant for the action "Zoom back" (130). */  
55          public static final int ACTION_ZOOM_BACK = 130;  import schmitzm.geotools.gui.SelectableXMapPane;
56          /** Constant for the action "Zoom forward" (140). */  import schmitzm.geotools.map.event.MapPaneEvent;
57          public static final int ACTION_ZOOM_FORWARD = 140;  import schmitzm.geotools.map.event.JMapPaneListener;
58          public static final int SEPERATOR1 = 199;  import schmitzm.geotools.map.event.MapAreaChangedEvent;
59            import schmitzm.lang.LangUtil;
60          /** Constant for the tool "Select" which sets the Selection to the selected features (210). */  import schmitzm.lang.ResourceProvider;
61          public static final int TOOL_SELECTION_SET = 210;  import schmitzm.swing.ButtonGroup;
62          /** Constant for the tool "Selection add" which adds the features to the Selection (220). */  import schmitzm.swing.SwingUtil;
63          public static final int TOOL_SELECTION_ADD = 220;  import skrueger.swing.SmallButton;
64          /** Constant for the tool "Selection subtract" which removes the selected features from the selection (230). */  import skrueger.swing.SmallToggleButton;
65          public static final int TOOL_SELECTION_REMOVE = 230;  
66          /** Constant for the tool "Selection Reset" which clears the selection (240). */  import com.vividsolutions.jts.geom.Envelope;
67          public static final int TOOL_SELECTION_CLEAR = 240;  
68          public static final int SEPERATOR2 = 299;  /**
69     * A toolbar to control an {@link SelectableXMapPane} (Atlas visualization). This contains
70          /** Constant for the action "Search Labels" (120). */   * two types of buttons. A group of <i>tools</i> for the mouse actions on the
71          public static final int ACTION_SEARCH = 300;   * map represented by {@link JToggleButton JToggleButtons}, where only one tool
72     * can be activated every time. And some (general) <i>actions</i>, represented
73          /** Tool currently selected */   * by normal {@link JButton JButtons}.
74      protected int selectedTool = TOOL_ZOOMIN;   *
75         * @author <a href="mailto:[email protected]">Martin Schmitz</a>
76      /** Holds the tool buttons of the tool bar. */   *         (University of Bonn/Germany)
77      protected SortedMap<Integer, JComponent> toolAndActionButtons = null;   * @version 1.2 Stefan Krüger
78      /** Controls that only one tool button is activated. */   */
79      protected ButtonGroup toolButtonGroup = null;  public class MapPaneToolBar extends JToolBar {
80            private static final Logger LOGGER = Logger.getLogger(MapPaneToolBar.class
81  // SK: Musste ich ändern damit man Tools und Actions in der Reihenfolge mischen kann.                              .getName());
82  //    /** Holds the action buttons of the bar. */  
83  //    protected SortedMap<Integer, JButton> actionButtons = null;          public static ResourceProvider RESOURCE = new ResourceProvider(LangUtil
84                            .extendPackagePath(MapPaneToolBar.class,
85          /** Holds the {@link JMapPane} this tool bar controls. */                                          "resource.locales.mapPaneToolbar"), Locale.ENGLISH);
86          protected JMapPane mapPane = null;  
87            public static String R(String key, Object... values) {
88          /**                  return RESOURCE.getString(key, values);
89           * A List to remember the last Envelopes that have been watched. Used for          }
90           * the zoomBack- and zoomForwardButtons *  
91           */          /** Constant for the tool "Panning" (10). */
92          protected ArrayList<Envelope> lastZooms = new ArrayList<Envelope>();          public static final int TOOL_PAN = 10;
93          /** Holds the index to the current element in {@link #lastZooms}. */          /** Constant for the tool "Info" (20). */
94          protected int zoomBackIndex = 0;          public static final int TOOL_INFO = 20;
95            public static final int SEPERATOR0 = 99;
96          /** Listener to sniff the zoom actions on the map. */  
97          protected JMapPaneListener mapPaneListener = null;          /** Constant for the tool "Zoom In" (110). */
98                    public static final int TOOL_ZOOMIN = 110;
99          protected boolean zoomBackForwardButtonInAction;          /** Constant for the tool "Zoom Out" (120). */
100            public static final int TOOL_ZOOMOUT = 120;
101      /**          /** Constant for the action "Zoom back" (130). */
102       * Creates a new toolbar. Notice: This toolbar does nothing          public static final int ACTION_ZOOM_BACK = 130;
103       * until {@link #setMapPane(JMapPane)} is called!          /** Constant for the action "Zoom forward" (140). */
104       */          public static final int ACTION_ZOOM_FORWARD = 140;
105      public MapPaneToolBar() {          public static final int SEPERATOR1 = 199;
106        this(null);  
107      }          /**
108                 * Constant for the tool "Selection Reset" which clears the selection (240).
109      /**           */
110           * Creates a new tool bar.          public static final int TOOL_SELECTION_CLEAR = 240;
111           * @param mapPane {@link JMapPane} the tool bar controls  
112           */          /**
113          public MapPaneToolBar(JMapPane mapPane) {           * Constant for the tool "Select" which sets the Selection to the selected
114            super("Control the map", JToolBar.HORIZONTAL);           * features (210).
115        this.toolAndActionButtons  = new TreeMap<Integer,JComponent>();           */
116        this.toolButtonGroup = new ButtonGroup();          public static final int TOOL_SELECTION_SET = 210;
117        // Create a Listener to sniff the zooms on the JMapPane          /**
118        this.mapPaneListener = new JMapPaneListener() {           * Constant for the tool "Selection add" which adds the features to the
119            public void performMapPaneEvent(JMapPaneEvent e) {           * Selection (220).
120                if ( !(e instanceof MapAreaChangedEvent) )           */
121                  return;          public static final int TOOL_SELECTION_ADD = 220;
122                            /**
123                if ( zoomBackForwardButtonInAction ) {           * Constant for the tool "Selection subtract" which removes the selected
124                  zoomBackForwardButtonInAction = false;           * features from the selection (230).
125                  return;           */
126                }          public static final int TOOL_SELECTION_REMOVE = 230;
127                
128                Envelope oldMapArea = ((MapAreaChangedEvent)e).getOldMapArea();          public static final int ACTION_CHARTS = 401;
129                if (lastZooms.size() == 0 && oldMapArea != null ) {  
130                  lastZooms.add(oldMapArea);          /** Tool currently selected */
131                  zoomBackIndex = 1;          protected int selectedTool = TOOL_ZOOMIN;
132                }  
133            /** Holds the tool buttons of the tool bar. */
134                final Envelope mapArea = ((MapAreaChangedEvent)e).getNewMapArea();          final protected SortedMap<Integer, JComponent> toolAndActionButtons = new TreeMap<Integer, JComponent>();
135                if (mapArea == null)          /** Controls that only one tool button is activated. */
136                  return;          protected ButtonGroup toolButtonGroup = null;
137                  
138                if (lastZooms.size() > 0 && mapArea.equals(lastZooms.get(lastZooms.size() - 1))) {          // SK: Musste ich ändern damit man Tools und Actions in der Reihenfolge
139                  // LOGGER.debug("MapAreaChangedEvent ausgelassen bei der Zaehlung der Zoomschritt weil identisch");          // mischen kann.
140                  return;          // /** Holds the action buttons of the bar. */
141                }          // protected SortedMap<Integer, JButton> actionButtons = null;
142    
143                if (lastZooms.size() > 0)          /** Holds the {@link SelectableXMapPane} this tool bar controls. */
144                  while (zoomBackIndex < lastZooms.size())          protected SelectableXMapPane mapPane = null;
145                    lastZooms.remove(lastZooms.size() - 1);  
146            /**
147                lastZooms.add(mapArea);           * A List to remember the last Envelopes that have been watched. Used for
148                zoomBackIndex = lastZooms.size();           * the zoomBack- and zoomForwardButtons *
149                setButtonEnabled(ACTION_ZOOM_BACK, lastZooms.size() > 1);           */
150                setButtonEnabled(ACTION_ZOOM_FORWARD, false);          protected ArrayList<Envelope> lastZooms = new ArrayList<Envelope>();
151            }          /** Holds the index to the current element in {@link #lastZooms}. */
152        };              protected int zoomBackIndex = 0;
153        
154        setMapPane(mapPane);          /** Listener to sniff the zoom actions on the map. */
155            setFloatable(false);          protected JMapPaneListener mapPaneListener = null;
156            setRollover(true);  
157                      protected boolean zoomBackForwardButtonInAction;
158            init();  
159          }          /** Listeners what want to be informed about a change of the selected tool **/
160                    protected Set<MapPaneToolSelectedListener> toolSelectionListeners = new HashSet<MapPaneToolSelectedListener>();
161          /**  
162           * Sets the {@link JMapPane} controlled by this tool bar.          /** This listener is added to all {@link JToggleButton} **/
163           * @param mapPane {@link JMapPane} to control (if {@code null} this          private final ActionListener toolSelectedListener = new ActionListener() {
164           *                tool bar controls NOTHING!)  
165           */                  @Override
166          public void setMapPane(JMapPane mapPane) {                  public void actionPerformed(ActionEvent e) {
167            // Remove listener from old MapPane                          JToggleButton tb = (JToggleButton) e.getSource();
168            if ( this.mapPane != null )  
169              this.mapPane.removeMapPaneListener( mapPaneListener );                          // Inform the listeners about a newly selected tool
170        this.mapPane = mapPane;                          for (MapPaneToolSelectedListener l : toolSelectionListeners) {
171        if ( this.mapPane != null && mapPaneListener != null )                                  l.toolSelected(Integer.valueOf(tb.getName()));
172          this.mapPane.addMapPaneListener( mapPaneListener );                          }
173          }                  }
174            
175          /**          };
176           * Calls {@link #initToolsAndActions()} and {@link #initActions()} and then puts  
177           * all tool buttons and all actions buttons to the tool bar.          /**
178           */           * Creates a new toolbar. Notice: This toolbar does nothing until
179          protected void init() {           * {@link #setMapPane(SelectableXMapPane)} is called!
180            initToolsAndActions();           */
181                  public MapPaneToolBar() {
182            addSeparator(SEPERATOR0, new JToolBar.Separator());                  this(null);
183        addSeparator(SEPERATOR1, new JToolBar.Separator());          }
184        addSeparator(SEPERATOR2, new JToolBar.Separator());  
185                  public void addButtonSelectedListener(MapPaneToolSelectedListener listener) {
186            initToolBar();                  toolSelectionListeners.add(listener);
187          }          }
188    
189            public void removeButtonSelectedListener(
190          /**                          MapPaneToolSelectedListener listener) {
191           * Creates the tool buttons and action buttons and seperators, adds them to                  toolSelectionListeners.remove(listener);
192           * {@link #toolAndActionButtons} and finally creates a button group for all tools.          }
193           * So sub-classes which override this method should FIRST add their new tool  
194           * buttons to {@link #toolAndActionButtons} before calling {@code super.initTools()}.          /**
195           */           * Creates a new tool bar.
196          protected void initToolsAndActions() {           *
197        // Panning           * @param mapPane
198        addTool( new MapPaneToolBarAction(           *            {@link SelectableXMapPane} the tool bar controls
199            TOOL_PAN,           */
200            this,          public MapPaneToolBar(SelectableXMapPane mapPane) {
201            "",                  super("Control the map", JToolBar.HORIZONTAL);
202            new ImageIcon(MapView.class.getResource("resource/icons/pan.png"))  
203        ), false );                  // I want to see nothing on the background
204        // Info                  setOpaque(false);
205        addTool( new MapPaneToolBarAction(                  setBorder(null);
206            TOOL_INFO,  
207            this,                  this.toolButtonGroup = new ButtonGroup();
208            "",  
209            new ImageIcon(MapView.class.getResource("resource/icons/info.png"))                  // Create a Listener to listen to the zooms on the JMapPane
210        ), false );                  this.mapPaneListener = new JMapPaneListener() {
211                                  public void performMapPaneEvent(MapPaneEvent e) {
212        // Set Selection                                  if (!(e instanceof MapAreaChangedEvent))
213        addTool( new MapPaneToolBarAction(                                          return;
214            TOOL_SELECTION_SET,  
215            this,                                  if (zoomBackForwardButtonInAction) {
216            "",                                          zoomBackForwardButtonInAction = false;
217            new ImageIcon(MapView.class.getResource("resource/icons/selection_set.png"))                                          return;
218        ), false );                                  }
219    
220        // Add Selection                                  final MapAreaChangedEvent mapAreaChangedEvent = (MapAreaChangedEvent) e;
221        addTool( new MapPaneToolBarAction(                                  Envelope oldMapArea = mapAreaChangedEvent.getOldMapArea();
222                    TOOL_SELECTION_ADD,  
223                    this,                                  final Envelope mapArea = mapAreaChangedEvent.getNewMapArea();
224                    "",                                  if (mapArea == null || mapArea.equals(oldMapArea)
225                    new ImageIcon(MapView.class.getResource("resource/icons/selection_add.png"))                                                  || Double.isNaN(mapArea.getMinX())
226        ), false );                                                  || Double.isNaN(mapArea.getMaxX())
227                                                    || Double.isNaN(mapArea.getMinY())
228        // Remove Selection                                                  || Double.isNaN(mapArea.getMaxY())) {
229        addTool( new MapPaneToolBarAction(                                          // If the MapArea didn't change... we don't want to register
230                    TOOL_SELECTION_REMOVE,                                          // it as a zoom action.
231                    this,                                          return;
232                    "",                                  }
233                    new ImageIcon(MapView.class.getResource("resource/icons/selection_remove.png"))  
234        ), false );                                  if (lastZooms.size() == 0
235                                                          && oldMapArea != null
236        // ResetSelection                                                  && !oldMapArea.isNull()
237        addAction( new MapPaneToolBarAction(                                                  && !(Double.isNaN(oldMapArea.getMinX())
238                    TOOL_SELECTION_CLEAR,                                                                  || Double.isNaN(oldMapArea.getMaxX())
239                    this,                                                                  || Double.isNaN(oldMapArea.getMinY()) || Double
240                    "",                                                                  .isNaN(oldMapArea.getMaxY()))) {
241                    new ImageIcon(MapView.class.getResource("resource/icons/selection_clear.png"))                                          lastZooms.add(oldMapArea);
242        ), false );                                          zoomBackIndex = 1;
243                                          }
244        // Zoom in                                  if (mapArea == null)
245        addTool( new MapPaneToolBarAction(                                          return;
246            TOOL_ZOOMIN,  
247            this,                                  if (lastZooms.size() > 0
248            "",                                                  && mapArea.equals(lastZooms.get(lastZooms.size() - 1))) {
249            new ImageIcon(MapView.class.getResource("resource/icons/zoom_in.png"))                                          // LOGGER.debug("MapAreaChangedEvent ausgelassen bei der Zaehlung der Zoomschritt weil identisch");
250        ), false );                                          return;
251        // Zoom out                                  }
252        addTool( new MapPaneToolBarAction(  
253            TOOL_ZOOMOUT,                                  if (lastZooms.size() > 0)
254            this,                                          while (zoomBackIndex < lastZooms.size())
255            "",                                                  lastZooms.remove(lastZooms.size() - 1);
256            new ImageIcon(MapView.class.getResource("resource/icons/zoom_out.png"))  
257        ), false );                                  lastZooms.add(mapArea);
258                                          zoomBackIndex = lastZooms.size();
259        // Action button to revert the last zoom                                  setButtonEnabled(ACTION_ZOOM_BACK, lastZooms.size() > 1);
260        addAction( new MapPaneToolBarAction(                                  setButtonEnabled(ACTION_ZOOM_FORWARD, false);
261            ACTION_ZOOM_BACK,                          }
262            this,                  };
263            "",  
264            new ImageIcon(MapView.class.getResource("resource/icons/zoom_back.png"))                  setMapPane(mapPane);
265        ), false);                  setFloatable(false);
266        setButtonEnabled( ACTION_ZOOM_BACK, false );                  setRollover(true);
267    
268        // Action button to redo the last zoom                  init();
269        addAction( new MapPaneToolBarAction(          }
270            ACTION_ZOOM_FORWARD,  
271            this,          /**
272            "",           * Sets the {@link SelectableXMapPane} controlled by this tool bar.
273            new ImageIcon(MapView.class.getResource("resource/icons/zoom_forward.png"))           *
274        ), false);           * @param mapPane
275        setButtonEnabled( ACTION_ZOOM_FORWARD, false );           *            {@link SelectableXMapPane} to control (if {@code null} this tool bar
276                   *            controls NOTHING!)
277                   */
278            // set the selected tool enabled          public void setMapPane(SelectableXMapPane mapPane) {
279        setSelectedTool(selectedTool);                  // Remove listener from old MapPane
280                          if (this.mapPane != null)
281          }                          this.mapPane.removeMapPaneListener(mapPaneListener);
282                    this.mapPane = mapPane;
283                    if (this.mapPane != null && mapPaneListener != null)
284          /**                          this.mapPane.addMapPaneListener(mapPaneListener);
285       * Clears the GUI of all components and adds all tool and action buttons to the          }
286       * tool bar.  
287       */          /**
288      protected void initToolBar() {           * Calls {@link #initToolsAndActions()} and {@link #initActions()} and then
289        setAlignmentY( 1f );           * puts all tool buttons and all actions buttons to the tool bar.
290        removeAll();           */
291        // Separator to the left of the tool actions to start          protected void init() {
292        // the tool buttons with the map (not with the coordinate grid)  
293        Dimension dimension = new Dimension( 49,10);                  initToolsAndActions();
294        addSeparator(dimension);  
295        // Tool buttons                  addSeparator(SEPERATOR0, new JToolBar.Separator());
296        for (JComponent b : toolAndActionButtons.values())                  addSeparator(SEPERATOR1, new JToolBar.Separator());
297          add(b);  
298      }                  initToolBar();
299        // Space between tool buttons and action buttons          }
300  // SK: Seperators are now als manages like actions and tools        
301  //      Dimension dimension2 = new Dimension( 10,10);          /**
302  //      this.addSeparator(dimension2);           * Creates the tool buttons and action buttons and seperators, adds them to
303                   * {@link #toolAndActionButtons} and finally creates a button group for all
304  //      // Action buttons           * tools. So sub-classes which override this method should FIRST add their
305  //      for (JButton b : actionButtons.values())           * new tool buttons to {@link #toolAndActionButtons} before calling {@code
306  //        add(b);           * super.initTools()}.
307  //    }           */
308                protected void initToolsAndActions() {
309          /**                  // Panning
310           * Performs the activation of a tool.                  addTool(new MapPaneToolBarAction(TOOL_PAN, this, "", new ImageIcon(
311           * @param tool the tool to activate                                  MapView.class.getResource("resource/icons/pan.png")),
312           * @param e    the event of the button                                  R("MapPaneButtons.Pan.TT")), false);
313           */                  // Info
314          public void performToolButton(int tool, ActionEvent e) {                  addTool(new MapPaneToolBarAction(TOOL_INFO, this, "", new ImageIcon(
315            if ( mapPane == null )                                  MapView.class.getResource("resource/icons/info.png")),
316              return;                                  R("MapPaneButtons.Info.TT")), false);
317              
318            selectedTool = tool;                  // Zoom in
319                              addTool(new MapPaneToolBarAction(TOOL_ZOOMIN, this, "", new ImageIcon(
320        switch( tool ) {                                  MapView.class.getResource("resource/icons/zoom_in.png")),
321          case TOOL_PAN:                                  R("MapPaneButtons.ZoomIn.TT")), false);
322            // Set the mouse tool to "Panning"                  // Zoom out
323            mapPane.setWindowSelectionState(JMapPane.NONE);                  addTool(new MapPaneToolBarAction(TOOL_ZOOMOUT, this, "", new ImageIcon(
324            mapPane.setState(JMapPane.PAN);                                  MapView.class.getResource("resource/icons/zoom_out.png")),
325            mapPane.setHighlight(false);                                  R("MapPaneButtons.ZoomOut.TT")), false);
326            mapPane.setNormalCursor(SwingUtil.PAN_CURSOR);  
327            break;                  // Action button to revert the last zoom
328          case TOOL_INFO:                  addAction(new MapPaneToolBarAction(ACTION_ZOOM_BACK, this, "",
329            // Set the mouse tool to "Info"                                  new ImageIcon(MapView.class
330            mapPane.setWindowSelectionState(JMapPane.NONE);                                                  .getResource("resource/icons/zoom_back.png")),
331            mapPane.setState(JMapPane.SELECT_TOP); // Why not: JMapPane.SELECT_TOP_ONEONLY                                  R("MapPaneButtons.LastZoom.TT")), false);
332            mapPane.setHighlight(false);// SK: Was true, but since it not works properly removed it to save performance                  setButtonEnabled(ACTION_ZOOM_BACK, false);
333            mapPane.setNormalCursor(SwingUtil.CROSSHAIR_CURSOR);  
334            break;                  // Action button to redo the last zoom
335          case TOOL_SELECTION_SET:                  addAction(new MapPaneToolBarAction(ACTION_ZOOM_FORWARD, this, "",
336          case TOOL_SELECTION_ADD:                                  new ImageIcon(MapView.class
337          case TOOL_SELECTION_REMOVE:                                                  .getResource("resource/icons/zoom_forward.png")),
338                  // Set the mouse tool to "Select"                                  R("MapPaneButtons.NextZoom.TT")), false);
339                  mapPane.setWindowSelectionState(JMapPane.SELECT_TOP);                  setButtonEnabled(ACTION_ZOOM_FORWARD, false);
340                  mapPane.setState(JMapPane.SELECT_TOP);  
341                  mapPane.setHighlight(false);                  // set the selected tool enabled
342                  mapPane.setNormalCursor(SwingUtil.CROSSHAIR_CURSOR); // TODO Select Cursor                  setSelectedTool(selectedTool);
343                  break;  
344          case TOOL_ZOOMIN:          }
345            // Set the mouse tool to "Zoom in"  
346            mapPane.setWindowSelectionState(JMapPane.ZOOM_IN);          @Override
347            mapPane.setState(JMapPane.ZOOM_IN);          public void paint(Graphics g) {
348            mapPane.setHighlight(false);                  super.paint(g);
349            mapPane.setNormalCursor(SwingUtil.ZOOMIN_CURSOR);          }
350            break;  
351          case TOOL_ZOOMOUT:          /**
352            // Set the mouse tool to "Zoom out"           * Clears the GUI of all components and adds all tool and action buttons to
353            mapPane.setWindowSelectionState(JMapPane.NONE);           * the tool bar.
354            mapPane.setState(JMapPane.ZOOM_OUT);           */
355            mapPane.setHighlight(false);          public void initToolBar() {
356            mapPane.setNormalCursor(SwingUtil.ZOOMOUT_CURSOR);                  // setOpaque(true);
357            break;                  //              
358          default:                  // setAlignmentY(1f);
359            // Set map actions to default                  // setAlignmentX(0.5f);
360            mapPane.setWindowSelectionState(JMapPane.NONE);                  removeAll();
361            mapPane.setState(JMapPane.NONE);  
362            mapPane.setHighlight(false);                  // // Separator to the left of the tool actions to start
363            mapPane.setNormalCursor(null);                  // // the tool buttons with the map (not with the coordinate grid)
364            break;                  // Dimension dimension = new Dimension(49, 10);
365        }                  // addSeparator(dimension);
366        mapPane.updateCursor();  
367          }                  // Tool buttons
368                            for (Integer bKey : toolAndActionButtons.keySet()) {
369      /**  
370       * Performs the action of an action button.                          JComponent b = toolAndActionButtons.get(bKey);
371       * @param tool the action  
372       * @param e    the event of the button                          if (b instanceof JToggleButton) {
373       */                                  JToggleButton tb = (JToggleButton) b;
374          protected void performActionButton(int action, ActionEvent e) {                                  tb.setName(bKey.toString());
375        if ( mapPane == null )                                  tb.addActionListener(toolSelectedListener);
376          return;                          }
377    
378        // Perform the action "Zoom back": Revert the last zoom                          add(b);
379        if ( action == ACTION_ZOOM_BACK ) {                  }
380              if (zoomBackIndex <= 1)  
381            return;                  if (!toolAndActionButtons.containsKey(selectedTool)) {
382                              /**
383          zoomBackForwardButtonInAction = true;                           * This might be a bit specific, but IF selection buttons are
384          zoomBackIndex--;                           * available, select one of them.. if not, select the INFO tool.
385          getButton(ACTION_ZOOM_FORWARD).setEnabled(true);                           */
386          getButton(ACTION_ZOOM_BACK).setEnabled( zoomBackIndex > 1 );  
387                              if (toolAndActionButtons.containsKey(TOOL_SELECTION_SET)) {
388          mapPane.setMapArea( lastZooms.get(zoomBackIndex-1) );                                  setSelectedTool(TOOL_SELECTION_SET);
389          mapPane.refresh();                          } else if (toolAndActionButtons.containsKey(TOOL_INFO)) {
390        }                                  setSelectedTool(TOOL_INFO);
391                            } else {
392        // Perform the action "Zoom forward": Redo the last zoom                                  // TODO What to do now?!
393        if ( action == ACTION_ZOOM_FORWARD ) {                                  setSelectedTool(null);
394          if (zoomBackIndex < lastZooms.size()) {                          }
395            zoomBackForwardButtonInAction = true;  
396            zoomBackIndex++;                  }
397            getButton(ACTION_ZOOM_BACK).setEnabled(true);  
398            getButton(ACTION_ZOOM_FORWARD).setEnabled(zoomBackIndex < lastZooms.size());                  revalidate();
399                    repaint();
400            mapPane.setMapArea( lastZooms.get(zoomBackIndex-1) );          }
401            mapPane.refresh();  
402          }          // Space between tool buttons and action buttons
403        }          // SK: Seperators are now als manages like actions and tools
404          }          // Dimension dimension2 = new Dimension( 10,10);
405                    // this.addSeparator(dimension2);
406            
407          /**          // // Action buttons
408           * Adds a tool to the tool bar. Does nothing if a tool or action with the          // for (JButton b : actionButtons.values())
409           * specified ID already exists!          // add(b);
410           * @param buttonAction action for the toggle button          // }
411           * @param resetToolBar indicates whether the toolbar GUI is reset after adding  
412           *                     the button (if adding several actions it useful only to          /**
413           *                     reset the GUI for the last added tool)           * Performs the activation of a tool.
414           */           *
415          public void addTool(MapPaneToolBarAction buttonAction, boolean resetToolBar) {           * @param tool
416            if ( isButtonIDUsed(buttonAction.getID()) ) {           *            the tool to activate
417              LOGGER.warn("addTool(.) ignored because ID already used for tool or action: "+buttonAction.getID());           * @param e
418              return;           *            the event of the button
419            }           */
420            JToggleButton button = new JToggleButton(buttonAction);          public void performToolButton(int tool, ActionEvent e) {
421            button.setBorder( BorderFactory.createRaisedBevelBorder() );                  if (mapPane == null)
422            toolButtonGroup.add(button);                          return;
423            toolAndActionButtons.put(buttonAction.getID(), button);  
424            if ( resetToolBar )                  selectedTool = tool;
425              initToolBar();  
426          }                  switch (tool) {
427                    case TOOL_PAN:
428      /**                          // Set the mouse tool to "Panning"
429       * Adds a tool to the tool bar and resets the toolbar GUI.                          mapPane.setState(SelectableXMapPane.PAN);
430       * @param buttonAction action for the toggle button  //                      mapPane.setNormalCursor(SwingUtil.PAN_CURSOR);
431       */                          break;
432      public void addTool(MapPaneToolBarAction buttonAction) {                  case TOOL_INFO:
433        addTool(buttonAction, true);                          // Set the mouse tool to "Info"
434      }                          mapPane.setState(SelectableXMapPane.SELECT_ONE_FROM_TOP);
435    //                      mapPane.setNormalCursor(SwingUtil.CROSSHAIR_CURSOR);
436      /**                          break;
437       * Adds an action to the tool bar. Does nothing if a tool or action with the                  case TOOL_ZOOMIN:
438       * specified ID already exists!                          // Set the mouse tool to "Zoom in"
439       * @param buttonAction action for the button                          mapPane.setState(SelectableXMapPane.ZOOM_IN);
440       * @param resetToolBar indicates whether the toolbar GUI is reset after adding  //                      mapPane.setNormalCursor(SwingUtil.ZOOMIN_CURSOR);
441       *                     the button (if adding several actions it useful only to                          break;
442       *                     reset the GUI for the last added tool)                  case TOOL_ZOOMOUT:
443       */                          // Set the mouse tool to "Zoom out"
444      public void addAction(MapPaneToolBarAction buttonAction, boolean resetToolBar) {                          mapPane.setState(SelectableXMapPane.ZOOM_OUT);
445        if ( isButtonIDUsed(buttonAction.getID()) ) {  //                      mapPane.setNormalCursor(SwingUtil.ZOOMOUT_CURSOR);
446          LOGGER.warn("addAction(.) ignored because ID already used for tool or action: "+buttonAction.getID());                          break;
447          return;                  default:
448        }                          // Set map actions to default
449        JButton button = new JButton(buttonAction);                          mapPane.setState(SelectableXMapPane.NONE);
450        button.setBorder( BorderFactory.createRaisedBevelBorder() );  //                      mapPane.setNormalCursor(null);
451        toolAndActionButtons.put( buttonAction.getID(), button );                          break;
452        if ( resetToolBar )                  }
453          initToolBar();  //              mapPane.updateCursorAndRepaintTimer();
454      }          }
455        
456            /**
457      private void addSeparator(int id, Separator separator) {           * @param id
458          if ( isButtonIDUsed(id) ) {           *            The ID of the Component to remove. The change will not be
459              LOGGER.warn("addSeparator(.) ignored because ID already used for tool or action. ");           *            visible until {@link #initToolBar()} is called.
460              return;           * @return <code>null</code> or the component that has been removed.
461            }           */
462            toolAndActionButtons.put( id, separator);          public JComponent removeId(int id) {
463          }                  return toolAndActionButtons.remove(id);
464            }
465      /**  
466       * Adds an action to the tool bar and resets the toolbar GUI.          /**
467       * @param buttonAction action for the toggle button           * Performs the action of an action button.
468       */           *
469      public void addAction(MapPaneToolBarAction buttonAction) {           * @param tool
470        addAction(buttonAction, true);           *            the action
471      }           * @param e
472                 *            the event of the button
473      /**           */
474       * Returns the button for a specific tool or action.          protected void performActionButton(int action, ActionEvent e) {
475       * @param id the constant for any button in the {@link MapPaneToolBar}                  if (mapPane == null)
476       * @return a {@link JButton} if {@code id} specifies an {@linkplain #getActionButton(int) action button}                          return;
477       *         or {@link JToogleButton} if {@code id} specifies a {@linkplain #getToolButton(int) tool button}  
478       */                  // Perform the action "Zoom back": Revert the last zoom
479      public AbstractButton getButton(int id) {                  if (action == ACTION_ZOOM_BACK) {
480        AbstractButton button = (AbstractButton)toolAndActionButtons.get(id);                          if (zoomBackIndex <= 1)
481        if ( button == null )                                  return;
482          LOGGER.warn("Unknown tool or action ID: "+id);  
483        return button;                          zoomBackForwardButtonInAction = true;
484      }                          zoomBackIndex--;
485                            getButton(ACTION_ZOOM_FORWARD).setEnabled(true);
486      /**                          getButton(ACTION_ZOOM_BACK).setEnabled(zoomBackIndex > 1);
487       * Returns the button for a specific tool.  
488       * @param tool the constant for a tool                          mapPane.setMapArea(lastZooms.get(zoomBackIndex - 1));
489       */                          mapPane.refresh();
490          public JToggleButton getToolButton(int tool) {                  }
491        AbstractButton button = getButton(tool);  
492        if ( button != null && !(button instanceof JToggleButton) ) {                  // Perform the action "Zoom forward": Re-do the last zoom
493          LOGGER.warn("ID specifies no tool: "+tool);                  if (action == ACTION_ZOOM_FORWARD) {
494          button = null;                          if (zoomBackIndex < lastZooms.size()) {
495        }                                  zoomBackForwardButtonInAction = true;
496        return (JToggleButton)button;                                  zoomBackIndex++;
497      }                                  getButton(ACTION_ZOOM_BACK).setEnabled(true);
498                                    getButton(ACTION_ZOOM_FORWARD).setEnabled(
499      /**                                                  zoomBackIndex < lastZooms.size());
500       * Returns the button for a specific action.  
501       * @param action the constant an action                                  mapPane.setMapArea(lastZooms.get(zoomBackIndex - 1));
502       */                                  mapPane.refresh();
503      public JButton getActionButton(int action) {                          }
504        AbstractButton button = getButton(action);                  }
505        if ( button != null && !(button instanceof JButton) ) {          }
506          LOGGER.warn("ID specifies no action: "+action);  
507          button = null;          /**
508        }           * Adds a tool to the tool bar. Does nothing if a tool or action with the
509        return (JButton)button;           * specified ID already exists!
510             *
511      }           * @param buttonAction
512             *            action for the toggle button
513          /**           * @param resetToolBar
514           * Sets the selected tool.           *            indicates whether the toolbar GUI is reset after adding the
515           * @param tool ID of the tool           *            button (if adding several actions it useful only to reset the
516           */           *            GUI for the last added tool)
517          public void setSelectedTool(Integer tool) {           */
518            if ( tool == null )          public void addTool(MapPaneToolBarAction buttonAction, boolean resetToolBar) {
519              toolButtonGroup.setUnselected();                  if (isButtonIDUsed(buttonAction.getID())) {
520                                      LOGGER
521            JToggleButton button = getToolButton(tool);                                          .warn("addTool(.) ignored because ID already used for tool or action: "
522            if ( button == null )                                                          + buttonAction.getID());
523              return;                          return;
524            button.setSelected( true );                  }
525            button.getAction().actionPerformed(null);                  JToggleButton button = new SmallToggleButton(buttonAction);
526          }                  
527            //              button.setBorder(BorderFactory.createRaisedBevelBorder());
528          /**                  toolButtonGroup.add(button);
529           * Returns the selected tool.                  toolAndActionButtons.put(buttonAction.getID(), button);
530           * @return -1 if no tool is active                  if (resetToolBar)
531           */                          initToolBar();
532          public int getSelectedTool() {          }
533            if ( toolButtonGroup.getSelectedButton() == null )  
534              return -1;          /**
535            return selectedTool;           * Adds a tool to the tool bar and resets the toolbar GUI.
536          }           *
537                     * @param buttonAction
538      /**           *            action for the toggle button
539       * Sets whether a tool or action is activated or not. The visible property           */
540       * of the button is not affected.          public void addTool(MapPaneToolBarAction buttonAction) {
541       * @param id tool or actionID                  addTool(buttonAction, true);
542       * @param enabled if {@code true} the tool becomes available          }
543       */  
544      public void setButtonEnabled(int id, boolean enabled) {          /**
545        AbstractButton button = getButton(id);           * Adds an action to the tool bar. Does nothing if a tool or action with the
546        if ( button == null )           * specified ID already exists!
547          return;           *
548        button.setEnabled( enabled );           * @param buttonAction
549      }           *            action for the button
550             * @param resetToolBar
551      /**           *            indicates whether the toolbar GUI is reset after adding the
552       * Sets whether a tool or action is activated or not.           *            button (if adding several actions it useful only to reset the
553       * @param id tool or actionID           *            GUI for the last added tool)
554       * @param enabled if {@code true} the tool becomes available           */
555       * @param hideOnDisable if {@code true} the button is also hidden if          public void addAction(MapPaneToolBarAction buttonAction,
556       *                      {@code enabled} is {@code false}                          boolean resetToolBar) {
557       */                  if (isButtonIDUsed(buttonAction.getID())) {
558          public void setButtonEnabled(int id, boolean enabled, boolean hideOnDisable) {                          LOGGER
559            AbstractButton button = getButton(id);                                          .warn("addAction(.) ignored because ID already used for tool or action: "
560            if ( button == null )                                                          + buttonAction.getID());
561              return;                          return;
562            button.setEnabled( enabled );                  }
563            // if button is enabled, it becomes visible anyway                  JButton button = new SmallButton(buttonAction);
564            // if button is disabled and the "hide" option is set, it is also hidden  //              button.setBorder(BorderFactory.createRaisedBevelBorder());
565            if ( enabled )                  toolAndActionButtons.put(buttonAction.getID(), button);
566              button.setVisible( true );                  if (resetToolBar)
567            else                          initToolBar();
568              button.setVisible( !hideOnDisable );          }
569          }  
570            /**
571      /**           * Adds any JComponent to the tool bar. Does nothing if a tool or action
572       * Checks whether a ID is already used for a tool or action.           * with the specified ID already exists!
573       * @param tool tool ID           *
574       */           * @param component
575      public boolean isButtonIDUsed(int id) {           *            A {@link JComponent} that shall be added
576        return toolAndActionButtons.get(id) != null;           * @param id
577      }           *            The ID associaded with the {@link JComponent}
578             * @param resetToolBar
579      /**           *            indicates whether the toolbar GUI is reset after adding the
580       * Checks whether a tool is activated.           *            button (if adding several actions it useful only to reset the
581       * @param tool tool ID           *            GUI for the last added tool)
582       * @return {@code false} if an unknown ID is specified           */
583       */          public void addJComponent(JComponent component, int id, boolean resetToolBar) {
584      public boolean isButtonEnabled(int id) {  
585        AbstractButton button = getButton(id);                  if (isButtonIDUsed(id)) {
586        if ( button != null )                          LOGGER
587          return button.isEnabled();                                          .warn("addAction(.) ignored because ID already used for tool or action: "
588        return false;                                                          + id);
589      }                          return;
590                    }
591      /**  
592       * Sets the activation for all tools.                  toolAndActionButtons.put(id, component);
593       * @param enabled if {@code true} all tools becomes available                  if (resetToolBar)
594       * @param hideOnDisable if {@code true} the buttons are also hidden if                          initToolBar();
595       *                      {@code enabled} is {@code false}          }
596       */  
597      public void setAllToolsEnabled(boolean enabled, boolean hideOnDisable) {          public void addSeparator(int id, Separator separator) {
598        for (int tool : toolAndActionButtons.keySet())                  if (isButtonIDUsed(id)) {
599          setButtonEnabled(tool,enabled,hideOnDisable);                          LOGGER
600      }                                            .warn("addSeparator(.) ignored because ID already used for tool or action. ");
601                            return;
602      /**                  }
603       * Sets the activation for all actions.                  toolAndActionButtons.put(id, separator);
604       * @param enabled if {@code true} all actions becomes available          }
605       * @param hideOnDisable if {@code true} the buttons are also hidden if  
606       *                      {@code enabled} is {@code false}          /**
607       */           * Adds an action to the tool bar and resets the toolbar GUI.
608      public void setAllActionsEnabled(boolean enabled, boolean hideOnDisable) {           *
609        for (int id : toolAndActionButtons.keySet()){           * @param buttonAction
610            if (toolAndActionButtons.get(id) instanceof JButton){           *            action for the toggle button
611                    setButtonEnabled(id,enabled,hideOnDisable);           */
612            }          public void addAction(MapPaneToolBarAction buttonAction) {
613        }                  addAction(buttonAction, true);
614                    }
615      }    
616                /**
617      /**           * Returns the button for a specific tool or action.
618       * Returns the maximum ID of tools.           *
619       */           * @param id
620      public int getMaxToolID() {           *            the constant for any button in the {@link MapPaneToolBar}
621        return toolAndActionButtons.lastKey();           * @return a {@link JButton} if {@code id} specifies an
622      }           *         {@linkplain #getActionButton(int) action button} or
623             *         {@link JToogleButton} if {@code id} specifies a
624      /**           *         {@linkplain #getToolButton(int) tool button}
625       * Returns the minimum ID of tools.           */
626       */          public AbstractButton getButton(int id) {
627      public int getMinToolID() {                  AbstractButton button = (AbstractButton) toolAndActionButtons.get(id);
628        return toolAndActionButtons.firstKey();                  if (button == null)
629      }                          LOGGER.warn("Unknown tool or action ID: " + id);
630  //                  return button;
631  //    /**          }
632  //     * Returns the maximum ID of actions.  
633  //     */          /**
634  //    public int getMaxActionID() {           * Returns the button for a specific tool.
635  //      return actionButtons.lastKey();           *
636  //    }           * @param tool
637  //           *            the constant for a tool
638  //    /**           */
639  //     * Returns the minimum ID of actions.          public JToggleButton getToolButton(int tool) {
640  //     */                  AbstractButton button = getButton(tool);
641  //    public int getMinActionID() {                  if (button != null && !(button instanceof JToggleButton)) {
642  //      return actionButtons.firstKey();                          LOGGER.warn("ID specifies no tool: " + tool);
643  //    }                          button = null;
644                        }
645      /**                  return (JToggleButton) button;
646       * Extends the {@link AbstractAction} with maintaining an ID and          }
647       * the {@link MapPaneToolBar} the actions controls.  
648       * Additionally this class automatically calls {@link MapPaneToolBar#performToolButton(int, ActionEvent)}          /**
649       * or {@link MapPaneToolBar#performActionButton(int, ActionEvent)}           * Returns the button for a specific action.
650       * depending on whether the action is added via {@link MapPaneToolBar#addTool(MapPaneToolBarAction)}           *
651       * or {@link MapPaneToolBar#addAction(MapPaneToolBarAction)}.           * @param action
652       * @author <a href="mailto:[email protected]">Martin Schmitz</a> (University of Bonn/Germany)           *            the constant an action
653       */           */
654      public static class MapPaneToolBarAction extends AbstractAction {          public JButton getActionButton(int action) {
655        /** The ID of the action */                  AbstractButton button = getButton(action);
656        protected int id = -1;                  if (button != null && !(button instanceof JButton)) {
657        /** The tool bar, this action is made for. */                          LOGGER.warn("ID specifies no action: " + action);
658        protected MapPaneToolBar toolBar = null;                          button = null;
659                    }
660        /**                  return (JButton) button;
661         * Creates a new action with a dummy description and no icon.  
662         * @param id      unique ID for the action          }
663         * @param toolBar toolbar this action is made for  
664         */          /**
665        public MapPaneToolBarAction(int id, MapPaneToolBar toolBar) {           * Sets the selected tool.
666          this(id,toolBar,""+id);           *
667        }           * @param tool
668             *            ID of the tool
669        /**           */
670         * Creates a new action without an icon.          public void setSelectedTool(Integer tool) {
671         * @param id      unique ID for the action                  if (tool == null)
672         * @param toolBar toolbar this action is made for                          toolButtonGroup.setUnselected();
673         * @param name    description used for buttons or menus  
674         */                  JToggleButton button = getToolButton(tool);
675        public MapPaneToolBarAction(int id, MapPaneToolBar toolBar, String name) {                  if (button == null)
676          this(id,toolBar,name,null);                          return;
677        }                  button.setSelected(true);
678                    button.getAction().actionPerformed(null);
679        /**  
680         * Creates a new action.                  selectedTool = tool;
681         * @param id      unique ID for the action          }
682         * @param toolBar toolbar this action is made for  
683         * @param name    description used for buttons or menus          /**
684         * @param icon    icon used for buttons or menus           * Returns the selected tool.
685         */           *
686        public MapPaneToolBarAction(int id, MapPaneToolBar toolBar, String name, Icon icon) {           * @return -1 if no tool is active
687          super(name,icon);           */
688          this.id      = id;          public int getSelectedTool() {
689          this.toolBar = toolBar;                  if (toolButtonGroup.getSelectedButton() == null)
690        }                          return -1;
691                          return selectedTool;
692        /**          }
693         * Calls {@link MapPaneToolBar#performToolButton(int, ActionEvent)}  
694         * or {@link MapPaneToolBar#performActionButton(int, ActionEvent)}          /**
695         * depending on whether the action is added to the toolbar via           * Sets whether a tool or action is activated or not. The visible property
696         * {@link MapPaneToolBar#addTool(MapPaneToolBarAction)}           * of the button is not affected.
697         * or {@link MapPaneToolBar#addAction(MapPaneToolBarAction)}.           *
698         */           * @param id
699        public void actionPerformed(ActionEvent e) {           *            tool or actionID
700          if ( toolBar.toolAndActionButtons.get(id) instanceof JToggleButton)           * @param enabled
701            toolBar.performToolButton(id, e);           *            if {@code true} the tool becomes available
702          else if ( toolBar.toolAndActionButtons.get(id) instanceof JButton )           */
703            toolBar.performActionButton(id, e);          public void setButtonEnabled(int id, boolean enabled) {
704        }                  AbstractButton button = getButton(id);
705                          if (button == null)
706        /**                          return;
707         * Returns the (unique) id of this action.                  button.setEnabled(enabled);
708         * @return          }
709         */  
710        public int getID() {          /**
711          return id;           * Sets whether a tool or action is activated or not.
712        }           *
713      }           * @param id
714  }           *            tool or actionID
715             * @param enabled
716             *            if {@code true} the tool becomes available
717             * @param hideOnDisable
718             *            if {@code true} the button is also hidden if {@code enabled}
719             *            is {@code false}
720             */
721            public void setButtonEnabled(int id, boolean enabled, boolean hideOnDisable) {
722                    AbstractButton button = getButton(id);
723                    if (button == null)
724                            return;
725                    button.setEnabled(enabled);
726                    // if button is enabled, it becomes visible anyway
727                    // if button is disabled and the "hide" option is set, it is also hidden
728                    if (enabled)
729                            button.setVisible(true);
730                    else
731                            button.setVisible(!hideOnDisable);
732            }
733    
734            /**
735             * Checks whether a ID is already used for a tool or action.
736             *
737             * @param tool
738             *            tool ID
739             */
740            public boolean isButtonIDUsed(int id) {
741                    return toolAndActionButtons.get(id) != null;
742            }
743    
744            /**
745             * Checks whether a tool is activated.
746             *
747             * @param tool
748             *            tool ID
749             * @return {@code false} if an unknown ID is specified
750             */
751            public boolean isButtonEnabled(int id) {
752                    AbstractButton button = getButton(id);
753                    if (button != null)
754                            return button.isEnabled();
755                    return false;
756            }
757    
758            /**
759             * Sets the activation for all tools.
760             *
761             * @param enabled
762             *            if {@code true} all tools becomes available
763             * @param hideOnDisable
764             *            if {@code true} the buttons are also hidden if {@code enabled}
765             *            is {@code false}
766             */
767            public void setAllToolsEnabled(boolean enabled, boolean hideOnDisable) {
768                    for (int tool : toolAndActionButtons.keySet())
769                            setButtonEnabled(tool, enabled, hideOnDisable);
770            }
771    
772            /**
773             * Sets the activation for all actions.
774             *
775             * @param enabled
776             *            if {@code true} all actions becomes available
777             * @param hideOnDisable
778             *            if {@code true} the buttons are also hidden if {@code enabled}
779             *            is {@code false}
780             */
781            public void setAllActionsEnabled(boolean enabled, boolean hideOnDisable) {
782                    for (int id : toolAndActionButtons.keySet()) {
783                            if (toolAndActionButtons.get(id) instanceof JButton) {
784                                    setButtonEnabled(id, enabled, hideOnDisable);
785                            }
786                    }
787    
788            }
789    
790            /**
791             * Returns the maximum ID of tools.
792             */
793            public int getMaxToolID() {
794                    return toolAndActionButtons.lastKey();
795            }
796    
797            /**
798             * Returns the minimum ID of tools.
799             */
800            public int getMinToolID() {
801                    return toolAndActionButtons.firstKey();
802            }
803    
804            /**
805             * Extends the {@link AbstractAction} with maintaining an ID and the
806             * {@link MapPaneToolBar} the actions controls. Additionally this class
807             * automatically calls
808             * {@link MapPaneToolBar#performToolButton(int, ActionEvent)} or
809             * {@link MapPaneToolBar#performActionButton(int, ActionEvent)} depending on
810             * whether the action is added via
811             * {@link MapPaneToolBar#addTool(MapPaneToolBarAction)} or
812             * {@link MapPaneToolBar#addAction(MapPaneToolBarAction)}.
813             *
814             * @author <a href="mailto:[email protected]">Martin Schmitz</a>
815             *         (University of Bonn/Germany)
816             */
817            public static class MapPaneToolBarAction extends AbstractAction {
818                    /** The ID of the action */
819                    protected int id = -1;
820                    /** The tool bar, this action is made for. */
821                    protected MapPaneToolBar toolBar = null;
822    
823                    /**
824                     * Creates a new action with a dummy description and no icon.
825                     *
826                     * @param id
827                     *            unique ID for the action
828                     * @param toolBar
829                     *            toolbar this action is made for
830                     */
831                    public MapPaneToolBarAction(int id, MapPaneToolBar toolBar) {
832                            this(id, toolBar, "" + id);
833                    }
834    
835                    /**
836                     * Creates a new action without an icon.
837                     *
838                     * @param id
839                     *            unique ID for the action
840                     * @param toolBar
841                     *            toolbar this action is made for
842                     * @param name
843                     *            description used for buttons or menus
844                     */
845                    public MapPaneToolBarAction(int id, MapPaneToolBar toolBar, String name) {
846                            this(id, toolBar, name, null);
847                    }
848    
849                    /**
850                     * Creates a new action.
851                     *
852                     * @param id
853                     *            unique ID for the action
854                     * @param toolBar
855                     *            toolbar this action is made for
856                     * @param name
857                     *            description used for buttons or menus
858                     * @param icon
859                     *            icon used for buttons or menus
860                     */
861                    public MapPaneToolBarAction(int id, MapPaneToolBar toolBar,
862                                    String name, Icon icon) {
863                            this(id, toolBar, name, icon, null);
864                    }
865    
866                    /**
867                     * Creates a new action.
868                     *
869                     * @param id
870                     *            unique ID for the action
871                     * @param toolBar
872                     *            The {@link MapPaneToolBar} this action is made for
873                     * @param name
874                     *            description used for buttons or menus
875                     * @param icon
876                     *            icon used for buttons or menus
877                     * @param toolTip
878                     *            Tooltip to use for the button or menu
879                     */
880                    public MapPaneToolBarAction(int id, MapPaneToolBar toolBar,
881                                    String name, Icon icon, String toolTip) {
882                            super(name, icon);
883    
884                            if (toolTip != null && !toolTip.trim().isEmpty()) {
885                                    putValue(Action.SHORT_DESCRIPTION, toolTip);
886                            }
887    
888                            this.id = id;
889                            this.toolBar = toolBar;
890                    }
891    
892                    /**
893                     * Calls {@link MapPaneToolBar#performToolButton(int, ActionEvent)} or
894                     * {@link MapPaneToolBar#performActionButton(int, ActionEvent)}
895                     * depending on whether the action is added to the toolbar via
896                     * {@link MapPaneToolBar#addTool(MapPaneToolBarAction)} or
897                     * {@link MapPaneToolBar#addAction(MapPaneToolBarAction)}.
898                     */
899                    public void actionPerformed(ActionEvent e) {
900                            if (toolBar.toolAndActionButtons.get(id) instanceof JToggleButton)
901                                    toolBar.performToolButton(id, e);
902                            else if (toolBar.toolAndActionButtons.get(id) instanceof JButton)
903                                    toolBar.performActionButton(id, e);
904                    }
905    
906                    /**
907                     * Returns the (unique) id of this action.
908                     *
909                     * @return
910                     */
911                    public int getID() {
912                            return id;
913                    }
914            }
915    
916            /**
917             * Nuetzlich wenn die Componente gedruckt (z.B. wenn ein Screenshot gemacht
918             * wird) wird. Dann werden wird der Hintergrund auf WEISS gesetzt.
919             *
920             * @author <a href="mailto:[email protected]">Stefan Alfons
921             *         Kr&uuml;ger</a>
922             */
923            @Override
924            public void print(Graphics g) {
925                    Color orig = getBackground();
926                    setBackground(Color.WHITE);
927                    // wrap in try/finally so that we always restore the state
928                    try {
929                            super.print(g);
930                    } finally {
931                            setBackground(orig);
932                    }
933            }
934    
935    }

Legend:
Removed from v.111  
changed lines
  Added in v.604

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26