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

Legend:
Removed from v.151  
changed lines
  Added in v.654

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26