de.must.wuic

Class ColumnDataListFrame

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Frame

javax.swing.JFrame

de.must.wuic.MustFrame

de.must.wuic.MustFrameWithStatusLabel

de.must.wuic.AbstractDataListFrame

de.must.wuic.ColumnDataListFrame

All Implemented Interfaces:

DataChangeListener, AppTextResource, MessageReceiver, ContextHelp, java.awt.event.ActionListener, java.awt.event.ComponentListener, java.awt.event.WindowListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.lang.Runnable, java.util.EventListener, javax.accessibility.Accessible, javax.swing.RootPaneContainer, javax.swing.WindowConstants

Direct Known Subclasses:

ColumnDataListFrameForInlay

public abstract class ColumnDataListFrame
extends AbstractDataListFrame

Frame for database inquiry, data overview by JTable and record selection. Needs associated property frame for modifications of selected records.

See Also:

SimpleDataListFrame, Serialized Form

Nested Class Summary

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

javax.swing.JFrame.AccessibleJFrame

Nested classes/interfaces inherited from class java.awt.Frame

java.awt.Frame.AccessibleAWTFrame

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
protected RecordSelectTable	selectTable
protected RecordSelectTableModel	selectTableModel

Fields inherited from class de.must.wuic.AbstractDataListFrame

associatedPropertyAdministration, buttonChoose, buttonClose, buttonCopy, buttonDelete, buttonList, buttonNew, buttonPresent, buttonPrint, buttonProperties, currentAttributeList, currentMaxListEntries, expertSearchTextArea, globalSearchTextField, initialXLocation, initialYLocation, inquiryHistory, jSplitPane1, lastSelectionIdentifier, LIST_MODIFICATION_APPEND, LIST_MODIFICATION_REMOVE, LIST_MODIFICATION_UPDATE, LIST_REFRESH_OFF, LIST_REFRESH_PROCEEDING, LIST_REFRESH_SUSPENDED, listIndex, listIsToRefresh, listModification, listRefreshState, listScrollPane, listThread, logic, maxListEntries, maxListEntriesIndividual, mustTabbedPane1, panelButtons, panelSelectButtons, panelTop, presentationInstance, printInstance, refreshCausedByListButton, rootFrame, searchCombination, searchElements, tabAttributeList, tabCount, THREAD_MODE_EXTEND, THREAD_MODE_FILL, THREAD_MODE_RESET, threadMode

Fields inherited from class de.must.wuic.MustFrameWithStatusLabel

statusLabel

Fields inherited from class de.must.wuic.MustFrame

defaultCursor, ownerFrame, waitCursor

Fields inherited from class javax.swing.JFrame

accessibleContext, EXIT_ON_CLOSE, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

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, 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
ColumnDataListFrame(java.awt.Frame ownerFrame, java.lang.String[] columnNames) Constructs a frame for data selection by using a table.
ColumnDataListFrame(java.awt.Frame ownerFrame, java.util.Vector<java.lang.String> columnNames) Constructs a frame for data selection by using a table.
ColumnDataListFrame(java.lang.String[] columnNames) Constructs a frame for data selection by using a table.

Method Summary

