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

Legend:
Removed from v.48  
changed lines
  Added in v.486

[email protected]
ViewVC Help
Powered by ViewVC 1.1.26