Package jmri.jmrit.display.palette

Class FamilyItemPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

jmri.jmrit.display.palette.ItemPanel

jmri.jmrit.display.palette.FamilyItemPanel

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible

Direct Known Subclasses:

IndicatorItemPanel, PortalItemPanel, RPSItemPanel, TableItemPanel

public abstract class FamilyItemPanel
extends ItemPanel

ItemPanel general implementation for placement of CPE items having sets of icons (families). The "family" is the set of icons that represent the various states and/or status of the item.

See Also:

• palette class diagram
• Serialized Form

Nested Class Summary

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

JPanel.AccessibleJPanel

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	_cntlDown
protected IconDialog	_dialog
protected ImagePanel	_dragIconPanel
protected String	_family
protected ButtonGroup	_familyButtonGroup
protected JPanel	_familyButtonPanel
protected boolean	_isUnstoredMap
protected JButton	_showIconsButton
protected HashMap<String,NamedIcon>	_unstoredMap
protected JButton	_updateButton
(package private) Action	pressed
(package private) Action	released

Fields inherited from class jmri.jmrit.display.palette.ItemPanel

_askOnce, _bottomPanel, _currentIconMap, _doneAction, _frame, _iconFamilyPanel, _iconPanel, _initialized, _instructions, _itemType, _linkName, _previewPanel, _suppressDragging, _update, _wasEmpty, INDICATOR_TRACK, LIGHT, MULTISENSOR, NAME_MAP, PORTAL, RPSREPORTER, SENSOR, SIGNALHEAD, STATE_MAP, TURNOUT

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

Constructor	Description
FamilyItemPanel(DisplayFrame parentFrame, String type, String family)	Constructor types with multiple families and multiple icon families.

Method Summary

Modifier and Type	Method	Description
protected void	addCreateDeleteFamilyButtons(JPanel panel)
protected void	addFamilyPanels(boolean hasMaps)
void	closeDialogs()
protected void	deleteFamilySet()	Action item for deletion of an icon family.
protected void	dialogDoneAction(String family, HashMap<String,NamedIcon> iconMap)	IconDialog calls this method to make any changes 'permanent'.
void	dispose()
protected String	findFamilyOfMap(String exemptFamily, HashMap<String,NamedIcon> newMap, HashMap<String,HashMap<String,NamedIcon>> families)	Find the family name of the map in a families HashMap.
JPanel	getBottomPanel()	Needed by CPE ConvertDialog.java
protected abstract String	getDisplayKey()	Get the key to display the icon to be used for dragging to the panel
protected JLabel	getDragger(DataFlavor flavor, HashMap<String,NamedIcon> map, NamedIcon icon)
String	getFamilyName()
HashMap<String,NamedIcon>	getIconMap()	Create icon set to panel icon display class.
JButton	getUpdateButton()
protected String	getValidFamilyName(String family, HashMap<String,NamedIcon> iconMap)	Check that family name proposed by user for an icon family 1. name is not a duplicate key 2. icon family is already stored.
protected void	hideIcons()
void	init()	Initialize panel for selecting a new Control Panel item or for updating an existing item.
void	init(ActionListener doneAction, HashMap<String,NamedIcon> iconMap)	Init for update of existing palette item type.
void	init(JPanel bottomPanel)	Initialization for conversion of plain track to indicator track by CircuitBuilder.
protected JPanel	instructions()
protected boolean	isUpdate()
protected void	makeDndIcon(HashMap<String,NamedIcon> iconMap)
protected void	makeDragIconPanel()	Position initial Preview component on _iconFamilyPanel.
protected void	makeFamiliesPanel()	Part of the initialization and reseting of an ItemPanel.
protected void	makeFamilyButtons(Set<String> keySet)	Make the _familyButtonPanel panel of buttons to select a family.
protected JPanel	makeIconDisplayPanel(String key, HashMap<String,NamedIcon> iconMap, boolean dropIcon)	Utility for above method.
protected JPanel	makeItemButtonPanel()	Make a button panel to populate editing an ItemPanel
protected JButton	makeShowIconsButton()
protected JPanel	makeSpecialBottomPanel(boolean update)	Replacement panel for _bottomPanel when no icon families exist for _itemType.
protected JButton	makeUpdateButton(ActionListener doneAction)	Add [Update] button to _bottomPanel.
protected boolean	namesStoredMap(String family)
protected void	openDialog(String type, String family)
protected void	previewColorChange()
protected void	setControlDown(boolean b)
protected void	setFamily()	Recover from cancelled Add Family dialog
protected void	setFamily(String family)	Action of family radio button.
protected void	setFamilyButton()
protected void	setFamilyMaps()
protected void	showIcons()
protected void	updateFamiliesPanel()