Modifier and Type	Method and Description
protected void	appendListEntry() Adds an entry at the end of the table.
protected void	beginListExtension()
protected void	beginListFill() Dummy due to SimpleDataListFrame.
protected void	beginOfListThread() Called when the list thread begins.
protected void	clearSelection() Clears the selection.
void	closeInstance() Closes the frame and its associated frames and destroys them.
protected void	completeListFill() Ending of list fills into a list model which is not currently assigned to the view.
protected void	createGUI()
protected void	creationEnding() Conclusion of the construction process.
protected void	endOfListThread() Called when the list thread ends.
Identifier[]	getIdentifiers() Returns the identifiers of all listed items.
java.lang.String	getItem(int index) Returns a table row in format columnValue1 / columnValue2 / ...
protected int	getListItemCount() Returns the number of items in the table.
abstract java.lang.Object[]	getRowObjects() Returns the column objects to layout one row of the table to provide overview information, which allows the user to identify the entry.
Identifier	getSelectedIdentifier() Returns the selected identifier.
java.util.Vector<Identifier>	getSelectedIdentifierAsVector() Returns the selected identifiers as vector.
Identifier[]	getSelectedIdentifiers() Returns the selected identifiers.
protected int	getSelectedIndex() Returns the index of the selected item.
java.lang.String	getSelectedItem() Returns the selected item.
java.lang.String[]	getSelectedItems() Returns the selected items.
protected void	handleDataChangeIndividually(DataChangedEvent dce) Called from DataObject when data have been changed.
protected void	printAsShown(java.lang.String outputFolder, java.lang.String fileName, java.lang.String title, java.lang.String generator) Prints selected table rows in sort order and column position as shown via HTML.
protected void	removeAllOfTheList() Removes all items of the table.
protected void	repaintSelectTable() Repaints the select table.
protected void	requestListingFocus() Request the focus to the list.
protected void	selectListIndex(int indexToSelect) Selects the entry of the list with the specified index and ensures, that the entry is visible by scrolling to the entry.
void	setMaxColumnWidth(int col, int width) Sets the maximum column width of a column as specified.
void	setPreferreColumnWidth(int col, int width) Sets the preferred column width of a column as specified.
void	setPreferredColumnWidth(int[] columnWidth) Sets the preferred column width of all columns as specified.
void	setPreferredColumnWidth(java.util.Vector<java.lang.Integer> columnWidth) Sets the preferred column width of all columns as specified.
void	setSelectedIdentifier(Identifier identifier) Selects an item of the list / a row by identifier.

Methods inherited from class de.must.wuic.AbstractDataListFrame

acceptsClosingDueToInactivity, actionPerformed, append, chooseButtonAction, copyButtonAction, createButton, createCheckBox, createCheckBox, createCleartextClassification, createComboBox, createComboBox, createComboBox, createDateField, createDateField, createFragmentExactChoice, createIntField, createIntField, createListDataObjectIfNull, createListDataObjects, createOrRecoverPropertyAdministration, createRadioButtons, createTextField, createTextField, createTextField, createTextFieldForGlobalSearch, createTextFieldForGlobalSearch, createVariableChoice, createVariableChoice, createVariableChoice, createVariableChoice, createVariableChoice, createWhereCondition, dataChangePerformed, delayedInititialActions, delete, deleteButtonAction, extendList, extendListAsThread, fillList, free, getAdditionalWhereConditionForGlobalSearch, getAssociatedPropertyAdministration, getElaboratedWhereCondition, getInitialXLocation, getInitialYLocation, getListDataObject, getListModification, getListThreadPriority, getMaxListEntries, getNotFoundNotification, getOrderByFields, getPresentationClass, getPrintClass, getPrivateWhereConditionNotExpert, getSelectedIdentifierVector, getSelectedTab, getSelectionFields, getTerritory, getWhereCondition, isChoosingAllowed, isClosingAllowed, isConnectionOpen, isCurrentListingCanceled, isEditable, isInputAccepted, isModificationAllowed, listButtonAction, newButtonAction, newDynamicSearchPanel, newDynamicSearchPanel, newPanel, newPanel, newPanel, newPanelWithExpertSearchTextArea, packIfNotLaidOut, presentButtonAction, printButtonAction, propertyButtonAction, receive, refreshList, reset, resetExtensionMode, resetList, resetListDataObjectWrapper, run, select, setAssociatedPropertyAdministration, setAssociatedPropertyAdministration, setAutoInitialListFill, setEditable, setInitialXLocation, setInitialYLocation, setListDataObject, setListThreadPriority, setMaxListEntries, setMaxListEntriesIndividual

Methods inherited from class de.must.wuic.MustFrameWithStatusLabel

generalActionBeginnung, generalActionEnding, init, resetMessage, resetTemporaryMessage, setDefaultStatustext, setMessage, setMessageToKeep, setMessageToKeep

Methods inherited from class de.must.wuic.MustFrame

