org.openstreetmap.josm.gui.dialogs

Class LayerListDialog

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

org.openstreetmap.josm.gui.dialogs.ToggleDialog

org.openstreetmap.josm.gui.dialogs.LayerListDialog

All Implemented Interfaces:

java.awt.event.AWTEventListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, Preferences.PreferenceChangedListener, Helpful, ShowHideButtonListener, Destroyable

public class LayerListDialog
extends ToggleDialog

This is a toggle dialog which displays the list of layers. Actions allow to change the ordering of the layers, to hide/show layers, to activate layers, and to delete layers.

Support for multiple LayerListDialog is currently not complete but intended for the future.

Since:

17

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	LayerListDialog.ActiveLayerCellRenderer
private static class	LayerListDialog.ActiveLayerCheckBox
(package private) static class	LayerListDialog.LayerList This component displays a list of layers and provides the methods needed by LayerListDialog.LayerListModel.
static class	LayerListDialog.LayerListModel The layer list model.
static interface	LayerListDialog.LayerListModelListener Observer interface to be implemented by views using LayerListDialog.LayerListModel.
private static class	LayerListDialog.LayerNameCellEditor
private class	LayerListDialog.LayerNameCellRenderer
private static class	LayerListDialog.LayerVisibleCellEditor
private static class	LayerListDialog.LayerVisibleCellRenderer
private static class	LayerListDialog.LayerVisibleCheckBox
private static class	LayerListDialog.NativeScaleLayerCellRenderer
private static class	LayerListDialog.NativeScaleLayerCheckBox
(package private) class	LayerListDialog.PopupMenuHandler
private class	LayerListDialog.ToggleLayerIndexVisibility stores which layer index to toggle and executes the ShowHide action if the layer is present

Nested classes/interfaces inherited from class org.openstreetmap.josm.gui.dialogs.ToggleDialog

ToggleDialog.ButtonHidingType, ToggleDialog.TitleBar, ToggleDialog.ToggleDialogAction

Nested classes/interfaces inherited from class javax.swing.JPanel

javax.swing.JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
private ActivateLayerAction	activateLayerAction
private static LayerListDialog	instance the unique instance of the dialog
private LayerListDialog.LayerList	layerList the list of layers (technically its a JTable, but appears like a list)
private MainLayerManager	layerManager The MainLayerManager this list is for.
private LayerListDialog.LayerListModel	model the model for the layer list
private ShowHideLayerAction	showHideLayerAction
private LayerListDialog.ToggleLayerIndexVisibility[]	visibilityToggleActions
private Shortcut[]	visibilityToggleShortcuts

Fields inherited from class org.openstreetmap.josm.gui.dialogs.ToggleDialog

button, buttonHiding, detachedDialog, dialogsPanel, isCollapsed, isDocked, isShowing, name, preferenceClass, preferencePrefix, PROP_DYNAMIC_BUTTONS, titleBar, toggleAction, windowMenuItem

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Modifier	Constructor and Description
	LayerListDialog(MainLayerManager layerManager) Creates a layer list and attach it to the given mapView.
protected	LayerListDialog(MapFrame mapFrame) Creates a layer list and attach it to the given mapView.

Method Summary

