de.must.wuic

Class MustList

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JList<java.lang.String>

de.must.wuic.MustList

All Implemented Interfaces:

AnySelectionSpeaker, java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.event.ListSelectionListener, javax.swing.Scrollable

Direct Known Subclasses:

DataList, RemSubList

public class MustList
extends javax.swing.JList<java.lang.String>
implements java.awt.event.MouseListener, java.awt.event.KeyListener, javax.swing.event.ListSelectionListener, AnySelectionSpeaker

A JList with assigned identifiers, useful to assign primary keys.

See Also:

Serialized Form

Nested Class Summary

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

javax.swing.JList.AccessibleJList, javax.swing.JList.DropLocation

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 inherited from class javax.swing.JList

HORIZONTAL_WRAP, VERTICAL, VERTICAL_WRAP

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 and Description
MustList() Constructs a new list.

Method Summary

Modifier and Type	Method and Description
void	addAnySelectionListener(AnySelectionListener l) Adds a selection listener to be notified about selection changed events.
void	addIndexedItem(java.lang.String visualItem, Identifier identifier) Adds an item to the list and assigns its identifier
void	addItem(java.lang.String item) Adds an item to the list.
void	applyNewModel() Applies the new model, prepared previously in disconnected state.
void	fireSelectionChanged() Informs all registered components about the selection changed event.
java.awt.Color	getBackground()
Identifier	getIdentifier(int listIndex) Returns the identifier of the specified item.
IndentifierListModel	getIdModel()
int	getItemCount() Returns the size of the list.
Identifier	getSelectedIdentifier() Returns the selected identifier (in case of integer identification).
Identifier[]	getSelectedIdentifiers()
java.lang.String	getSelectedItem() Returns the selected item.
protected java.lang.String	getTranslation(java.lang.String resourceKey) Returns a text in the corresponding language according to the locale specific resource bundle of the package.
void	keyPressed(java.awt.event.KeyEvent e)
void	keyReleased(java.awt.event.KeyEvent e)
void	keyTyped(java.awt.event.KeyEvent e)
void	mouseClicked(java.awt.event.MouseEvent e)
void	mouseEntered(java.awt.event.MouseEvent e)
void	mouseExited(java.awt.event.MouseEvent e)
void	mousePressed(java.awt.event.MouseEvent e)
void	mouseReleased(java.awt.event.MouseEvent e)
void	prepareModelForExtension() To be called as a workaround to avoid painting problems by dynamic JList extension.
void	prepareNewModel() Prepares a new model to be applied later by calling applyNewModel().
void	remove(int itemIndex) Removes an item out of the list including its identifier.
void	removeAll() Removes all items of the list and clears the identifier array.
void	removeAnySelectionListener(AnySelectionListener l) Removes a selection listener to be notified about selection changed events.
static void	setBackgroundColor(java.awt.Color color)
void	setEnterButton(MustButton enterButton) Sets the button to be clicked if enter is pressed or the item is double clicked.
void	setPopupReceiver(java.awt.event.ActionListener actionListener, MustPopupMenu.PopupReceiver receiver) Sets the pop up receiver to listen to events requesting a pop up menu.
void	setSelectedIndex(int index) Selects an item and ensures, that it is visible.
void	updateItem(java.lang.String visualItem, int index) Updates an item.
void	valueChanged(javax.swing.event.ListSelectionEvent e)

Methods inherited from class javax.swing.JList

addListSelectionListener, addSelectionInterval, clearSelection, createSelectionModel, ensureIndexIsVisible, fireSelectionValueChanged, getAccessibleContext, getAnchorSelectionIndex, getCellBounds, getCellRenderer, getDragEnabled, getDropLocation, getDropMode, getFirstVisibleIndex, getFixedCellHeight, getFixedCellWidth, getLastVisibleIndex, getLayoutOrientation, getLeadSelectionIndex, getListSelectionListeners, getMaxSelectionIndex, getMinSelectionIndex, getModel, getNextMatch, getPreferredScrollableViewportSize, getPrototypeCellValue, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedIndex, getSelectedIndices, getSelectedValue, getSelectedValues, getSelectedValuesList, getSelectionBackground, getSelectionForeground, getSelectionMode, getSelectionModel, getToolTipText, getUI, getUIClassID, getValueIsAdjusting, getVisibleRowCount, indexToLocation, isSelectedIndex, isSelectionEmpty, locationToIndex, paramString, removeListSelectionListener, removeSelectionInterval, setCellRenderer, setDragEnabled, setDropMode, setFixedCellHeight, setFixedCellWidth, setLayoutOrientation, setListData, setListData, setModel, setPrototypeCellValue, setSelectedIndices, setSelectedValue, setSelectionBackground, setSelectionForeground, setSelectionInterval, setSelectionMode, setSelectionModel, setUI, setValueIsAdjusting, setVisibleRowCount, 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

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, 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, 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, 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, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Constructor Detail

MustList

public MustList()

Constructs a new list.

Method Detail

setBackgroundColor

public static void setBackgroundColor(java.awt.Color color)