Methods inherited from class jmri.jmrit.display.palette.ItemPanel

addIconsToPanel, checkIconMap, initIconFamiliesPanel, itemGridBagConstraint, loadDefaultType, makeBottomPanel, makeNewIconMap, makePreviewPanel, mapsAreEqual, reSizeDisplay, shellDimension, wrapIconImage

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, getName, getParent, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Details

_family

protected String _family

_dragIconPanel

protected ImagePanel _dragIconPanel

_familyButtonPanel

protected JPanel _familyButtonPanel

_showIconsButton

protected JButton _showIconsButton

_updateButton

protected JButton _updateButton

_unstoredMap

protected HashMap<String,NamedIcon> _unstoredMap

_dialog

protected IconDialog _dialog

_familyButtonGroup

protected ButtonGroup _familyButtonGroup

_isUnstoredMap

protected boolean _isUnstoredMap

_cntlDown

protected boolean _cntlDown

pressed

Action pressed

released

Action released

Constructor Details

FamilyItemPanel

public FamilyItemPanel(DisplayFrame parentFrame,
 String type,
 String family)

Constructor types with multiple families and multiple icon families.

Parameters:

parentFrame - enclosing parentFrame

type - bean type

family - icon family

Method Details

init

public void init()

Description copied from class: ItemPanel

Initialize panel for selecting a new Control Panel item or for updating an existing item. Adds table if item is a bean. i.e. customizes for the item type. Called by enclosing TabbedPanel on change of displayed tab Pane.

Overrides:

init in class ItemPanel

init

public void init(ActionListener doneAction,
 HashMap<String,NamedIcon> iconMap)

Init for update of existing palette item type.

Parameters:

doneAction - doneAction

iconMap - iconMap

init

public void init(JPanel bottomPanel)

Initialization for conversion of plain track to indicator track by CircuitBuilder.

Parameters:

bottomPanel - button panel

getBottomPanel

public JPanel getBottomPanel()

Needed by CPE ConvertDialog.java

Returns:

JPanel

getUpdateButton

public JButton getUpdateButton()

makeUpdateButton

protected JButton makeUpdateButton(ActionListener doneAction)

Add [Update] button to _bottomPanel.

Overrides:

makeUpdateButton in class ItemPanel

Parameters:

doneAction - Action for button

Returns:

button with doneAction Action

makeItemButtonPanel

protected JPanel makeItemButtonPanel()

Description copied from class: ItemPanel

Make a button panel to populate editing an ItemPanel

Specified by:

makeItemButtonPanel in class ItemPanel

Returns:

the panel

makeShowIconsButton

protected JButton makeShowIconsButton()

makeSpecialBottomPanel

protected JPanel makeSpecialBottomPanel(boolean update)

Replacement panel for _bottomPanel when no icon families exist for _itemType.

Specified by:

makeSpecialBottomPanel in class ItemPanel

Parameters:

update - edit icons on a panel

Returns:

the panel

addCreateDeleteFamilyButtons

protected void addCreateDeleteFamilyButtons(JPanel panel)

getValidFamilyName