Modifier and Type	Method and Description
protected void	adaptTo(IEnabledStateUpdating listener, LayerListDialog.LayerListModel listModel) Wires listener to listModel in such a way, that listener receives a IEnabledStateUpdating.updateEnabledState() on every ListDataEvent.
protected void	adaptTo(IEnabledStateUpdating listener, javax.swing.ListSelectionModel listSelectionModel) Wires listener to listSelectionModel in such a way, that listener receives a IEnabledStateUpdating.updateEnabledState() on every ListSelectionEvent.
ActivateLayerAction	createActivateLayerAction(Layer layer) Creates a ActivateLayerAction for layer in the context of this LayerListDialog.
DeleteLayerAction	createDeleteLayerAction() Creates a DeleteLayerAction in the context of this LayerListDialog.
DuplicateAction	createDuplicateLayerAction(Layer layer) Creates a DuplicateAction for layer in the context of this LayerListDialog.
static void	createInstance(MapFrame mapFrame) Creates the instance of the dialog.
MergeAction	createMergeLayerAction(Layer layer) Creates a MergeLayerAction for layer in the context of this LayerListDialog.
ShowHideLayerAction	createShowHideLayerAction() Creates a ShowHideLayerAction in the context of this LayerListDialog.
private void	createVisibilityToggleShortcuts() registers (shortcut to toggle right hand side toggle dialogs)+(number keys) shortcuts to toggle the visibility of the first ten layers.
void	destroy() Called when the object has been destroyed.
static LayerListDialog	getInstance() Replies the instance of the dialog
static Layer	getLayerForIndex(int index) Returns the layer at given index, or null.
static MultikeyShortcutAction.MultikeyInfo	getLayerInfo(Layer l) Returns info about layer.
static java.util.List<MultikeyShortcutAction.MultikeyInfo>	getLayerInfoByClass(java.lang.Class<?> layerClass) Returns a list of info on all layers of a given class.
MainLayerManager	getLayerManager() Gets the layer manager this dialog is for.
LayerListDialog.LayerListModel	getModel() Returns the layer list model.
void	hideNotify() Called when toggle dialog is hidden (collapsed, removed, MapFrame is removed, ...).
static boolean	isLayerValid(Layer l) Determines if a layer is valid (contained in global layer list).
void	showNotify() Called when toggle dialog is shown (after it was created or expanded).

Methods inherited from class org.openstreetmap.josm.gui.dialogs.ToggleDialog

buttonHidden, buttonShown, closeDetachedDialog, collapse, createLayout, createLayout, detach, dock, dockWhenClosingDetachedDlg, eventDispatched, expand, getButton, getDefaultDetachedSize, getName, getPreferencePrefix, getPreferredHeight, getToggleAction, helpTopic, hideDialog, isDialogInCollapsedView, isDialogInDefaultView, isDialogShowing, preferenceChanged, registerInWindowMenu, setButton, setContentVisible, setDialogsPanel, setIsButtonHiding, setIsCollapsed, setIsDocked, setIsShowing, setTitle, showDialog, stateChanged, toggleButtonHook, toString, unfurlDialog

Methods inherited from class javax.swing.JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

instance

private static volatile LayerListDialog instance

the unique instance of the dialog

model

private final LayerListDialog.LayerListModel model

the model for the layer list

layerList

private final LayerListDialog.LayerList layerList

the list of layers (technically its a JTable, but appears like a list)

activateLayerAction

private final ActivateLayerAction activateLayerAction

showHideLayerAction

private final ShowHideLayerAction showHideLayerAction

visibilityToggleShortcuts

private final transient Shortcut[] visibilityToggleShortcuts

visibilityToggleActions

private final LayerListDialog.ToggleLayerIndexVisibility[] visibilityToggleActions

layerManager

private final transient MainLayerManager layerManager

The MainLayerManager this list is for.

Constructor Detail

LayerListDialog

protected LayerListDialog(MapFrame mapFrame)

Creates a layer list and attach it to the given mapView.

Parameters:

mapFrame - map frame

LayerListDialog

public LayerListDialog(MainLayerManager layerManager)

Creates a layer list and attach it to the given mapView.

Parameters:

layerManager - The layer manager this list is for

Since:

10467

Method Detail

createInstance

public static void createInstance(MapFrame mapFrame)

Creates the instance of the dialog. It's connected to the map frame mapFrame

Parameters:

mapFrame - the map frame

getInstance

public static LayerListDialog getInstance()

Replies the instance of the dialog

Returns:

the instance of the dialog

Throws:

java.lang.IllegalStateException - if the dialog is not created yet