adjustSizeToPlausibleValue, bringToFrontAll, closeAll, closeAll, closeAllDueToInactivity, closeMainInstance, componentHidden, componentMoved, componentResized, componentShown, deiconifyAllExept, deregisterAsMainInstance, destroy, finalize, getAppResStr, getFrame, getHelpTarget, getHelpTopic, getLocale, getOrCreateMainInstance, getOrCreateMainInstance, getTranslation, iconifyAllExept, isCached, isClosingAllowedForAllFrames, isLaidOut, isRevivable, locateInCenter, logDebug, logError, logError, logError, logInfo, maximizeToBottomAndRight, open, packAndLocateInCenter, packAndLocateInCenterIfNotLaidOut, popupMessage, reInitialize, setDefaultIconImage, setDefaultIconImages, setHelpContext, setHelpContext, setIconImages, setLocaleStatically, setTitle, toFront, windowActivated, windowClosed, windowClosing, windowDeactivated, windowDeiconified, windowIconified, windowOpened

Methods inherited from class javax.swing.JFrame

addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Frame

addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setBackground, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setOpacity, setResizable, setShape, setState, setUndecorated

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, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, setVisible, show, toBack

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, 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, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Field Detail

selectTable

protected RecordSelectTable selectTable

selectTableModel

protected RecordSelectTableModel selectTableModel

Constructor Detail

ColumnDataListFrame

public ColumnDataListFrame(java.lang.String[] columnNames)

Constructs a frame for data selection by using a table.

Parameters:

columnNames - the names of the columns to be shown in the overview. The number of columns must fit to the number of objects requested in getRowObjects()

See Also:

getRowObjects()

ColumnDataListFrame

public ColumnDataListFrame(java.awt.Frame ownerFrame,
                           java.util.Vector<java.lang.String> columnNames)

Constructs a frame for data selection by using a table.

Parameters:

ownerFrame - the owner frame

columnNames - the names of the columns to be shown in the overview. The number of columns must fit to the number of objects requested in getRowObjects()

See Also:

getRowObjects()

ColumnDataListFrame

public ColumnDataListFrame(java.awt.Frame ownerFrame,
                           java.lang.String[] columnNames)

Constructs a frame for data selection by using a table.

Parameters:

ownerFrame - the owner frame

columnNames - the names of the columns to be shown in the overview. The number of columns must fit to the number of objects requested in getRowObjects()

See Also:

getRowObjects()

Method Detail

createGUI

protected void createGUI()

setPreferredColumnWidth

public void setPreferredColumnWidth(java.util.Vector<java.lang.Integer> columnWidth)

Sets the preferred column width of all columns as specified.

Parameters:

columnWidth - the Integer Vector of column widths to use

setPreferredColumnWidth

public void setPreferredColumnWidth(int[] columnWidth)

Sets the preferred column width of all columns as specified.

Parameters:

columnWidth - the array of column widths to use

setMaxColumnWidth

public void setMaxColumnWidth(int col,
                              int width)

Sets the maximum column width of a column as specified.

Parameters:

col - the column whose width shall be set

width - the new width of the column

setPreferreColumnWidth

public void setPreferreColumnWidth(int col,
                                   int width)

Sets the preferred column width of a column as specified.

Parameters:

col - the column whose width shall be set

width - the new width of the column

clearSelection

protected final void clearSelection()

Clears the selection.

Specified by:

clearSelection in class AbstractDataListFrame

creationEnding

protected void creationEnding()

Description copied from class: AbstractDataListFrame

Conclusion of the construction process. Allows to do construction details in the sequence super class - this - super class which is a benefit for easy layout.

Overrides:

creationEnding in class AbstractDataListFrame

removeAllOfTheList

protected final void removeAllOfTheList()

Removes all items of the table.

Specified by:

removeAllOfTheList in class AbstractDataListFrame

beginListFill

protected void beginListFill()

Dummy due to SimpleDataListFrame.

Specified by:

beginListFill in class AbstractDataListFrame

See Also:

AbstractDataListFrame.completeListFill()

beginListExtension

protected void beginListExtension()

Specified by:

beginListExtension in class AbstractDataListFrame

completeListFill

protected void completeListFill()

Description copied from class: AbstractDataListFrame

Ending of list fills into a list model which is not currently assigned to the view. The model initialized by beginListFill() becomes active now.

Specified by:

completeListFill in class AbstractDataListFrame

See Also:

AbstractDataListFrame.beginListFill()