protected String getValidFamilyName(String family,
 HashMap<String,NamedIcon> iconMap)

Check that family name proposed by user for an icon family 1. name is not a duplicate key 2. icon family is already stored. (Sets "_isUnstoredMap" flag.)

Parameters:

family - name for icon set

iconMap - map the family name refers to.

Returns:

valid family name or null if user declines to provide a valid name.

findFamilyOfMap

protected String findFamilyOfMap(String exemptFamily,
 HashMap<String,NamedIcon> newMap,
 HashMap<String,HashMap<String,NamedIcon>> families)

Find the family name of the map in a families HashMap.

Parameters:

exemptFamily - exclude from matching

newMap - iconMap

families - families of itemType

Returns:

null if map is not in the family

namesStoredMap

protected boolean namesStoredMap(String family)

makeFamiliesPanel

protected void makeFamiliesPanel()

Description copied from class: ItemPanel

Part of the initialization and reseting of an ItemPanel. Allows divergence for different panel needs.

Specified by:

makeFamiliesPanel in class ItemPanel

instructions

protected JPanel instructions()

Specified by:

instructions in class ItemPanel

addFamilyPanels

protected void addFamilyPanels(boolean hasMaps)

updateFamiliesPanel

protected void updateFamiliesPanel()

makeFamilyButtons

protected void makeFamilyButtons(Set<String> keySet)

Make the _familyButtonPanel panel of buttons to select a family. Create and set actions of radioButtons to change family on pane.

Parameters:

keySet - of icon family names

makeDragIconPanel

protected void makeDragIconPanel()

Position initial Preview component on _iconFamilyPanel. If already present, keep and clear it.

makeIconDisplayPanel

protected JPanel makeIconDisplayPanel(String key,
 HashMap<String,NamedIcon> iconMap,
 boolean dropIcon)

Description copied from class: ItemPanel

Utility for above method. Implementation returns a JPanel extension containing a bordered JLabel extension of icon and labels

Specified by:

makeIconDisplayPanel in class ItemPanel

Parameters:

key - name of icon

iconMap - containing icon for possible replacement

dropIcon - JLabel extension may be replaceable or dragable.

Returns:

the JPanel

getDragger

protected JLabel getDragger(DataFlavor flavor,
 HashMap<String,NamedIcon> map,
 NamedIcon icon)

makeDndIcon

protected void makeDndIcon(HashMap<String,NamedIcon> iconMap)

getDisplayKey

protected abstract String getDisplayKey()

Get the key to display the icon to be used for dragging to the panel

Returns:

key for desired icon

hideIcons

protected void hideIcons()

Specified by:

hideIcons in class ItemPanel

showIcons

protected void showIcons()

deleteFamilySet

protected void deleteFamilySet()

Action item for deletion of an icon family.

setControlDown

protected void setControlDown(boolean b)

openDialog

protected void openDialog(String type,
 String family)

dialogDoneAction

protected void dialogDoneAction(String family,
 HashMap<String,NamedIcon> iconMap)

IconDialog calls this method to make any changes 'permanent'. It is responsible for testing that the changes are valid.

Parameters:

family - family name, possibly changed

iconMap - family map, possibly changed

isUpdate

protected boolean isUpdate()

closeDialogs

public void closeDialogs()

Overrides:

closeDialogs in class ItemPanel

dispose

public void dispose()

setFamily

protected void setFamily()

Recover from cancelled Add Family dialog

setFamily

protected void setFamily(String family)

Action of family radio button. MultiSensorItemPanel and IndicatorTOItemPanel must override.

Parameters:

family - icon family name

setFamilyMaps

protected void setFamilyMaps()

setFamilyButton

protected void setFamilyButton()

previewColorChange

protected void previewColorChange()

Overrides:

previewColorChange in class ItemPanel

getIconMap

public HashMap<String,NamedIcon> getIconMap()

Create icon set to panel icon display class.

Returns:

updated icon map

getFamilyName

public String getFamilyName()