See Also:

createInstance(MapFrame)

createVisibilityToggleShortcuts

private void createVisibilityToggleShortcuts()

registers (shortcut to toggle right hand side toggle dialogs)+(number keys) shortcuts to toggle the visibility of the first ten layers.

getLayerManager

public MainLayerManager getLayerManager()

Gets the layer manager this dialog is for.

Returns:

The layer manager.

Since:

10288

showNotify

public void showNotify()

Description copied from class: ToggleDialog

Called when toggle dialog is shown (after it was created or expanded). Descendants may overwrite this method, it's a good place to register listeners needed to keep dialog updated

Overrides:

showNotify in class ToggleDialog

hideNotify

public void hideNotify()

Description copied from class: ToggleDialog

Called when toggle dialog is hidden (collapsed, removed, MapFrame is removed, ...). Good place to unregister listeners

Overrides:

hideNotify in class ToggleDialog

getModel

public LayerListDialog.LayerListModel getModel()

Returns the layer list model.

Returns:

the layer list model

adaptTo

protected void adaptTo(IEnabledStateUpdating listener,
                       javax.swing.ListSelectionModel listSelectionModel)

Wires listener to listSelectionModel in such a way, that listener receives a IEnabledStateUpdating.updateEnabledState() on every ListSelectionEvent.

Parameters:

listener - the listener

listSelectionModel - the source emitting ListSelectionEvents

adaptTo

protected void adaptTo(IEnabledStateUpdating listener,
                       LayerListDialog.LayerListModel listModel)

Wires listener to listModel in such a way, that listener receives a IEnabledStateUpdating.updateEnabledState() on every ListDataEvent.

Parameters:

listener - the listener

listModel - the source emitting ListDataEvents

destroy

public void destroy()

Description copied from interface: Destroyable

Called when the object has been destroyed.

Specified by:

destroy in interface Destroyable

Overrides:

destroy in class ToggleDialog

createShowHideLayerAction

public ShowHideLayerAction createShowHideLayerAction()

Creates a ShowHideLayerAction in the context of this LayerListDialog.

Returns:

the action

createDeleteLayerAction

public DeleteLayerAction createDeleteLayerAction()

Creates a DeleteLayerAction in the context of this LayerListDialog.

Returns:

the action

createActivateLayerAction

public ActivateLayerAction createActivateLayerAction(Layer layer)

Creates a ActivateLayerAction for layer in the context of this LayerListDialog.

Parameters:

layer - the layer

Returns:

the action

createMergeLayerAction

public MergeAction createMergeLayerAction(Layer layer)

Creates a MergeLayerAction for layer in the context of this LayerListDialog.

Parameters:

layer - the layer

Returns:

the action

createDuplicateLayerAction

public DuplicateAction createDuplicateLayerAction(Layer layer)

Creates a DuplicateAction for layer in the context of this LayerListDialog.

Parameters:

layer - the layer

Returns:

the action

getLayerForIndex

public static Layer getLayerForIndex(int index)

Returns the layer at given index, or null.

Parameters:

index - the index

Returns:

the layer at given index, or null if index out of range

getLayerInfoByClass

public static java.util.List<MultikeyShortcutAction.MultikeyInfo> getLayerInfoByClass(java.lang.Class<?> layerClass)

Returns a list of info on all layers of a given class.

Parameters:

layerClass - The layer class. This is not Class<? extends Layer> on purpose, to allow asking for layers implementing some interface

Returns:

list of info on all layers assignable from layerClass

isLayerValid

public static boolean isLayerValid(Layer l)

Determines if a layer is valid (contained in global layer list).

Parameters:

l - the layer

Returns:

true if layer l is contained in current layer list

getLayerInfo

public static MultikeyShortcutAction.MultikeyInfo getLayerInfo(Layer l)

Returns info about layer.

Parameters:

l - the layer

Returns:

info about layer l