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

Legend:
Removed from v.139  
changed lines
  Added in v.445

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26