getSelectedIdentifier

public Identifier getSelectedIdentifier()

Returns the selected identifier.

Specified by:

getSelectedIdentifier in class AbstractDataListFrame

Returns:

the selected identifier

getSelectedIdentifiers

public Identifier[] getSelectedIdentifiers()

Returns the selected identifiers.

Specified by:

getSelectedIdentifiers in class AbstractDataListFrame

Returns:

the selected identifiers

getSelectedIdentifierAsVector

public java.util.Vector<Identifier> getSelectedIdentifierAsVector()

Returns the selected identifiers as vector.

Returns:

the selected identifiers as vector

getSelectedItem

public final java.lang.String getSelectedItem()

Returns the selected item.

Specified by:

getSelectedItem in class AbstractDataListFrame

Returns:

the selected item

getItem

public java.lang.String getItem(int index)

Returns a table row in format columnValue1 / columnValue2 / ...

Parameters:

index - the index of the row to format

Returns:

a table row in format columnValue1 / columnValue2 / ...

getSelectedItems

public java.lang.String[] getSelectedItems()

Description copied from class: AbstractDataListFrame

Returns the selected items.

Specified by:

getSelectedItems in class AbstractDataListFrame

Returns:

the selected items

requestListingFocus

protected void requestListingFocus()

Request the focus to the list.

Specified by:

requestListingFocus in class AbstractDataListFrame

handleDataChangeIndividually

protected void handleDataChangeIndividually(DataChangedEvent dce)

Description copied from class: AbstractDataListFrame

Called from DataObject when data have been changed.

Specified by:

handleDataChangeIndividually in class AbstractDataListFrame

Parameters:

dce - the data change event

See Also:

DataChangeListener, DataObject

setSelectedIdentifier

public void setSelectedIdentifier(Identifier identifier)

Description copied from class: AbstractDataListFrame

Selects an item of the list / a row by identifier.

Specified by:

setSelectedIdentifier in class AbstractDataListFrame

Parameters:

identifier - the identifier of the item to be selected

appendListEntry

protected void appendListEntry()

Adds an entry at the end of the table.

Specified by:

appendListEntry in class AbstractDataListFrame

getSelectedIndex

protected final int getSelectedIndex()

Returns the index of the selected item.

Specified by:

getSelectedIndex in class AbstractDataListFrame

Returns:

the index of the selected item

selectListIndex

protected final void selectListIndex(int indexToSelect)

Selects the entry of the list with the specified index and ensures, that the entry is visible by scrolling to the entry.

Specified by:

selectListIndex in class AbstractDataListFrame

Parameters:

indexToSelect - the index of the entry to select

getListItemCount

protected final int getListItemCount()

Returns the number of items in the table.

Specified by:

getListItemCount in class AbstractDataListFrame

Returns:

the number of items in the table

getIdentifiers

public Identifier[] getIdentifiers()

Returns the identifiers of all listed items.

Specified by:

getIdentifiers in class AbstractDataListFrame

Returns:

the identifiers of all listed items

beginOfListThread

protected void beginOfListThread()

Called when the list thread begins.

Specified by:

beginOfListThread in class AbstractDataListFrame

endOfListThread

protected void endOfListThread()

Called when the list thread ends.

Specified by:

endOfListThread in class AbstractDataListFrame

repaintSelectTable

protected void repaintSelectTable()

Repaints the select table.

getRowObjects

public abstract java.lang.Object[] getRowObjects()

Returns the column objects to layout one row of the table to provide overview information, which allows the user to identify the entry.

Returns:

Returns the column objects to layout one row of the table

printAsShown

protected void printAsShown(java.lang.String outputFolder,
                            java.lang.String fileName,
                            java.lang.String title,
                            java.lang.String generator)

Prints selected table rows in sort order and column position as shown via HTML. If no row is selected, all rows will be printed.

Parameters:

outputFolder - the output folder

fileName - the output file name without extension

title - the title of HTML file (tab name)

generator - the name of the generator (application name)

closeInstance

public void closeInstance()

Description copied from class: AbstractDataListFrame

Closes the frame and its associated frames and destroys them.

Overrides:

closeInstance in class AbstractDataListFrame