Package jmri.jmrix.swing

Class ConnectionsPreferencesPanel

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JTabbedPane

jmri.jmrix.swing.ConnectionsPreferencesPanel

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants, JmriServiceProviderInterface, ManagingPreferencesPanel, PreferencesPanel

public class ConnectionsPreferencesPanel
extends JTabbedPane
implements ManagingPreferencesPanel

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	ConnectionsPreferencesPanel.StartupActionChoice	One choice for a Start Up action of a connection being deleted.

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

JTabbedPane.AccessibleJTabbedPane, JTabbedPane.ModelListener

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
(package private) ChangeListener	addTabListener

Fields inherited from class javax.swing.JTabbedPane

changeEvent, changeListener, model, SCROLL_TAB_LAYOUT, tabPlacement, WRAP_TAB_LAYOUT

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

Fields inherited from interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Constructor Summary

Constructors

Constructor	Description
ConnectionsPreferencesPanel()

Method Summary

Modifier and Type	Method	Description
(package private) void	addConnectionTab()
(package private) static void	applyStartupActionChoice(StartupActionsManager manager, AbstractActionModel model, ConnectionsPreferencesPanel.StartupActionChoice choice)	Carry out the choice made for a Start Up action of a connection being deleted.
(package private) boolean	confirmDelete(String prefix, String title)	Ask the user to confirm deleting a connection.
(package private) static List<ConnectionsPreferencesPanel.StartupActionChoice>	getChoices(StartupActionsManager manager, AbstractActionModel model, String prefix)	Get the choices for a Start Up action of a connection being deleted: remove (first, the default), keep, and a move to each other running connection that offers the action and does not already have it.
String	getLabelKey()	Text displayed above the preferences panel This label is only displayed if the preferences panel is in a tabbed set of preferences.
JComponent	getPreferencesComponent()	Get the preferences component for display
String	getPreferencesItem()	Get the Preferences Item identifier.
String	getPreferencesItemText()	Get the text for the Preferences Item in the preferences window list of preferences categories.
List<PreferencesPanel>	getPreferencesPanels()
String	getPreferencesTooltip()	The tooltip to display for a tabbed preferences panel
(package private) static String	getSystemPrefix(JmrixConfigPane configPane)	Get the system prefix of the connection in a pane.
String	getTabbedPreferencesTitle()	Get the title for the tab containing this preferences item.
boolean	isDirty()	Indicate that preferences need to be saved.
boolean	isPersistant()	Indicates that this PrefernecesPanel should be stored across application starts by the PreferencesManager This should be true if the implementing class relies on the ConfigureManager stores and retrieves the preferences managed by the implementing class on behalf of the implementing class.
boolean	isPreferencesValid()	Indicate that the preferences are valid.
boolean	isRestartRequired()	Indicate that the preferences will not take effect until restarted.
void	savePreferences()	Save any changes to preferences.

Methods inherited from class javax.swing.JTabbedPane

add, add, add, add, add, addChangeListener, addTab, addTab, addTab, createChangeListener, fireStateChanged, getAccessibleContext, getBackgroundAt, getBoundsAt, getChangeListeners, getComponentAt, getDisabledIconAt, getDisplayedMnemonicIndexAt, getForegroundAt, getIconAt, getMnemonicAt, getModel, getSelectedComponent, getSelectedIndex, getTabComponentAt, getTabCount, getTabLayoutPolicy, getTabPlacement, getTabRunCount, getTitleAt, getToolTipText, getToolTipTextAt, getUI, getUIClassID, indexAtLocation, indexOfComponent, indexOfTab, indexOfTab, indexOfTabComponent, insertTab, isEnabledAt, paramString, remove, remove, removeAll, removeChangeListener, removeTabAt, setBackgroundAt, setComponentAt, setDisabledIconAt, setDisplayedMnemonicIndexAt, setEnabledAt, setForegroundAt, setIconAt, setMnemonicAt, setModel, setSelectedComponent, setSelectedIndex, setTabComponentAt, setTabLayoutPolicy, setTabPlacement, setTitleAt, setToolTipTextAt, 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, 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

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, 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

Methods inherited from interface jmri.swing.PreferencesPanel

getIsEnabled, getSortOrder

Field Details

addTabListener

transient ChangeListener addTabListener

Constructor Details

ConnectionsPreferencesPanel

public ConnectionsPreferencesPanel()

Method Details

addConnectionTab

void addConnectionTab()

getSystemPrefix

@CheckForNull
static String getSystemPrefix(@CheckForNull
 JmrixConfigPane configPane)

Get the system prefix of the connection in a pane.

Parameters:

configPane - the connection pane

Returns:

the system prefix, or null if the pane has no connection

confirmDelete

boolean confirmDelete(@CheckForNull
 String prefix,
 String title)