setEnterButton

public void setEnterButton(MustButton enterButton)

Sets the button to be clicked if enter is pressed or the item is double clicked.

Parameters:

enterButton - the new item default button

getIdModel

public IndentifierListModel getIdModel()

prepareModelForExtension

public void prepareModelForExtension()

To be called as a workaround to avoid painting problems by dynamic JList extension. Disconnects the current model from the view.

prepareNewModel

public void prepareNewModel()

Prepares a new model to be applied later by calling applyNewModel().

See Also:

applyNewModel()

applyNewModel

public void applyNewModel()

Applies the new model, prepared previously in disconnected state.

See Also:

prepareNewModel(), prepareModelForExtension()

removeAll

public void removeAll()

Removes all items of the list and clears the identifier array.

Overrides:

removeAll in class java.awt.Container

remove

public void remove(int itemIndex)

Removes an item out of the list including its identifier.

Overrides:

remove in class java.awt.Container

Parameters:

itemIndex - the item to be removed

setSelectedIndex

public void setSelectedIndex(int index)

Selects an item and ensures, that it is visible.

Overrides:

setSelectedIndex in class javax.swing.JList<java.lang.String>

Parameters:

index - the item to be selected

addItem

public void addItem(java.lang.String item)

Adds an item to the list.

Parameters:

item - the item to add

addIndexedItem

public void addIndexedItem(java.lang.String visualItem,
                           Identifier identifier)

Adds an item to the list and assigns its identifier

Parameters:

visualItem - the item to add

identifier - the identifier of the item

updateItem

public void updateItem(java.lang.String visualItem,
                       int index)

Updates an item.

Parameters:

visualItem - the new item value

index - the position of the item to be updated

setPopupReceiver

public void setPopupReceiver(java.awt.event.ActionListener actionListener,
                             MustPopupMenu.PopupReceiver receiver)

Sets the pop up receiver to listen to events requesting a pop up menu. If user uses right mouse on table, a pop up menu is created and located. If row of cursor position is not selected, it becomes selected now. Finally, the created pop up menu is passed to the receiver.

Parameters:

actionListener - the listener for action caused by the pop up menu

receiver - the receiver of the pop up menu

getItemCount

public int getItemCount()

Returns the size of the list.

Returns:

the size of the list

getSelectedItem

public java.lang.String getSelectedItem()

Returns the selected item.

Returns:

the selected item

getSelectedIdentifier

public Identifier getSelectedIdentifier()

Returns the selected identifier (in case of integer identification).

Returns:

the selected identifier

getSelectedIdentifiers

public Identifier[] getSelectedIdentifiers()

getIdentifier

public Identifier getIdentifier(int listIndex)

Returns the identifier of the specified item.

Parameters:

listIndex - the index of the item

Returns:

the identifier of the item

getBackground

public java.awt.Color getBackground()

Overrides:

getBackground in class java.awt.Component

mouseExited

public void mouseExited(java.awt.event.MouseEvent e)

Specified by:

mouseExited in interface java.awt.event.MouseListener

mouseEntered

public void mouseEntered(java.awt.event.MouseEvent e)

Specified by:

mouseEntered in interface java.awt.event.MouseListener

mouseClicked

public void mouseClicked(java.awt.event.MouseEvent e)

Specified by:

mouseClicked in interface java.awt.event.MouseListener

mousePressed

public void mousePressed(java.awt.event.MouseEvent e)

Specified by:

mousePressed in interface java.awt.event.MouseListener

mouseReleased

public void mouseReleased(java.awt.event.MouseEvent e)

Specified by:

mouseReleased in interface java.awt.event.MouseListener

keyPressed

public void keyPressed(java.awt.event.KeyEvent e)

Specified by:

keyPressed in interface java.awt.event.KeyListener

keyReleased

public void keyReleased(java.awt.event.KeyEvent e)

Specified by:

keyReleased in interface java.awt.event.KeyListener

keyTyped

public void keyTyped(java.awt.event.KeyEvent e)

Specified by:

keyTyped in interface java.awt.event.KeyListener

valueChanged

public void valueChanged(javax.swing.event.ListSelectionEvent e)

Specified by:

valueChanged in interface javax.swing.event.ListSelectionListener

addAnySelectionListener

public void addAnySelectionListener(AnySelectionListener l)

Adds a selection listener to be notified about selection changed events.

Specified by:

addAnySelectionListener in interface AnySelectionSpeaker

Parameters:

l - the selection listener to be notified

removeAnySelectionListener

public void removeAnySelectionListener(AnySelectionListener l)

Removes a selection listener to be notified about selection changed events.

Specified by:

removeAnySelectionListener in interface AnySelectionSpeaker

Parameters:

l - the selection listener

fireSelectionChanged

public void fireSelectionChanged()

Informs all registered components about the selection changed event.

getTranslation

protected java.lang.String getTranslation(java.lang.String resourceKey)

Returns a text in the corresponding language according to the locale specific resource bundle of the package.

Parameters:

resourceKey - the key of the resource to retrieve

Returns:

the resource