rj.tools.util.ui

Class SelectDialog

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Dialog

javax.swing.JDialog

rj.tools.util.ui.SelectDialog

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, javax.swing.RootPaneContainer, javax.swing.WindowConstants

public class SelectDialog
extends javax.swing.JDialog

SelectDialog - a general dialog displaying a list of possible selection from which the user chooses one or more. The number of selectable entries is specifed by setting the appropriate ListSelectionModel field. The default is single selection. Since the displayed data are objects the toString() method has to return something meaningfull.

Usage Example:

String[] columnHeader = new String[] {"###", "Name", "Description", "Status"}; Object[][] data = new Object[][] { {new Integer(1), "Name1", "Description1", "Status1"}, {new Integer(2), "Name2", "Description2", "Status2"}, {new Integer(3), "Name3", "Description3", "Status3"}, {new Integer(4), "Name4", "Description4", "Status4"}, {new Integer(5), "Name5", "Description5", "Status5"} }; Double[] can = new Double[] { new Double(1.1), new Double(2.2), new Double(3.3), new Double(4.4), new Double(5.5) }; SelectDialog sd = new SelectDialog("TEST", null, true, can, data, columnHeader); sd.addActionListener(new ActionListener() { public void actionPerformed(ActionEvent e) { SelectDialog tmpDlg = (SelectDialog) e.getSource(); System.out.println("Selection was: " + tmpDlg.getObject()); } }); sd.setVisible(true);

Version:

__0__

Author:

Ralph Jocham (jochamrm)

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

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

Modifier and Type	Field and Description
static java.lang.String	CANCEL
static java.lang.String	CLOSE
protected javax.swing.event.EventListenerList	mActionListener
protected java.lang.Object[]	mObjects
protected boolean	mOkedOut
protected javax.swing.JTable	mTable
static java.lang.String	OK

Fields inherited from class javax.swing.JDialog

accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Dialog

DEFAULT_MODALITY_TYPE

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
SelectDialog(java.lang.String windowTitle, java.awt.Dialog owner, boolean modal, java.lang.Object[][] rowData, java.lang.Object[] columnNames) Creates a new SelectDialog instance.
SelectDialog(java.lang.String windowTitle, java.awt.Dialog owner, boolean modal, java.lang.Object[][] rowData, java.lang.Object[] columnNames, boolean readOnly) Creates a new SelectDialog instance.
SelectDialog(java.lang.String windowTitle, java.awt.Dialog owner, boolean modal, java.lang.Object[] canditates, java.lang.Object[][] rowData, java.lang.Object[] columnNames) Creates a new SelectDialog instance.
SelectDialog(java.lang.String windowTitle, java.awt.Dialog owner, boolean modal, java.lang.Object[] canditates, java.lang.Object[][] rowData, java.lang.Object[] columnNames, boolean readOnly) Creates a new SelectDialog instance.
SelectDialog(java.lang.String windowTitle, java.awt.Frame owner, boolean modal, java.lang.Object[][] rowData, java.lang.Object[] columnNames) Creates a new SelectDialog instance.
SelectDialog(java.lang.String windowTitle, java.awt.Frame owner, boolean modal, java.lang.Object[][] rowData, java.lang.Object[] columnNames, boolean readOnly) Creates a new SelectDialog instance.
SelectDialog(java.lang.String windowTitle, java.awt.Frame owner, boolean modal, java.lang.Object[] canditates, java.lang.Object[][] rowData, java.lang.Object[] columnNames) Creates a new SelectDialog instance.
SelectDialog(java.lang.String windowTitle, java.awt.Frame owner, boolean modal, java.lang.Object[] canditates, java.lang.Object[][] rowData, java.lang.Object[] columnNames, boolean readOnly) Creates a new SelectDialog instance.

Method Summary

Methods

Modifier and Type	Method and Description
void	addActionListener(java.awt.event.ActionListener actionListener) addActionListener add an ActionListener
java.lang.Object	getObject() getObject - returns the selected object, returns null if dialog was canceled out
java.lang.Object[]	getObjects() getObjects - returns the array of selected objects, returns null if dialog was was canceled out.
static void	main(java.lang.String[] args)
void	removeActionListener(java.awt.event.ActionListener actionListener) removeActionListener - remove an ActionListener
void	setSelectionMode(int selModel) setSelectionMode - set the selection mode of the dialog.
void	setVisible(boolean theValue)

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, 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, getPeer, 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, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, 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

OK

public static final java.lang.String OK

See Also:

Constant Field Values

CANCEL

public static final java.lang.String CANCEL

See Also:

Constant Field Values

CLOSE

public static final java.lang.String CLOSE

See Also:

Constant Field Values

mActionListener

protected javax.swing.event.EventListenerList mActionListener

mTable

protected javax.swing.JTable mTable

mObjects

protected java.lang.Object[] mObjects

mOkedOut

protected boolean mOkedOut

Constructor Detail

SelectDialog

public SelectDialog(java.lang.String windowTitle,
            java.awt.Frame owner,
            boolean modal,
            java.lang.Object[][] rowData,
            java.lang.Object[] columnNames)

Creates a new SelectDialog instance.

Parameters:

windowTitle - a String - Title of Dialog

owner - a Frame - parent Frame

modal - a boolean - modal to parent Frame