Ask the user to confirm deleting a connection.

If the connection has Start Up actions, one dialog both confirms the delete and asks what to do with each action: remove it (the default), keep it, or move it to another connection that offers the same action and does not already have it. Otherwise the plain Yes/No question is asked. Nothing is changed unless the user confirms.

Parameters:

prefix - the system prefix of the connection being deleted; may be null if it has no connection

title - the name of the connection, for the dialog

Returns:

true to carry on deleting the connection, false if cancelled

getChoices

@Nonnull
static List<ConnectionsPreferencesPanel.StartupActionChoice> getChoices(@Nonnull
 StartupActionsManager manager,
 @Nonnull
 AbstractActionModel model,
 @CheckForNull
 String prefix)

Get the choices for a Start Up action of a connection being deleted: remove (first, the default), keep, and a move to each other running connection that offers the action and does not already have it.

Parameters:

manager - the Start Up actions manager

model - the action

prefix - the system prefix of the connection being deleted

Returns:

the choices, in the order shown

applyStartupActionChoice

static void applyStartupActionChoice(@Nonnull
 StartupActionsManager manager,
 @Nonnull
 AbstractActionModel model,
 @CheckForNull
 ConnectionsPreferencesPanel.StartupActionChoice choice)

Carry out the choice made for a Start Up action of a connection being deleted.

Parameters:

manager - the Start Up actions manager

model - the action

choice - what to do; null is treated as remove

getPreferencesItem

public String getPreferencesItem()

Description copied from interface: PreferencesPanel

Get the Preferences Item identifier. Multiple PreferencePanels can be displayed as tabs in a single item. Preferences items are listed in the menu on the left of the preferences window.

Specified by:

getPreferencesItem in interface PreferencesPanel

Returns:

the preferences item identifier.

getPreferencesItemText

public String getPreferencesItemText()

Description copied from interface: PreferencesPanel

Get the text for the Preferences Item in the preferences window list of preferences categories. Multiple PreferencePanels can be displayed as tabs in a single item. Preferences items are listed in the menu on the left of the preferences window.

Specified by:

getPreferencesItemText in interface PreferencesPanel

Returns:

the text for the preferences item.

getTabbedPreferencesTitle

public String getTabbedPreferencesTitle()

Description copied from interface: PreferencesPanel

Get the title for the tab containing this preferences item.

Specified by:

getTabbedPreferencesTitle in interface PreferencesPanel

Returns:

a tab title

getLabelKey

public String getLabelKey()

Description copied from interface: PreferencesPanel

Text displayed above the preferences panel This label is only displayed if the preferences panel is in a tabbed set of preferences. This label can contain multiple lines.

Specified by:

getLabelKey in interface PreferencesPanel

Returns:

label text

getPreferencesComponent

public JComponent getPreferencesComponent()

Description copied from interface: PreferencesPanel

Get the preferences component for display

Specified by:

getPreferencesComponent in interface PreferencesPanel

Returns:

the preferences panel

isPersistant

public boolean isPersistant()

Description copied from interface: PreferencesPanel

Indicates that this PrefernecesPanel should be stored across application starts by the PreferencesManager This should be true if the implementing class relies on the ConfigureManager stores and retrieves the preferences managed by the implementing class on behalf of the implementing class.

Specified by:

isPersistant in interface PreferencesPanel

Returns:

false if the implementing class stores its own preferences

getPreferencesTooltip

public String getPreferencesTooltip()

Description copied from interface: PreferencesPanel

The tooltip to display for a tabbed preferences panel

Specified by:

getPreferencesTooltip in interface PreferencesPanel

Returns:

tooltip text

savePreferences

public void savePreferences()

Description copied from interface: PreferencesPanel

Save any changes to preferences. This method is called for every instance of a PreferencesPanel that is loaded by TabbedPreferences if PreferencesPanel.isPersistant() is false.

Specified by:

savePreferences in interface PreferencesPanel

isDirty

public boolean isDirty()

Description copied from interface: PreferencesPanel

Indicate that preferences need to be saved.

Specified by:

isDirty in interface PreferencesPanel

Returns:

true if preferences need to be saved, false otherwise

isRestartRequired

public boolean isRestartRequired()

Description copied from interface: PreferencesPanel

Indicate that the preferences will not take effect until restarted.

Specified by:

isRestartRequired in interface PreferencesPanel

Returns:

true if the application needs to restart

isPreferencesValid

public boolean isPreferencesValid()

Description copied from interface: PreferencesPanel

Indicate that the preferences are valid.

Specified by:

isPreferencesValid in interface PreferencesPanel

Returns:

true if the preferences are valid, false otherwise

getPreferencesPanels

public List<PreferencesPanel> getPreferencesPanels()

Specified by:

getPreferencesPanels in interface ManagingPreferencesPanel