/*
* GeoTools - The Open Source Java GIS Toolkit
* http://geotools.org
*
* (C) 2002-2008, Open Source Geospatial Foundation (OSGeo)
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation;
* version 2.1 of the License.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*/
package org.geotools.swing;
import java.awt.BorderLayout;
import java.awt.Point;
import java.awt.Rectangle;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;
import java.util.ResourceBundle;
import javax.swing.BorderFactory;
import javax.swing.Icon;
import javax.swing.JButton;
import javax.swing.JOptionPane;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.event.ListDataEvent;
import javax.swing.event.ListDataListener;
import org.geotools.map.Layer;
import org.geotools.map.StyleLayer;
import org.geotools.styling.Style;
import org.geotools.swing.control.DnDList;
import org.geotools.swing.control.DnDListModel;
import org.geotools.swing.styling.JSimpleStyleDialog;
/**
* Displays a list of the map layers in an associated {@linkplain JMapPane} and
* provides controls to set the visibility, selection and style of each layer.
* <p>
* Implementation note: DefaultMapContext stores its list of MapLayer objects
* in rendering order, ie. the layer at index 0 is rendererd first, followed by
* index 1 etc. MapLayerTable stores its layers in the reverse order since it
* is more intuitive for the user to think of a layer being 'on top' of other
* layers.
*
* @author Michael Bedward
* @since 2.6
*
*
* @source $URL$
* @version $Id$
*/
public class MapLayerTable extends JPanel {
private static final long serialVersionUID = -8461593609237317561L;
private static final ResourceBundle stringRes = ResourceBundle.getBundle("org/geotools/swing/Text");
private JMapPane pane;
private DnDListModel<Layer> listModel;
private DnDList<Layer> list;
private JScrollPane scrollPane;
/* For detecting mouse double-clicks */
private static final long DOUBLE_CLICK_TIME = 500;
private long lastClickTime = 0;
/*
* Whether to prompt for confirmation before removing a layer.
* @todo introduce a setter or property for this
*/
private boolean confirmRemove = true;
/**
* Default constructor. A subsequent call to {@linkplain #setMapPane}
* will be required.
*/
public MapLayerTable() {
init();
}
/**
* Constructor.
* @param pane the map pane this MapLayerTable will service.
*/
public MapLayerTable(JMapPane pane) {
init();
doSetMapPane(pane);
}
/**
* Set the map pane that this MapLayerTable will service.
*
* @param pane the map pane
*/
public void setMapPane(JMapPane pane) {
doSetMapPane(pane);
}
/**
* Helper for {@link #setMapPane(JMapPane). This is just defined so that
* it can be called from the constructor without a warning from the compiler
* about calling a public overridable method.
*
* @param pane the map pane
*/
private void doSetMapPane(JMapPane pane) {
this.pane = pane;
pane.setMapLayerTable(this);
}
/**
* Add a new layer to those listed in the table. This method will be called
* by the associated map pane automatically as part of the event sequence
* when a new MapLayer is added to the pane's MapContext.
*
* @param layer the map layer
*/
public void onAddLayer(Layer layer) {
listModel.insertItem(0, layer);
}
/**
* Remove a layer from those listed in the table. This method will be called
* by the associated map pane automatically as part of the event sequence
* when a new MapLayer is removed from the pane's MapContext.
*
* @param layer the map layer
*/
void onRemoveLayer(Layer layer) {
listModel.removeItem(layer);
}
/**
* Repaint the list item associated with the specified MapLayer object
*
* @param layer the map layer
*/
public void repaint(Layer layer) {
int index = listModel.indexOf(layer);
list.repaint(list.getCellBounds(index, index));
}
/**
* Removes all items from the table. This is called by
* {@code JMapPane} or other clients and is not intended for
* general use.
*/
public void clear() {
listModel.clear();
}
/**
* Called by the constructor. This method lays out the components that
* make up the MapLayerTable and registers a mouse listener.
*/
private void init() {
listModel = new DnDListModel<Layer>();
list = new DnDList<Layer>(listModel) {
private static final long serialVersionUID = 1289744440656016412L;
/*
* We override setToolTipText to provide tool tips
* for the control labels displayed for each list item
*/
@Override
public String getToolTipText(MouseEvent e) {
int item = list.locationToIndex(e.getPoint());
if (item >= 0) {
Rectangle r = list.getCellBounds(item, item);
if (r.contains(e.getPoint())) {
Point p = new Point(e.getPoint().x, e.getPoint().y - r.y);
if (MapLayerTableCellRenderer.hitSelectionLabel(p)) {
return stringRes.getString("select_layer");
} else if (MapLayerTableCellRenderer.hitVisibilityLabel(p)) {
return stringRes.getString("show_layer");
} else if (MapLayerTableCellRenderer.hitStyleLabel(p)) {
return stringRes.getString("style_layer");
} else if (MapLayerTableCellRenderer.hitRemoveLabel(p)) {
return stringRes.getString("remove_layer");
} else if (MapLayerTableCellRenderer.hitNameLabel(p)) {
return stringRes.getString("rename_layer");
}
}
}
return null;
}
};
// Listen for drag-reordering of the list contents which
// will be received via the contentsChanged method
listModel.addListDataListener(new ListDataListener() {
public void intervalAdded(ListDataEvent e) {
}
public void intervalRemoved(ListDataEvent e) {
}
public void contentsChanged(ListDataEvent e) {
onReorderLayers(e);
}
});
list.setCellRenderer(new MapLayerTableCellRenderer());
list.setFixedCellHeight(MapLayerTableCellRenderer.getCellHeight());
list.addMouseListener(new MouseAdapter() {
@Override
public void mouseClicked(MouseEvent e) {
long clickTime = System.currentTimeMillis();
boolean doubleClick = clickTime - lastClickTime < DOUBLE_CLICK_TIME;
lastClickTime = clickTime;
onLayerItemClicked(e, doubleClick);
}
});
scrollPane = new JScrollPane(list,
JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED,
JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS);
scrollPane.setBorder(BorderFactory.createTitledBorder(stringRes.getString("layers_list_title")));
JPanel btnPanel = new JPanel();
Icon showIcon = MapLayerTableCellRenderer.LayerControlItem.VISIBLE.getIcon();
JButton showAllBtn = new JButton(showIcon);
showAllBtn.setToolTipText(stringRes.getString("show_all_layers"));
showAllBtn.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
onShowAllLayers();
}
});
btnPanel.add(showAllBtn);
Icon hideIcon = MapLayerTableCellRenderer.LayerControlItem.VISIBLE.getOffIcon();
JButton hideAllBtn = new JButton(hideIcon);
hideAllBtn.setToolTipText(stringRes.getString("hide_all_layers"));
hideAllBtn.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
onHideAllLayers();
}
});
btnPanel.add(hideAllBtn);
Icon onIcon = MapLayerTableCellRenderer.LayerControlItem.SELECTED.getIcon();
JButton selAllBtn = new JButton(onIcon);
selAllBtn.setToolTipText(stringRes.getString("select_all_layers"));
selAllBtn.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
onSelectAllLayers();
}
});
btnPanel.add(selAllBtn);
Icon offIcon = MapLayerTableCellRenderer.LayerControlItem.SELECTED.getOffIcon();
JButton unselAllBtn = new JButton(offIcon);
unselAllBtn.setToolTipText(stringRes.getString("unselect_all_layers"));
unselAllBtn.addActionListener(new ActionListener() {
public void actionPerformed(ActionEvent e) {
onUnselectAllLayers();
}
});
btnPanel.add(unselAllBtn);
setLayout(new BorderLayout());
add(scrollPane, BorderLayout.CENTER);
add(btnPanel, BorderLayout.SOUTH);
}
/**
* Handle a mouse click on a cell in the JList that displays
* layer names and states.
*
* @param ev the mouse event
* @param doubleClick true if this is the second click of a double-click; false otherwise
*/
private void onLayerItemClicked(MouseEvent ev, boolean doubleClick) {
int item = list.locationToIndex(ev.getPoint());
if (item >= 0) {
Rectangle r = list.getCellBounds(item, item);
if (r.contains(ev.getPoint())) {
Layer layer = listModel.getElementAt(item);
Point p = new Point(ev.getPoint().x, ev.getPoint().y - r.y);
if (MapLayerTableCellRenderer.hitSelectionLabel(p)) {
layer.setSelected(!layer.isSelected());
} else if (MapLayerTableCellRenderer.hitVisibilityLabel(p)) {
layer.setVisible(!layer.isVisible());
} else if (MapLayerTableCellRenderer.hitStyleLabel(p)) {
doSetStyle(layer);
} else if (MapLayerTableCellRenderer.hitRemoveLabel(p)) {
doRemoveLayer(layer);
} else if (MapLayerTableCellRenderer.hitNameLabel(p)) {
if (doubleClick) {
doSetLayerName(layer);
}
}
}
}
}
/**
* Show a style dialog to create a new Style for the layer
*
* @param layer the layer to be styled
*/
private void doSetStyle(Layer layer) {
if (layer instanceof StyleLayer) {
StyleLayer styleLayer = (StyleLayer) layer;
Style style = JSimpleStyleDialog.showDialog(this, styleLayer);
if (style != null) {
styleLayer.setStyle(style);
}
}
}
/**
* Prompt for a new title for the layer
*
* @param layer the layer to be renamed
*/
private void doSetLayerName(Layer layer) {
String name = JOptionPane.showInputDialog(stringRes.getString("new_layer_name_message"));
if (name != null && name.trim().length() > 0) {
layer.setTitle(name.trim());
}
}
/**
* Called when the user has clicked on the remove layer item.
*
* @param layer the layer to remove
*/
private void doRemoveLayer(Layer layer) {
if (confirmRemove) {
int confirm = JOptionPane.showConfirmDialog(null,
stringRes.getString("confirm_remove_layer_message"),
stringRes.getString("confirm_remove_layer_title"),
JOptionPane.YES_NO_OPTION);
if (confirm != JOptionPane.YES_OPTION) {
return;
}
}
pane.getMapContent().removeLayer(layer);
}
/**
* Handle a ListDataEvent signallying a drag-reordering of the map layers.
* The event is published by the list model after the layers have been
* reordered there.
*
* @param ev the event
*/
private void onReorderLayers(ListDataEvent ev) {
pane.setRepaint(false);
for (int pos = ev.getIndex0(); pos <= ev.getIndex1(); pos++) {
Layer layer = listModel.getElementAt(pos);
/*
* MapLayerTable stores layers in the reverse order to
* DefaultMapContext (see comment in javadocs for this class)
*/
int newContextPos = listModel.getSize() - pos - 1;
int curContextPos = pane.getMapContent().layers().indexOf(layer);
if (curContextPos != newContextPos) {
pane.getMapContent().moveLayer(curContextPos, newContextPos);
}
}
pane.setRepaint(true);
pane.repaint();
}
private void onShowAllLayers() {
if (pane != null && pane.getMapContent() != null) {
for (Layer layer : pane.getMapContent().layers()) {
if (!layer.isVisible()) {
layer.setVisible(true);
}
}
}
}
private void onHideAllLayers() {
if (pane != null && pane.getMapContent() != null) {
for (Layer layer : pane.getMapContent().layers()) {
if (layer.isVisible()) {
layer.setVisible(false);
}
}
}
}
private void onSelectAllLayers() {
if (pane != null && pane.getMapContent() != null) {
for (Layer layer : pane.getMapContent().layers()) {
if (!layer.isSelected()) {
layer.setSelected(true);
}
}
}
}
private void onUnselectAllLayers() {
if (pane != null && pane.getMapContent() != null) {
for (Layer layer : pane.getMapContent().layers()) {
if (layer.isSelected()) {
layer.setSelected(false);
}
}
}
}
}