/[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 140 by alfonx, Sun Jun 14 17:24:44 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  
32   * two types of buttons. A group of <i>tools</i> for the mouse actions on the  import java.awt.Color;
33   * map represented by {@link JToggleButton JToggleButtons}, where only one tool  import java.awt.Graphics;
34   * can be activated every time. And some (general) <i>actions</i>, represented  import java.awt.event.ActionEvent;
35   * by normal {@link JButton JButtons}.  import java.awt.event.ActionListener;
36   *  import java.util.ArrayList;
37   * @author <a href="mailto:[email protected]">Martin Schmitz</a>  import java.util.HashSet;
38   *         (University of Bonn/Germany)  import java.util.Locale;
39   * @version 1.2 Stefan Krüger  import java.util.Set;
40   */  import java.util.SortedMap;
41  public class MapPaneToolBar extends JToolBar {  import java.util.TreeMap;
42          private static final Logger LOGGER = Logger.getLogger(MapPaneToolBar.class  
43                          .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.BorderFactory;
47          public static final int TOOL_INFO = 20;  import javax.swing.Icon;
48          public static final int SEPERATOR0 = 99;  import javax.swing.ImageIcon;
49    import javax.swing.JButton;
50          /** Constant for the tool "Zoom In" (110). */  import javax.swing.JComponent;
51          public static final int TOOL_ZOOMIN = 110;  import javax.swing.JToggleButton;
52          /** Constant for the tool "Zoom Out" (120). */  import javax.swing.JToolBar;
53          public static final int TOOL_ZOOMOUT = 120;  
54          /** Constant for the action "Zoom back" (130). */  import org.apache.log4j.Logger;
55          public static final int ACTION_ZOOM_BACK = 130;  
56          /** Constant for the action "Zoom forward" (140). */  import schmitzm.geotools.gui.JMapPane;
57          public static final int ACTION_ZOOM_FORWARD = 140;  import schmitzm.geotools.map.event.JMapPaneEvent;
58          public static final int SEPERATOR1 = 199;  import schmitzm.geotools.map.event.JMapPaneListener;
59    import schmitzm.geotools.map.event.MapAreaChangedEvent;
60          /**  import schmitzm.lang.LangUtil;
61           * Constant for the tool "Selection Reset" which clears the selection (240).  import schmitzm.lang.ResourceProvider;
62           */  import schmitzm.swing.ButtonGroup;
63          public static final int TOOL_SELECTION_CLEAR = 240;  import schmitzm.swing.SwingUtil;
64    
65          /**  import com.vividsolutions.jts.geom.Envelope;
66           * Constant for the tool "Select" which sets the Selection to the selected  
67           * features (210).  /**
68           */   * A toolbar to control an {@link JMapPane} (Atlas visualization). This contains
69          public static final int TOOL_SELECTION_SET = 210;   * two types of buttons. A group of <i>tools</i> for the mouse actions on the
70          /**   * map represented by {@link JToggleButton JToggleButtons}, where only one tool
71           * Constant for the tool "Selection add" which adds the features to the   * can be activated every time. And some (general) <i>actions</i>, represented
72           * Selection (220).   * by normal {@link JButton JButtons}.
73           */   *
74          public static final int TOOL_SELECTION_ADD = 220;   * @author <a href="mailto:[email protected]">Martin Schmitz</a>
75          /**   *         (University of Bonn/Germany)
76           * Constant for the tool "Selection subtract" which removes the selected   * @version 1.2 Stefan Krüger
77           * features from the selection (230).   */
78           */  public class MapPaneToolBar extends JToolBar {
79          public static final int TOOL_SELECTION_REMOVE = 230;          private static final Logger LOGGER = Logger.getLogger(MapPaneToolBar.class
80                            .getName());
81          /** Tool currently selected */  
82          protected int selectedTool = TOOL_ZOOMIN;          public static ResourceProvider RESOURCE = new ResourceProvider(LangUtil
83                            .extendPackagePath(MapPaneToolBar.class,
84          /** Holds the tool buttons of the tool bar. */                                          "resource.locales.mapPaneToolbar"), Locale.ENGLISH);
85          protected SortedMap<Integer, JComponent> toolAndActionButtons = null;  
86          /** Controls that only one tool button is activated. */          public static String R(String key, Object... values) {
87          protected ButtonGroup toolButtonGroup = null;                  return RESOURCE.getString(key, values);
88            }
89          // SK: Musste ich ändern damit man Tools und Actions in der Reihenfolge  
90          // mischen kann.          /** Constant for the tool "Panning" (10). */
91          // /** Holds the action buttons of the bar. */          public static final int TOOL_PAN = 10;
92          // protected SortedMap<Integer, JButton> actionButtons = null;          /** Constant for the tool "Info" (20). */
93            public static final int TOOL_INFO = 20;
94          /** Holds the {@link JMapPane} this tool bar controls. */          public static final int SEPERATOR0 = 99;
95          protected JMapPane mapPane = null;  
96            /** Constant for the tool "Zoom In" (110). */
97          /**          public static final int TOOL_ZOOMIN = 110;
98           * A List to remember the last Envelopes that have been watched. Used for          /** Constant for the tool "Zoom Out" (120). */
99           * the zoomBack- and zoomForwardButtons *          public static final int TOOL_ZOOMOUT = 120;
100           */          /** Constant for the action "Zoom back" (130). */
101          protected ArrayList<Envelope> lastZooms = new ArrayList<Envelope>();          public static final int ACTION_ZOOM_BACK = 130;
102          /** Holds the index to the current element in {@link #lastZooms}. */          /** Constant for the action "Zoom forward" (140). */
103          protected int zoomBackIndex = 0;          public static final int ACTION_ZOOM_FORWARD = 140;
104            public static final int SEPERATOR1 = 199;
105          /** Listener to sniff the zoom actions on the map. */  
106          protected JMapPaneListener mapPaneListener = null;          /**
107             * Constant for the tool "Selection Reset" which clears the selection (240).
108          protected boolean zoomBackForwardButtonInAction;           */
109            public static final int TOOL_SELECTION_CLEAR = 240;
110          /**  
111           * Creates a new toolbar. Notice: This toolbar does nothing until          /**
112           * {@link #setMapPane(JMapPane)} is called!           * Constant for the tool "Select" which sets the Selection to the selected
113           */           * features (210).
114          public MapPaneToolBar() {           */
115                  this(null);          public static final int TOOL_SELECTION_SET = 210;
116          }          /**
117             * Constant for the tool "Selection add" which adds the features to the
118          /**           * Selection (220).
119           * Creates a new tool bar.           */
120           *          public static final int TOOL_SELECTION_ADD = 220;
121           * @param mapPane          /**
122           *            {@link JMapPane} the tool bar controls           * Constant for the tool "Selection subtract" which removes the selected
123           */           * features from the selection (230).
124          public MapPaneToolBar(JMapPane mapPane) {           */
125                  super("Control the map", JToolBar.HORIZONTAL);          public static final int TOOL_SELECTION_REMOVE = 230;
126                  this.toolAndActionButtons = new TreeMap<Integer, JComponent>();  
127                  this.toolButtonGroup = new ButtonGroup();          public static final int ACTION_CHARTS = 401;
128                  // Create a Listener to sniff the zooms on the JMapPane  
129                  this.mapPaneListener = new JMapPaneListener() {          /** Tool currently selected */
130                          public void performMapPaneEvent(JMapPaneEvent e) {          protected int selectedTool = TOOL_ZOOMIN;
131                                  if (!(e instanceof MapAreaChangedEvent))  
132                                          return;          /** Holds the tool buttons of the tool bar. */
133            final protected SortedMap<Integer, JComponent> toolAndActionButtons = new TreeMap<Integer, JComponent>();
134                                  if (zoomBackForwardButtonInAction) {          /** Controls that only one tool button is activated. */
135                                          zoomBackForwardButtonInAction = false;          protected ButtonGroup toolButtonGroup = null;
136                                          return;  
137                                  }          // SK: Musste ich ändern damit man Tools und Actions in der Reihenfolge
138            // mischen kann.
139                                  Envelope oldMapArea = ((MapAreaChangedEvent) e).getOldMapArea();          // /** Holds the action buttons of the bar. */
140                                  if (lastZooms.size() == 0 && oldMapArea != null) {          // protected SortedMap<Integer, JButton> actionButtons = null;
141                                          lastZooms.add(oldMapArea);  
142                                          zoomBackIndex = 1;          /** Holds the {@link JMapPane} this tool bar controls. */
143                                  }          protected JMapPane mapPane = null;
144    
145                                  final Envelope mapArea = ((MapAreaChangedEvent) e)          /**
146                                                  .getNewMapArea();           * A List to remember the last Envelopes that have been watched. Used for
147                                  if (mapArea == null)           * the zoomBack- and zoomForwardButtons *
148                                          return;           */
149            protected ArrayList<Envelope> lastZooms = new ArrayList<Envelope>();
150                                  if (lastZooms.size() > 0          /** Holds the index to the current element in {@link #lastZooms}. */
151                                                  && mapArea.equals(lastZooms.get(lastZooms.size() - 1))) {          protected int zoomBackIndex = 0;
152                                          // LOGGER.debug("MapAreaChangedEvent ausgelassen bei der Zaehlung der Zoomschritt weil identisch");  
153                                          return;          /** Listener to sniff the zoom actions on the map. */
154                                  }          protected JMapPaneListener mapPaneListener = null;
155    
156                                  if (lastZooms.size() > 0)          protected boolean zoomBackForwardButtonInAction;
157                                          while (zoomBackIndex < lastZooms.size())  
158                                                  lastZooms.remove(lastZooms.size() - 1);          /** Listeners what want to be informed about a change of the selected tool **/
159            protected Set<MapPaneToolSelectedListener> toolSelectionListeners = new HashSet<MapPaneToolSelectedListener>();
160                                  lastZooms.add(mapArea);  
161                                  zoomBackIndex = lastZooms.size();          /** This listener is added to all {@link JToggleButton} **/
162                                  setButtonEnabled(ACTION_ZOOM_BACK, lastZooms.size() > 1);          private final ActionListener toolSelectedListener = new ActionListener() {
163                                  setButtonEnabled(ACTION_ZOOM_FORWARD, false);  
164                          }                  @Override
165                  };                  public void actionPerformed(ActionEvent e) {
166                            JToggleButton tb = (JToggleButton) e.getSource();
167                  setMapPane(mapPane);  
168                  setFloatable(false);                          // Inform the listeners about a newly selected tool
169                  setRollover(true);                          for (MapPaneToolSelectedListener l : toolSelectionListeners) {
170                                    l.toolSelected(Integer.valueOf(tb.getName()));
171                  init();                          }
172          }                  }
173    
174          /**          };
175           * Sets the {@link JMapPane} controlled by this tool bar.  
176           *          /**
177           * @param mapPane           * Creates a new toolbar. Notice: This toolbar does nothing until
178           *            {@link JMapPane} to control (if {@code null} this tool bar           * {@link #setMapPane(JMapPane)} is called!
179           *            controls NOTHING!)           */
180           */          public MapPaneToolBar() {
181          public void setMapPane(JMapPane mapPane) {                  this(null);
182                  // Remove listener from old MapPane          }
183                  if (this.mapPane != null)  
184                          this.mapPane.removeMapPaneListener(mapPaneListener);          public void addButtonSelectedListener(MapPaneToolSelectedListener listener) {
185                  this.mapPane = mapPane;                  toolSelectionListeners.add(listener);
186                  if (this.mapPane != null && mapPaneListener != null)          }
187                          this.mapPane.addMapPaneListener(mapPaneListener);  
188          }          public void removeButtonSelectedListener(
189                            MapPaneToolSelectedListener listener) {
190          /**                  toolSelectionListeners.remove(listener);
191           * Calls {@link #initToolsAndActions()} and {@link #initActions()} and then          }
192           * puts all tool buttons and all actions buttons to the tool bar.  
193           */          /**
194          protected void init() {           * Creates a new tool bar.
195                  initToolsAndActions();           *
196             * @param mapPane
197                  addSeparator(SEPERATOR0, new JToolBar.Separator());           *            {@link JMapPane} the tool bar controls
198                  addSeparator(SEPERATOR1, new JToolBar.Separator());           */
199            public MapPaneToolBar(JMapPane mapPane) {
200                  initToolBar();                  super("Control the map", JToolBar.HORIZONTAL);
201          }  
202                    // I want to see nothing on the background
203          /**                  setOpaque(false);
204           * Creates the tool buttons and action buttons and seperators, adds them to                  setBorder(null);
205           * {@link #toolAndActionButtons} and finally creates a button group for all  
206           * tools. So sub-classes which override this method should FIRST add their                  this.toolButtonGroup = new ButtonGroup();
207           * new tool buttons to {@link #toolAndActionButtons} before calling {@code  
208           * super.initTools()}.                  // Create a Listener to listen to the zooms on the JMapPane
209           */                  this.mapPaneListener = new JMapPaneListener() {
210          protected void initToolsAndActions() {                          public void performMapPaneEvent(JMapPaneEvent e) {
211                  // Panning                                  if (!(e instanceof MapAreaChangedEvent))
212                  addTool(new MapPaneToolBarAction(TOOL_PAN, this, "", new ImageIcon(                                          return;
213                                  MapView.class.getResource("resource/icons/pan.png"))), false);  
214                  // Info                                  if (zoomBackForwardButtonInAction) {
215                  addTool(new MapPaneToolBarAction(TOOL_INFO, this, "", new ImageIcon(                                          zoomBackForwardButtonInAction = false;
216                                  MapView.class.getResource("resource/icons/info.png"))), false);                                          return;
217                                    }
218                  // Zoom in  
219                  addTool(new MapPaneToolBarAction(TOOL_ZOOMIN, this, "", new ImageIcon(                                  final MapAreaChangedEvent mapAreaChangedEvent = (MapAreaChangedEvent) e;
220                                  MapView.class.getResource("resource/icons/zoom_in.png"))),                                  Envelope oldMapArea = mapAreaChangedEvent.getOldMapArea();
221                                  false);  
222                  // Zoom out                                  final Envelope mapArea = mapAreaChangedEvent.getNewMapArea();
223                  addTool(new MapPaneToolBarAction(TOOL_ZOOMOUT, this, "", new ImageIcon(                                  if (mapArea == null || mapArea.equals(oldMapArea)
224                                  MapView.class.getResource("resource/icons/zoom_out.png"))),                                                  || Double.isNaN(mapArea.getMinX())
225                                  false);                                                  || Double.isNaN(mapArea.getMaxX())
226                                                    || Double.isNaN(mapArea.getMinY())
227                  // Action button to revert the last zoom                                                  || Double.isNaN(mapArea.getMaxY())) {
228                  addAction(new MapPaneToolBarAction(ACTION_ZOOM_BACK, this, "",                                          // If the MapArea didn't change... we don't want to register
229                                  new ImageIcon(MapView.class                                          // it as a zoom action.
230                                                  .getResource("resource/icons/zoom_back.png"))), false);                                          return;
231                  setButtonEnabled(ACTION_ZOOM_BACK, false);                                  }
232    
233                  // Action button to redo the last zoom                                  if (lastZooms.size() == 0
234                  addAction(new MapPaneToolBarAction(ACTION_ZOOM_FORWARD, this, "",                                                  && oldMapArea != null
235                                  new ImageIcon(MapView.class                                                  && !oldMapArea.isNull()
236                                                  .getResource("resource/icons/zoom_forward.png"))),                                                  && !(Double.isNaN(oldMapArea.getMinX())
237                                  false);                                                                  || Double.isNaN(oldMapArea.getMaxX())
238                  setButtonEnabled(ACTION_ZOOM_FORWARD, false);                                                                  || Double.isNaN(oldMapArea.getMinY()) || Double
239                                                                    .isNaN(oldMapArea.getMaxY()))) {
240                  // set the selected tool enabled                                          lastZooms.add(oldMapArea);
241                  setSelectedTool(selectedTool);                                          zoomBackIndex = 1;
242                                    }
243          }                                  if (mapArea == null)
244                                            return;
245          /**  
246           * Clears the GUI of all components and adds all tool and action buttons to                                  if (lastZooms.size() > 0
247           * the tool bar.                                                  && mapArea.equals(lastZooms.get(lastZooms.size() - 1))) {
248           */                                          // LOGGER.debug("MapAreaChangedEvent ausgelassen bei der Zaehlung der Zoomschritt weil identisch");
249          protected void initToolBar() {                                          return;
250                  setAlignmentY(1f);                                  }
251                  removeAll();  
252                  // Separator to the left of the tool actions to start                                  if (lastZooms.size() > 0)
253                  // the tool buttons with the map (not with the coordinate grid)                                          while (zoomBackIndex < lastZooms.size())
254                  Dimension dimension = new Dimension(49, 10);                                                  lastZooms.remove(lastZooms.size() - 1);
255                  addSeparator(dimension);  
256                  // Tool buttons                                  lastZooms.add(mapArea);
257                  for (JComponent b : toolAndActionButtons.values())                                  zoomBackIndex = lastZooms.size();
258                          add(b);                                  setButtonEnabled(ACTION_ZOOM_BACK, lastZooms.size() > 1);
259          }                                  setButtonEnabled(ACTION_ZOOM_FORWARD, false);
260                            }
261          // Space between tool buttons and action buttons                  };
262          // SK: Seperators are now als manages like actions and tools  
263          // Dimension dimension2 = new Dimension( 10,10);                  setMapPane(mapPane);
264          // this.addSeparator(dimension2);                  setFloatable(false);
265                    setRollover(true);
266          // // Action buttons  
267          // for (JButton b : actionButtons.values())                  init();
268          // add(b);          }
269          // }  
270            /**
271          /**           * Sets the {@link JMapPane} controlled by this tool bar.
272           * Performs the activation of a tool.           *
273           *           * @param mapPane
274           * @param tool           *            {@link JMapPane} to control (if {@code null} this tool bar
275           *            the tool to activate           *            controls NOTHING!)
276           * @param e           */
277           *            the event of the button          public void setMapPane(JMapPane mapPane) {
278           */                  // Remove listener from old MapPane
279          public void performToolButton(int tool, ActionEvent e) {                  if (this.mapPane != null)
280                  if (mapPane == null)                          this.mapPane.removeMapPaneListener(mapPaneListener);
281                          return;                  this.mapPane = mapPane;
282                    if (this.mapPane != null && mapPaneListener != null)
283                  selectedTool = tool;                          this.mapPane.addMapPaneListener(mapPaneListener);
284            }
285                  switch (tool) {  
286                  case TOOL_PAN:          /**
287                          // Set the mouse tool to "Panning"           * Calls {@link #initToolsAndActions()} and {@link #initActions()} and then
288                          mapPane.setWindowSelectionState(JMapPane.NONE);           * puts all tool buttons and all actions buttons to the tool bar.
289                          mapPane.setState(JMapPane.PAN);           */
290                          mapPane.setHighlight(false);          protected void init() {
291                          mapPane.setNormalCursor(SwingUtil.PAN_CURSOR);  
292                          break;                  initToolsAndActions();
293                  case TOOL_INFO:  
294                          // Set the mouse tool to "Info"                  addSeparator(SEPERATOR0, new JToolBar.Separator());
295                          mapPane.setWindowSelectionState(JMapPane.NONE);                  addSeparator(SEPERATOR1, new JToolBar.Separator());
296                          mapPane.setState(JMapPane.SELECT_TOP); // Why not:  
297                                                                                                          // JMapPane.SELECT_TOP_ONEONLY                  initToolBar();
298                          mapPane.setHighlight(false);// SK: Was true, but since it not works          }
299                                                                                  // properly removed it to save  
300                                                                                  // performance          /**
301                          mapPane.setNormalCursor(SwingUtil.CROSSHAIR_CURSOR);           * Creates the tool buttons and action buttons and seperators, adds them to
302                          break;           * {@link #toolAndActionButtons} and finally creates a button group for all
303                  case TOOL_ZOOMIN:           * tools. So sub-classes which override this method should FIRST add their
304                          // Set the mouse tool to "Zoom in"           * new tool buttons to {@link #toolAndActionButtons} before calling {@code
305                          mapPane.setWindowSelectionState(JMapPane.ZOOM_IN);           * super.initTools()}.
306                          mapPane.setState(JMapPane.ZOOM_IN);           */
307                          mapPane.setHighlight(false);          protected void initToolsAndActions() {
308                          mapPane.setNormalCursor(SwingUtil.ZOOMIN_CURSOR);                  // Panning
309                          break;                  addTool(new MapPaneToolBarAction(TOOL_PAN, this, "", new ImageIcon(
310                  case TOOL_ZOOMOUT:                                  MapView.class.getResource("resource/icons/pan.png")),
311                          // Set the mouse tool to "Zoom out"                                  R("MapPaneButtons.Pan.TT")), false);
312                          mapPane.setWindowSelectionState(JMapPane.NONE);                  // Info
313                          mapPane.setState(JMapPane.ZOOM_OUT);                  addTool(new MapPaneToolBarAction(TOOL_INFO, this, "", new ImageIcon(
314                          mapPane.setHighlight(false);                                  MapView.class.getResource("resource/icons/info.png")),
315                          mapPane.setNormalCursor(SwingUtil.ZOOMOUT_CURSOR);                                  R("MapPaneButtons.Info.TT")), false);
316                          break;  
317  //              default:                  // Zoom in
318  //                      // Set map actions to default                  addTool(new MapPaneToolBarAction(TOOL_ZOOMIN, this, "", new ImageIcon(
319  //                      mapPane.setWindowSelectionState(JMapPane.NONE);                                  MapView.class.getResource("resource/icons/zoom_in.png")),
320  //                      mapPane.setState(JMapPane.NONE);                                  R("MapPaneButtons.ZoomIn.TT")), false);
321  //                      mapPane.setHighlight(false);                  // Zoom out
322  //                      mapPane.setNormalCursor(null);                  addTool(new MapPaneToolBarAction(TOOL_ZOOMOUT, this, "", new ImageIcon(
323  //                      break;                                  MapView.class.getResource("resource/icons/zoom_out.png")),
324                  }                                  R("MapPaneButtons.ZoomOut.TT")), false);
325                  mapPane.updateCursor();  
326          }                  // Action button to revert the last zoom
327                            addAction(new MapPaneToolBarAction(ACTION_ZOOM_BACK, this, "",
328          /**                                  new ImageIcon(MapView.class
329           * @param id The ID of the Component to remove                                                  .getResource("resource/icons/zoom_back.png")),
330           * @return <code>null</code> or the component that has been removed.                                  R("MapPaneButtons.LastZoom.TT")), false);
331           */                  setButtonEnabled(ACTION_ZOOM_BACK, false);
332          public JComponent removeId(int id){  
333                  return toolAndActionButtons.remove(id);                  // Action button to redo the last zoom
334          }                  addAction(new MapPaneToolBarAction(ACTION_ZOOM_FORWARD, this, "",
335                                    new ImageIcon(MapView.class
336          /**                                                  .getResource("resource/icons/zoom_forward.png")),
337           * Performs the action of an action button.                                  R("MapPaneButtons.NextZoom.TT")), false);
338           *                  setButtonEnabled(ACTION_ZOOM_FORWARD, false);
339           * @param tool  
340           *            the action                  // set the selected tool enabled
341           * @param e                  setSelectedTool(selectedTool);
342           *            the event of the button  
343           */          }
344          protected void performActionButton(int action, ActionEvent e) {  
345                  if (mapPane == null)          @Override
346                          return;          public void paint(Graphics g) {
347                    super.paint(g);
348                  // Perform the action "Zoom back": Revert the last zoom          }
349                  if (action == ACTION_ZOOM_BACK) {  
350                          if (zoomBackIndex <= 1)          /**
351                                  return;           * Clears the GUI of all components and adds all tool and action buttons to
352             * the tool bar.
353                          zoomBackForwardButtonInAction = true;           */
354                          zoomBackIndex--;          public void initToolBar() {
355                          getButton(ACTION_ZOOM_FORWARD).setEnabled(true);                  // setOpaque(true);
356                          getButton(ACTION_ZOOM_BACK).setEnabled(zoomBackIndex > 1);                  //              
357                    // setAlignmentY(1f);
358                          mapPane.setMapArea(lastZooms.get(zoomBackIndex - 1));                  // setAlignmentX(0.5f);
359                          mapPane.refresh();                  removeAll();
360                  }  
361                    // // Separator to the left of the tool actions to start
362                  // Perform the action "Zoom forward": Re-do the last zoom                  // // the tool buttons with the map (not with the coordinate grid)
363                  if (action == ACTION_ZOOM_FORWARD) {                  // Dimension dimension = new Dimension(49, 10);
364                          if (zoomBackIndex < lastZooms.size()) {                  // addSeparator(dimension);
365                                  zoomBackForwardButtonInAction = true;  
366                                  zoomBackIndex++;                  // Tool buttons
367                                  getButton(ACTION_ZOOM_BACK).setEnabled(true);                  for (Integer bKey : toolAndActionButtons.keySet()) {
368                                  getButton(ACTION_ZOOM_FORWARD).setEnabled(  
369                                                  zoomBackIndex < lastZooms.size());                          JComponent b = toolAndActionButtons.get(bKey);
370    
371                                  mapPane.setMapArea(lastZooms.get(zoomBackIndex - 1));                          if (b instanceof JToggleButton) {
372                                  mapPane.refresh();                                  JToggleButton tb = (JToggleButton) b;
373                          }                                  tb.setName(bKey.toString());
374                  }                                  tb.addActionListener(toolSelectedListener);
375                            }
376          }  
377                            add(b);
378          /**                  }
379           * Adds a tool to the tool bar. Does nothing if a tool or action with the  
380           * specified ID already exists!                  if (!toolAndActionButtons.containsKey(selectedTool)) {
381           *                          /**
382           * @param buttonAction                           * This might be a bit specific, but IF selection buttons are
383           *            action for the toggle button                           * available, select one of them.. if not, select the INFO tool.
384           * @param resetToolBar                           */
385           *            indicates whether the toolbar GUI is reset after adding the  
386           *            button (if adding several actions it useful only to reset the                          if (toolAndActionButtons.containsKey(TOOL_SELECTION_SET)) {
387           *            GUI for the last added tool)                                  setSelectedTool(TOOL_SELECTION_SET);
388           */                          } else if (toolAndActionButtons.containsKey(TOOL_INFO)) {
389          public void addTool(MapPaneToolBarAction buttonAction, boolean resetToolBar) {                                  setSelectedTool(TOOL_INFO);
390                  if (isButtonIDUsed(buttonAction.getID())) {                          } else {
391                          LOGGER                                  // TODO What to do now?!
392                                          .warn("addTool(.) ignored because ID already used for tool or action: "                                  setSelectedTool(null);
393                                                          + buttonAction.getID());                          }
394                          return;  
395                  }                  }
396                  JToggleButton button = new JToggleButton(buttonAction);  
397                  button.setBorder(BorderFactory.createRaisedBevelBorder());                  revalidate();
398                  toolButtonGroup.add(button);                  repaint();
399                  toolAndActionButtons.put(buttonAction.getID(), button);          }
400                  if (resetToolBar)  
401                          initToolBar();          // Space between tool buttons and action buttons
402          }          // SK: Seperators are now als manages like actions and tools
403            // Dimension dimension2 = new Dimension( 10,10);
404          /**          // this.addSeparator(dimension2);
405           * Adds a tool to the tool bar and resets the toolbar GUI.  
406           *          // // Action buttons
407           * @param buttonAction          // for (JButton b : actionButtons.values())
408           *            action for the toggle button          // add(b);
409           */          // }
410          public void addTool(MapPaneToolBarAction buttonAction) {  
411                  addTool(buttonAction, true);          /**
412          }           * Performs the activation of a tool.
413             *
414          /**           * @param tool
415           * Adds an action to the tool bar. Does nothing if a tool or action with the           *            the tool to activate
416           * specified ID already exists!           * @param e
417           *           *            the event of the button
418           * @param buttonAction           */
419           *            action for the button          public void performToolButton(int tool, ActionEvent e) {
420           * @param resetToolBar                  if (mapPane == null)
421           *            indicates whether the toolbar GUI is reset after adding the                          return;
422           *            button (if adding several actions it useful only to reset the  
423           *            GUI for the last added tool)                  selectedTool = tool;
424           */  
425          public void addAction(MapPaneToolBarAction buttonAction,                  switch (tool) {
426                          boolean resetToolBar) {                  case TOOL_PAN:
427                  if (isButtonIDUsed(buttonAction.getID())) {                          // Set the mouse tool to "Panning"
428                          LOGGER                          mapPane.setWindowSelectionState(JMapPane.NONE);
429                                          .warn("addAction(.) ignored because ID already used for tool or action: "                          mapPane.setState(JMapPane.PAN);
430                                                          + buttonAction.getID());                          mapPane.setNormalCursor(SwingUtil.PAN_CURSOR);
431                          return;                          break;
432                  }                  case TOOL_INFO:
433                  JButton button = new JButton(buttonAction);                          // Set the mouse tool to "Info"
434                  button.setBorder(BorderFactory.createRaisedBevelBorder());                          mapPane.setWindowSelectionState(JMapPane.NONE);
435                  toolAndActionButtons.put(buttonAction.getID(), button);                          mapPane.setState(JMapPane.SELECT_TOP); // Why not:
436                  if (resetToolBar)                          // JMapPane.SELECT_TOP_ONEONLY
437                          initToolBar();                          // properly removed it to save
438          }                          // performance
439                            mapPane.setNormalCursor(SwingUtil.CROSSHAIR_CURSOR);
440          public void addSeparator(int id, Separator separator) {                          break;
441                  if (isButtonIDUsed(id)) {                  case TOOL_ZOOMIN:
442                          LOGGER                          // Set the mouse tool to "Zoom in"
443                                          .warn("addSeparator(.) ignored because ID already used for tool or action. ");                          mapPane.setWindowSelectionState(JMapPane.ZOOM_IN);
444                          return;                          mapPane.setState(JMapPane.ZOOM_IN);
445                  }                          mapPane.setNormalCursor(SwingUtil.ZOOMIN_CURSOR);
446                  toolAndActionButtons.put(id, separator);                          break;
447          }                  case TOOL_ZOOMOUT:
448                            // Set the mouse tool to "Zoom out"
449          /**                          mapPane.setWindowSelectionState(JMapPane.NONE);
450           * Adds an action to the tool bar and resets the toolbar GUI.                          mapPane.setState(JMapPane.ZOOM_OUT);
451           *                          mapPane.setNormalCursor(SwingUtil.ZOOMOUT_CURSOR);
452           * @param buttonAction                          break;
453           *            action for the toggle button                  default:
454           */                          // Set map actions to default
455          public void addAction(MapPaneToolBarAction buttonAction) {                          mapPane.setWindowSelectionState(JMapPane.NONE);
456                  addAction(buttonAction, true);                          mapPane.setState(JMapPane.NONE);
457          }                          mapPane.setNormalCursor(null);
458                            break;
459          /**                  }
460           * Returns the button for a specific tool or action.                  mapPane.updateCursor();
461           *          }
462           * @param id  
463           *            the constant for any button in the {@link MapPaneToolBar}          /**
464           * @return a {@link JButton} if {@code id} specifies an           * @param id
465           *         {@linkplain #getActionButton(int) action button} or           *            The ID of the Component to remove. The change will not be
466           *         {@link JToogleButton} if {@code id} specifies a           *            visible until {@link #initToolBar()} is called.
467           *         {@linkplain #getToolButton(int) tool button}           * @return <code>null</code> or the component that has been removed.
468           */           */
469          public AbstractButton getButton(int id) {          public JComponent removeId(int id) {
470                  AbstractButton button = (AbstractButton) toolAndActionButtons.get(id);                  return toolAndActionButtons.remove(id);
471                  if (button == null)          }
472                          LOGGER.warn("Unknown tool or action ID: " + id);  
473                  return button;          /**
474          }           * Performs the action of an action button.
475             *
476          /**           * @param tool
477           * Returns the button for a specific tool.           *            the action
478           *           * @param e
479           * @param tool           *            the event of the button
480           *            the constant for a tool           */
481           */          protected void performActionButton(int action, ActionEvent e) {
482          public JToggleButton getToolButton(int tool) {                  if (mapPane == null)
483                  AbstractButton button = getButton(tool);                          return;
484                  if (button != null && !(button instanceof JToggleButton)) {  
485                          LOGGER.warn("ID specifies no tool: " + tool);                  // Perform the action "Zoom back": Revert the last zoom
486                          button = null;                  if (action == ACTION_ZOOM_BACK) {
487                  }                          if (zoomBackIndex <= 1)
488                  return (JToggleButton) button;                                  return;
489          }  
490                            zoomBackForwardButtonInAction = true;
491          /**                          zoomBackIndex--;
492           * Returns the button for a specific action.                          getButton(ACTION_ZOOM_FORWARD).setEnabled(true);
493           *                          getButton(ACTION_ZOOM_BACK).setEnabled(zoomBackIndex > 1);
494           * @param action  
495           *            the constant an action                          mapPane.setMapArea(lastZooms.get(zoomBackIndex - 1));
496           */                          mapPane.refresh();
497          public JButton getActionButton(int action) {                  }
498                  AbstractButton button = getButton(action);  
499                  if (button != null && !(button instanceof JButton)) {                  // Perform the action "Zoom forward": Re-do the last zoom
500                          LOGGER.warn("ID specifies no action: " + action);                  if (action == ACTION_ZOOM_FORWARD) {
501                          button = null;                          if (zoomBackIndex < lastZooms.size()) {
502                  }                                  zoomBackForwardButtonInAction = true;
503                  return (JButton) button;                                  zoomBackIndex++;
504                                    getButton(ACTION_ZOOM_BACK).setEnabled(true);
505          }                                  getButton(ACTION_ZOOM_FORWARD).setEnabled(
506                                                    zoomBackIndex < lastZooms.size());
507          /**  
508           * Sets the selected tool.                                  mapPane.setMapArea(lastZooms.get(zoomBackIndex - 1));
509           *                                  mapPane.refresh();
510           * @param tool                          }
511           *            ID of the tool                  }
512           */          }
513          public void setSelectedTool(Integer tool) {  
514                  if (tool == null)          /**
515                          toolButtonGroup.setUnselected();           * Adds a tool to the tool bar. Does nothing if a tool or action with the
516             * specified ID already exists!
517                  JToggleButton button = getToolButton(tool);           *
518                  if (button == null)           * @param buttonAction
519                          return;           *            action for the toggle button
520                  button.setSelected(true);           * @param resetToolBar
521                  button.getAction().actionPerformed(null);           *            indicates whether the toolbar GUI is reset after adding the
522          }           *            button (if adding several actions it useful only to reset the
523             *            GUI for the last added tool)
524          /**           */
525           * Returns the selected tool.          public void addTool(MapPaneToolBarAction buttonAction, boolean resetToolBar) {
526           *                  if (isButtonIDUsed(buttonAction.getID())) {
527           * @return -1 if no tool is active                          LOGGER
528           */                                          .warn("addTool(.) ignored because ID already used for tool or action: "
529          public int getSelectedTool() {                                                          + buttonAction.getID());
530                  if (toolButtonGroup.getSelectedButton() == null)                          return;
531                          return -1;                  }
532                  return selectedTool;                  JToggleButton button = new JToggleButton(buttonAction);
533          }                  button.setBorder(BorderFactory.createRaisedBevelBorder());
534                    toolButtonGroup.add(button);
535          /**                  toolAndActionButtons.put(buttonAction.getID(), button);
536           * Sets whether a tool or action is activated or not. The visible property                  if (resetToolBar)
537           * of the button is not affected.                          initToolBar();
538           *          }
539           * @param id  
540           *            tool or actionID          /**
541           * @param enabled           * Adds a tool to the tool bar and resets the toolbar GUI.
542           *            if {@code true} the tool becomes available           *
543           */           * @param buttonAction
544          public void setButtonEnabled(int id, boolean enabled) {           *            action for the toggle button
545                  AbstractButton button = getButton(id);           */
546                  if (button == null)          public void addTool(MapPaneToolBarAction buttonAction) {
547                          return;                  addTool(buttonAction, true);
548                  button.setEnabled(enabled);          }
549          }  
550            /**
551          /**           * Adds an action to the tool bar. Does nothing if a tool or action with the
552           * Sets whether a tool or action is activated or not.           * specified ID already exists!
553           *           *
554           * @param id           * @param buttonAction
555           *            tool or actionID           *            action for the button
556           * @param enabled           * @param resetToolBar
557           *            if {@code true} the tool becomes available           *            indicates whether the toolbar GUI is reset after adding the
558           * @param hideOnDisable           *            button (if adding several actions it useful only to reset the
559           *            if {@code true} the button is also hidden if {@code enabled}           *            GUI for the last added tool)
560           *            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           *           * Adds any JComponent to the tool bar. Does nothing if a tool or action
578           * @param tool           * with the specified ID already exists!
579           *            tool ID           *
580           */           * @param component
581          public boolean isButtonIDUsed(int id) {           *            A {@link JComponent} that shall be added
582                  return toolAndActionButtons.get(id) != null;           * @param id
583          }           *            The ID associaded with the {@link JComponent}
584             * @param resetToolBar
585          /**           *            indicates whether the toolbar GUI is reset after adding the
586           * Checks whether a tool is activated.           *            button (if adding several actions it useful only to reset the
587           *           *            GUI for the last added tool)
588           * @param tool           */
589           *            tool ID          public void addJComponent(JComponent component, int id, boolean resetToolBar) {
590           * @return {@code false} if an unknown ID is specified  
591           */                  if (isButtonIDUsed(id)) {
592          public boolean isButtonEnabled(int id) {                          LOGGER
593                  AbstractButton button = getButton(id);                                          .warn("addAction(.) ignored because ID already used for tool or action: "
594                  if (button != null)                                                          + id);
595                          return button.isEnabled();                          return;
596                  return false;                  }
597          }  
598                    toolAndActionButtons.put(id, component);
599          /**                  if (resetToolBar)
600           * Sets the activation for all tools.                          initToolBar();
601           *          }
602           * @param enabled  
603           *            if {@code true} all tools becomes available          public void addSeparator(int id, Separator separator) {
604           * @param hideOnDisable                  if (isButtonIDUsed(id)) {
605           *            if {@code true} the buttons are also hidden if {@code enabled}                          LOGGER
606           *            is {@code false}                                          .warn("addSeparator(.) ignored because ID already used for tool or action. ");
607           */                          return;
608          public void setAllToolsEnabled(boolean enabled, boolean hideOnDisable) {                  }
609                  for (int tool : toolAndActionButtons.keySet())                  toolAndActionButtons.put(id, separator);
610                          setButtonEnabled(tool, enabled, hideOnDisable);          }
611          }  
612            /**
613          /**           * Adds an action to the tool bar and resets the toolbar GUI.
614           * Sets the activation for all actions.           *
615           *           * @param buttonAction
616           * @param enabled           *            action for the toggle button
617           *            if {@code true} all actions becomes available           */
618           * @param hideOnDisable          public void addAction(MapPaneToolBarAction buttonAction) {
619           *            if {@code true} the buttons are also hidden if {@code enabled}                  addAction(buttonAction, true);
620           *            is {@code false}          }
621           */  
622          public void setAllActionsEnabled(boolean enabled, boolean hideOnDisable) {          /**
623                  for (int id : toolAndActionButtons.keySet()) {           * Returns the button for a specific tool or action.
624                          if (toolAndActionButtons.get(id) instanceof JButton) {           *
625                                  setButtonEnabled(id, enabled, hideOnDisable);           * @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          }           *         {@link JToogleButton} if {@code id} specifies a
630             *         {@linkplain #getToolButton(int) tool button}
631          /**           */
632           * Returns the maximum ID of tools.          public AbstractButton getButton(int id) {
633           */                  AbstractButton button = (AbstractButton) toolAndActionButtons.get(id);
634          public int getMaxToolID() {                  if (button == null)
635                  return toolAndActionButtons.lastKey();                          LOGGER.warn("Unknown tool or action ID: " + id);
636          }                  return button;
637            }
638          /**  
639           * Returns the minimum ID of tools.          /**
640           */           * Returns the button for a specific tool.
641          public int getMinToolID() {           *
642                  return toolAndActionButtons.firstKey();           * @param tool
643          }           *            the constant for a tool
644             */
645          /**          public JToggleButton getToolButton(int tool) {
646           * Extends the {@link AbstractAction} with maintaining an ID and the                  AbstractButton button = getButton(tool);
647           * {@link MapPaneToolBar} the actions controls. Additionally this class                  if (button != null && !(button instanceof JToggleButton)) {
648           * automatically calls                          LOGGER.warn("ID specifies no tool: " + tool);
649           * {@link MapPaneToolBar#performToolButton(int, ActionEvent)} or                          button = null;
650           * {@link MapPaneToolBar#performActionButton(int, ActionEvent)} depending on                  }
651           * whether the action is added via                  return (JToggleButton) button;
652           * {@link MapPaneToolBar#addTool(MapPaneToolBarAction)} or          }
653           * {@link MapPaneToolBar#addAction(MapPaneToolBarAction)}.  
654           *          /**
655           * @author <a href="mailto:[email protected]">Martin Schmitz</a>           * Returns the button for a specific action.
656           *         (University of Bonn/Germany)           *
657           */           * @param action
658          public static class MapPaneToolBarAction extends AbstractAction {           *            the constant an action
659                  /** The ID of the action */           */
660                  protected int id = -1;          public JButton getActionButton(int action) {
661                  /** The tool bar, this action is made for. */                  AbstractButton button = getButton(action);
662                  protected MapPaneToolBar toolBar = null;                  if (button != null && !(button instanceof JButton)) {
663                            LOGGER.warn("ID specifies no action: " + action);
664                  /**                          button = null;
665                   * Creates a new action with a dummy description and no icon.                  }
666                   *                  return (JButton) button;
667                   * @param id  
668                   *            unique ID for the action          }
669                   * @param toolBar  
670                   *            toolbar this action is made for          /**
671                   */           * Sets the selected tool.
672                  public MapPaneToolBarAction(int id, MapPaneToolBar toolBar) {           *
673                          this(id, toolBar, "" + id);           * @param tool
674                  }           *            ID of the tool
675             */
676                  /**          public void setSelectedTool(Integer tool) {
677                   * Creates a new action without an icon.                  if (tool == null)
678                   *                          toolButtonGroup.setUnselected();
679                   * @param id  
680                   *            unique ID for the action                  JToggleButton button = getToolButton(tool);
681                   * @param toolBar                  if (button == null)
682                   *            toolbar this action is made for                          return;
683                   * @param name                  button.setSelected(true);
684                   *            description used for buttons or menus                  button.getAction().actionPerformed(null);
685                   */  
686                  public MapPaneToolBarAction(int id, MapPaneToolBar toolBar, String name) {                  selectedTool = tool;
687                          this(id, toolBar, name, null);          }
688                  }  
689            /**
690                  /**           * Returns the selected tool.
691                   * Creates a new action.           *
692                   *           * @return -1 if no tool is active
693                   * @param id           */
694                   *            unique ID for the action          public int getSelectedTool() {
695                   * @param toolBar                  if (toolButtonGroup.getSelectedButton() == null)
696                   *            toolbar this action is made for                          return -1;
697                   * @param name                  return selectedTool;
698                   *            description used for buttons or menus          }
699                   * @param icon  
700                   *            icon used for buttons or menus          /**
701                   */           * Sets whether a tool or action is activated or not. The visible property
702                  public MapPaneToolBarAction(int id, MapPaneToolBar toolBar,           * of the button is not affected.
703                                  String name, Icon icon) {           *
704                          super(name, icon);           * @param id
705                          this.id = id;           *            tool or actionID
706                          this.toolBar = toolBar;           * @param enabled
707                  }           *            if {@code true} the tool becomes available
708             */
709                  /**          public void setButtonEnabled(int id, boolean enabled) {
710                   * Calls {@link MapPaneToolBar#performToolButton(int, ActionEvent)} or                  AbstractButton button = getButton(id);
711                   * {@link MapPaneToolBar#performActionButton(int, ActionEvent)}                  if (button == null)
712                   * depending on whether the action is added to the toolbar via                          return;
713                   * {@link MapPaneToolBar#addTool(MapPaneToolBarAction)} or                  button.setEnabled(enabled);
714                   * {@link MapPaneToolBar#addAction(MapPaneToolBarAction)}.          }
715                   */  
716                  public void actionPerformed(ActionEvent e) {          /**
717                          if (toolBar.toolAndActionButtons.get(id) instanceof JToggleButton)           * Sets whether a tool or action is activated or not.
718                                  toolBar.performToolButton(id, e);           *
719                          else if (toolBar.toolAndActionButtons.get(id) instanceof JButton)           * @param id
720                                  toolBar.performActionButton(id, e);           *            tool or actionID
721                  }           * @param enabled
722             *            if {@code true} the tool becomes available
723                  /**           * @param hideOnDisable
724                   * Returns the (unique) id of this action.           *            if {@code true} the button is also hidden if {@code enabled}
725                   *           *            is {@code false}
726                   * @return           */
727                   */          public void setButtonEnabled(int id, boolean enabled, boolean hideOnDisable) {
728                  public int getID() {                  AbstractButton button = getButton(id);
729                          return id;                  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.140  
changed lines
  Added in v.445

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26