rowData - an Object[][] - matrix of canditates and description. The first columns is the candidate object itself, the rest is the description. The first column is striped of, only the rest is displayed in the table.

columnNames - an Object[] - names of columns

SelectDialog

public SelectDialog(java.lang.String windowTitle,
            java.awt.Frame owner,
            boolean modal,
            java.lang.Object[] canditates,
            java.lang.Object[][] rowData,
            java.lang.Object[] columnNames)

Creates a new SelectDialog instance.

Parameters:

windowTitle - a String - Title of Dialog

owner - a Frame - parent Frame

modal - a boolean - model to parent Frame

canditates - an Object[] - objects themselves

rowData - an Object[][] - matrix describing the candiates

columnNames - an Object[] - names of columns

SelectDialog

public SelectDialog(java.lang.String windowTitle,
            java.awt.Dialog owner,
            boolean modal,
            java.lang.Object[][] rowData,
            java.lang.Object[] columnNames)

Creates a new SelectDialog instance.

Parameters:

windowTitle - a String - Title of Dialog

owner - a Dialog - parent dialog

modal - a boolean - modal to parent Frame

rowData - an Object[][] - matrix of canditates and description. The first columns is the candidate object itself, the rest is the description. The first column is striped of, only the rest is displayed in the table.

columnNames - an Object[] - names of columns

SelectDialog

public SelectDialog(java.lang.String windowTitle,
            java.awt.Dialog owner,
            boolean modal,
            java.lang.Object[] canditates,
            java.lang.Object[][] rowData,
            java.lang.Object[] columnNames)

Creates a new SelectDialog instance.

Parameters:

windowTitle - a String - Title of Dialog

owner - a Dialog - parent dialog

modal - a boolean - model to parent Frame

canditates - an Object[] - objects themselves

rowData - an Object[][] - matrix describing the candiates

columnNames - an Object[] - names of columns

SelectDialog

public SelectDialog(java.lang.String windowTitle,
            java.awt.Frame owner,
            boolean modal,
            java.lang.Object[][] rowData,
            java.lang.Object[] columnNames,
            boolean readOnly)

Creates a new SelectDialog instance.

Parameters:

windowTitle - a String - Title of Dialog

owner - a Frame - parent Frame

modal - a boolean - modal to parent Frame

rowData - an Object[][] - matrix of canditates and description. The first columns is the candidate object itself, the rest is the description. The first column is striped of, only the rest is displayed in the table.

columnNames - an Object[] - names of columns

readOnly - an boolean - Dialog is read only for displaying purposes

SelectDialog

public SelectDialog(java.lang.String windowTitle,
            java.awt.Frame owner,
            boolean modal,
            java.lang.Object[] canditates,
            java.lang.Object[][] rowData,
            java.lang.Object[] columnNames,
            boolean readOnly)

Creates a new SelectDialog instance.

Parameters:

windowTitle - a String - Title of Dialog

owner - a Frame - parent Frame

modal - a boolean - model to parent Frame

canditates - an Object[] - objects themselves

rowData - an Object[][] - matrix describing the candiates

columnNames - an Object[] - names of columns

readOnly - an boolean - Dialog is read only for displaying purposes

SelectDialog

public SelectDialog(java.lang.String windowTitle,
            java.awt.Dialog owner,
            boolean modal,
            java.lang.Object[][] rowData,
            java.lang.Object[] columnNames,
            boolean readOnly)

Creates a new SelectDialog instance.

Parameters:

windowTitle - a String - Title of Dialog

owner - a Dialog - parent dialog

modal - a boolean - modal to parent Frame

rowData - an Object[][] - matrix of canditates and description. The first columns is the candidate object itself, the rest is the description. The first column is striped of, only the rest is displayed in the table.

columnNames - an Object[] - names of columns

readOnly - an boolean - Dialog is read only for displaying purposes

SelectDialog

public SelectDialog(java.lang.String windowTitle,
            java.awt.Dialog owner,
            boolean modal,
            java.lang.Object[] canditates,
            java.lang.Object[][] rowData,
            java.lang.Object[] columnNames,
            boolean readOnly)

Creates a new SelectDialog instance.

Parameters:

windowTitle - a String - Title of Dialog

owner - a Dialog - parent dialog

modal - a boolean - model to parent Frame

canditates - an Object[] - objects themselves

rowData - an Object[][] - matrix describing the candiates

columnNames - an Object[] - names of columns

readOnly - an boolean - Dialog is read only for displaying purposes

Method Detail

main

public static void main(java.lang.String[] args)

setSelectionMode

public void setSelectionMode(int selModel)

setSelectionMode - set the selection mode of the dialog.

Parameters:

selModel - an int

See Also:

ListSelectionModel

addActionListener

public void addActionListener(java.awt.event.ActionListener actionListener)

addActionListener add an ActionListener

Parameters:

actionListener - an ActionListener

removeActionListener

public void removeActionListener(java.awt.event.ActionListener actionListener)

removeActionListener - remove an ActionListener

getObject

public java.lang.Object getObject()

getObject - returns the selected object, returns null if dialog was canceled out

Returns:

an Object value

getObjects

public java.lang.Object[] getObjects()

getObjects - returns the array of selected objects, returns null if dialog was was canceled out.

Returns:

an Object[] value

setVisible

public void setVisible(boolean theValue)

Overrides:

setVisible in class java.awt.Dialog