Class Preferences
- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- java.awt.Window
-
- java.awt.Dialog
-
- javax.swing.JDialog
-
- ca.cgjennings.apps.arkham.dialog.prefs.Preferences
-
- All Implemented Interfaces:
AgnosticDialog
,java.awt.image.ImageObserver
,java.awt.MenuContainer
,java.io.Serializable
,javax.accessibility.Accessible
,javax.swing.RootPaneContainer
,javax.swing.WindowConstants
public class Preferences extends javax.swing.JDialog implements AgnosticDialog
The dialog that displays registered preference categories.- Author:
- Chris Jennings
- See Also:
- Serialized Form
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class javax.swing.JDialog
javax.swing.JDialog.AccessibleJDialog
-
Nested classes/interfaces inherited from class java.awt.Dialog
java.awt.Dialog.AccessibleAWTDialog, java.awt.Dialog.ModalExclusionType, java.awt.Dialog.ModalityType
-
Nested classes/interfaces inherited from class java.awt.Window
java.awt.Window.AccessibleAWTWindow, java.awt.Window.Type
-
-
Field Summary
-
Fields inherited from class javax.swing.JDialog
accessibleContext, rootPane, rootPaneCheckingEnabled
-
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
-
Constructor Summary
Constructors Constructor Description Preferences()
Creates new form Preferences
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description static void
addPreferenceUpdateListener(PreferenceUpdateListener li)
Adds a listener that will be updated when the user changes the application preferences.static void
firePreferenceUpdate()
Informs all registered listeners that the user has changed their preference settings.PreferenceCategory
getSelectedCategory()
Returns the currently selected category in this preferences dialog.void
handleCancelAction(java.awt.event.ActionEvent e)
Performs whatever action is required when the Cancel button is pressed.void
handleOKAction(java.awt.event.ActionEvent e)
Performs whatever action is required when the OK button is pressed.static void
registerCategory(PreferenceCategory cat)
static void
removePreferenceUpdateListener(PreferenceUpdateListener li)
Stops a listener from being updated when the user changes the application preferences.void
scrollToCategorySection(java.lang.String sectionTop, java.lang.String sectionBottom)
Scroll the currently displayed category to display a particular section.void
setSelectedCategory(PreferenceCategory pc)
Sets the selected category in this preferences dialog.void
setSelectedCategory(java.lang.String name)
Selects the a preference category by title.static void
unregisterCategory(PreferenceCategory cat)
-
Methods inherited from class javax.swing.JDialog
addImpl, createRootPane, dialogInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update
-
Methods inherited from class java.awt.Dialog
addNotify, getModalityType, getTitle, hide, isModal, isResizable, isUndecorated, setBackground, setModal, setModalityType, setOpacity, setResizable, setShape, setTitle, setUndecorated, setVisible, show, toBack
-
Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeNotify, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImage, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, toFront
-
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, 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, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
-
-
-
Method Detail
-
setSelectedCategory
public void setSelectedCategory(PreferenceCategory pc)
Sets the selected category in this preferences dialog.- Parameters:
pc
- the category to select
-
setSelectedCategory
public void setSelectedCategory(java.lang.String name)
Selects the a preference category by title. If no category matches the provided title, the selection will not change.- Parameters:
name
- the title of the category to select
-
getSelectedCategory
public PreferenceCategory getSelectedCategory()
Returns the currently selected category in this preferences dialog.- Returns:
- the selected preference category, or
null
if no category is selected
-
scrollToCategorySection
public void scrollToCategorySection(java.lang.String sectionTop, java.lang.String sectionBottom)
Scroll the currently displayed category to display a particular section. The desired section is identified by specifying the label text of labels at its top and bottom. If the top label isnull
, then the top of the category is used. If the bottom label isnull
, then the bottom of the category is used. If either label cannot be found in the category, it is treated asnull
(although a warning will be logged to the console). If the section is too long to fit within the category view without scrolling, the dialog will scroll to the top of the top section.- Parameters:
sectionTop
- label text identifying the top of the section, ornull
sectionBottom
- label text identifying the bottom of the section, ornull
-
handleOKAction
public void handleOKAction(java.awt.event.ActionEvent e)
Description copied from interface:AgnosticDialog
Performs whatever action is required when the OK button is pressed. Called when the (possibly swapped) OK button generates an ActionEvent.- Specified by:
handleOKAction
in interfaceAgnosticDialog
- Parameters:
e
- theActionEvent
generated by the button
-
handleCancelAction
public void handleCancelAction(java.awt.event.ActionEvent e)
Description copied from interface:AgnosticDialog
Performs whatever action is required when the Cancel button is pressed. Called when the (possibly swapped) OK button generates an ActionEvent.- Specified by:
handleCancelAction
in interfaceAgnosticDialog
- Parameters:
e
- theActionEvent
generated by the button
-
registerCategory
public static void registerCategory(PreferenceCategory cat)
-
unregisterCategory
public static void unregisterCategory(PreferenceCategory cat)
-
addPreferenceUpdateListener
public static void addPreferenceUpdateListener(PreferenceUpdateListener li)
Adds a listener that will be updated when the user changes the application preferences.- Parameters:
li
- the listener to remove
-
removePreferenceUpdateListener
public static void removePreferenceUpdateListener(PreferenceUpdateListener li)
Stops a listener from being updated when the user changes the application preferences.- Parameters:
li
- the listener to remove
-
firePreferenceUpdate
public static void firePreferenceUpdate()
Informs all registered listeners that the user has changed their preference settings.
-
-