Package adams.gui.selection

Class AbstractConditionalDatabaseSelectionPanel<T,C extends AbstractConditions>

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

adams.gui.core.BasePanel

adams.gui.selection.AbstractSelectionPanel

adams.gui.selection.AbstractTableBasedSelectionPanel<T>

adams.gui.selection.AbstractDatabaseSelectionPanel<T>

adams.gui.selection.AbstractConditionalDatabaseSelectionPanel<T,C>

Type Parameters:

T - the type of items to display

C - the conditions to use for limiting the display

All Implemented Interfaces:

CleanUpHandler, DatabaseConnectionHandler, DatabaseConnectionProvider, DatabaseConnectionUser, DatabaseConnectionChangeListener, ImageObserver, MenuContainer, Serializable, Accessible

public abstract class AbstractConditionalDatabaseSelectionPanel<T,C extends AbstractConditions>
extends AbstractDatabaseSelectionPanel<T>

Abstract ancestor for selection panels that allow a conditional display of the items collected from the database.

Version:

$Revision$

Author:

fracpete (fracpete at waikato dot ac dot nz)

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class adams.gui.selection.AbstractTableBasedSelectionPanel

AbstractTableBasedSelectionPanel.AbstractSelectionTableModel<T>, AbstractTableBasedSelectionPanel.SelectionPopupMenuSupplier

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 BaseButton	m_ButtonOptions	the button for setting the name retrieval options.
protected C	m_Conditions	the conditions for retrieving the items.

Fields inherited from class adams.gui.selection.AbstractDatabaseSelectionPanel

m_ButtonRefresh, m_DatabaseConnection, m_DataDisplayed

Fields inherited from class adams.gui.selection.AbstractTableBasedSelectionPanel

m_Current, m_DoubleClickListeners, m_LabelCounts, m_PanelAdditional, m_PanelAll, m_PanelCounts, m_PopupMenuSupplier, m_SearchPanel, m_Self, m_TableData, m_TableDataModel

Fields inherited from class adams.gui.selection.AbstractSelectionPanel

DEFAULT_REFRESH_TIMEOUT

Fields inherited from class adams.gui.core.BasePanel

m_FileChooser

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
AbstractConditionalDatabaseSelectionPanel()

Method Summary

Modifier and Type	Method	Description
protected boolean	check(AbstractConditions conditions)	Checks the chosen conditions against the approved ones.
protected abstract void	doRefresh()	Performs the actual refresh.
protected abstract Class[]	getApprovedConditions()	Returns the approved conditions that can be used.
protected boolean	getCanChangeConditionsClass()	Returns whether the conditions class can be changed in the GUI.
protected abstract C	getDefaultConditions()	Returns the default conditions to use.
protected void	initGUI()	initializes the GUI elements.
protected void	initialize()	For initializing members.
protected void	postRefresh(T[] items)	Performs actions after the refresh, like enabling buttons, updating counts and changing mouse cursor back to normal one.
protected void	preRefresh()	Performs actions before the refresh, like disabling buttons and changing mouse cursor to waiting one.
void	setEnabled(boolean value)	Sets the enabled state of the panel.
protected void	showOptions()	Displays the options for selecting the names.

Methods inherited from class adams.gui.selection.AbstractDatabaseSelectionPanel

addRefreshActionListener, beforeShow, cleanUp, databaseConnected, databaseConnectionStateChanged, databaseDisconnected, getDatabaseConnection, getDefaultDatabaseConnection, refresh, refresh, refreshIfNecessary, removeRefreshActionListener, setDatabaseConnection, setItems, setVisible

Methods inherited from class adams.gui.selection.AbstractTableBasedSelectionPanel

addDoubleClickListener, addListSelectionListener, addToMissing, getCurrentItems, getItem, getItemClass, getItemCount, getItems, getPopupMenuSupplier, getSelectedItemCount, getSelectedRowCount, grabFocus, isCountsVisible, isMultipleSelection, isValidItem, newSearchPanel, newTableModel, notifyDoubleClickListeners, processMissing, removeDoubleClickListener, removeListSelectionListener, scrollIntoView, search, select, setCountsVisible, setDefaultPopupMenuSupplier, setItem, setMultipleSelection, setPopupMenuSupplier, updateCounts

Methods inherited from class adams.gui.selection.AbstractSelectionPanel

waitForEnabled, waitForEnabled

Methods inherited from class adams.gui.core.BasePanel

afterHide, afterShow, beforeHide, closeParent, finishInit, getParentChild, getParentDialog, getParentFrame, getParentInternalFrame, getParentTitle, initFileChooser, main, printErrorMessage, printException, saveComponent, setEnabledCascade, setEnabledCascade, setParentTitle

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, 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, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, 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 Detail

m_ButtonOptions

protected BaseButton m_ButtonOptions

the button for setting the name retrieval options.

m_Conditions

protected C extends AbstractConditions m_Conditions

the conditions for retrieving the items.

Constructor Detail

AbstractConditionalDatabaseSelectionPanel

public AbstractConditionalDatabaseSelectionPanel()

Method Detail

initialize

protected void initialize()

For initializing members.

Overrides:

initialize in class AbstractDatabaseSelectionPanel<T>

initGUI

protected void initGUI()

initializes the GUI elements.

Overrides:

initGUI in class AbstractDatabaseSelectionPanel<T>

setEnabled

public void setEnabled(boolean value)

Sets the enabled state of the panel.

Overrides:

setEnabled in class AbstractDatabaseSelectionPanel<T>

Parameters:

value - if true then the components will be enabled

getDefaultConditions

protected abstract C getDefaultConditions()

Returns the default conditions to use.

Returns:

the conditions

getApprovedConditions

protected abstract Class[] getApprovedConditions()

Returns the approved conditions that can be used.

Returns:

the approved conditions

check

protected boolean check(AbstractConditions conditions)

Checks the chosen conditions against the approved ones.

Parameters:

conditions - the conditions to check

Returns:

true if OK to use

getCanChangeConditionsClass

protected boolean getCanChangeConditionsClass()

Returns whether the conditions class can be changed in the GUI.

Returns:

true if the conditions class can get changed

showOptions

protected void showOptions()

Displays the options for selecting the names.

preRefresh

protected void preRefresh()

Performs actions before the refresh, like disabling buttons and changing mouse cursor to waiting one.

Overrides:

preRefresh in class AbstractDatabaseSelectionPanel<T>

doRefresh

protected abstract void doRefresh()

Performs the actual refresh.

Specified by:

doRefresh in class AbstractDatabaseSelectionPanel<T>

postRefresh

protected void postRefresh(T[] items)

Performs actions after the refresh, like enabling buttons, updating counts and changing mouse cursor back to normal one.

Overrides:

postRefresh in class AbstractDatabaseSelectionPanel<T>