de.must.wuic

Class ColumnDataListInlay

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

de.must.wuic.MustContainer

de.must.wuic.AbstractDataListInlay

de.must.wuic.ColumnDataListInlay

All Implemented Interfaces:

DataChangeListener, AppTextResource, MessageReceiver, NextPreviousSupporter, WindowController, ContextHelp, DataPropertyAdministrationInlay.Owner, MustContainer.Owner, PropertyAdministrationInlay.Owner, java.awt.event.ActionListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.lang.Runnable, java.util.EventListener

public abstract class ColumnDataListInlay
extends AbstractDataListInlay

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 de.must.wuic.AbstractDataListInlay

AbstractDataListInlay.Owner, AbstractDataListInlay.Variant

Nested classes/interfaces inherited from class de.must.wuic.MustContainer

MustContainer.Creator

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

Modifier and Type	Field and Description
protected RecordSelectTable	selectTable
protected RecordSelectTableModel	selectTableModel
protected TableIndiv	tableIndiv

Fields inherited from class de.must.wuic.AbstractDataListInlay

associatedPropertyAdministrationInlay, buttonChoose, buttonClose, buttonCopy, buttonDelete, buttonList, buttonNew, buttonPresent, buttonPresentSimple, buttonPrint, buttonProperties, cbVariant, currentAttributeList, currentMaxListEntries, expertSearchTextArea, globalSearchTextField, 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, mustTabbedPane1, owner, panelBottom, panelButtons, panelSelectButtons, panelTop, presentationCreator, presentationInstance, printInstance, refreshCausedByListButton, searchCombination, searchElements, THREAD_MODE_EXTEND, THREAD_MODE_FILL, THREAD_MODE_RESET, threadMode, variant

Fields inherited from class de.must.wuic.MustContainer

destroyed, dirty, header, sd, specialImageIcon, statusLabel

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
ColumnDataListInlay(AbstractDataListInlay.Owner owner) Constructs a new frame for selecting data.
ColumnDataListInlay(AbstractDataListInlay.Owner owner, AbstractDataListInlay.Variant variant) 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.
protected void	completeListFill() Ending of list fills into a list model which is not currently assigned to the view.
protected TableIndiv	createTableIndiv() Returns individual table information.
void	destroy()
protected void	endOfListThread() Called when list thread ends.
protected java.lang.String[]	getColumnNames()
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.
Identifier	getNextIdentifier(boolean setSelection) Returns the next item in sequence.
Identifier	getPreviousIdentifier(boolean setSelection) Returns the previous item in sequence.
protected 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.
boolean	hasNext() Returns true if next item is available.
protected void	initCalledByAbstractDataListArea()
protected abstract void	initCalledByColumnDataListArea()
protected void	printAsShown(java.lang.String outputFolder) Prints selected table rows in sort order and column position as shown via HTML.
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.
protected void	setCellProperty(int column, CellProperties cellProperties)
void	setMaxColumnWidth(int col, int width) Sets the maximum 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.AbstractDataListInlay

acceptsClosingDueToInactivity, actionPerformed, append, buildStatusLabel, chooseButtonAction, closeInstance, copyButtonAction, createButton, createCheckBox, createCheckBox, createCleartextClassification, createComboBox, createComboBox, createComboBox, createComboBox, createComboBox, createComboBox, createDateField, createDateField, createFragmentExactChoice, createIntField, createIntField, createListDataObjectIfNull, createListDataObjects, createPropertyAdministrationInlay, createRadioButtons, createTextField, createTextField, createTextField, createTextField, createTextFieldForGlobalSearch, createTextFieldForGlobalSearch, createVariableChoice, createVariableChoice, createVariableChoice, createVariableChoice, createWhereCondition, dataChangePerformed, deactivate, delayedInititialActions, delete, deleteButtonAction, detailClosed, extendList, extendListAsThread, fillList, free, getAdditionalWhereConditionForGlobalSearch, getAssociatedPropertyAdministrationInlay, getDifferingIconName, getElaboratedWhereCondition, getInitialXLocation, getInitialYLocation, getListDataObject, getListModification, getListThreadPriority, getMaxListEntries, getNotFoundNotification, getOrderByFields, getPresentationCreator, getPrintClass, getPrivateWhereConditionNotExpert, getSelectedIdentifierVector, getSelectedTab, getSelectionFields, getTerritory, getTitle, getWhereCondition, getWhereCondtionnForPrepStmts, isChoosingAllowed, isClosingAllowed, isConnectionOpen, isCurrentListingCanceled, isEditable, isInputAccepted, isModificationAllowed, isNewItemCreationAllowed, isRealSearch, listButtonAction, newButtonAction, newDynamicSearchPanel, newDynamicSearchPanel, newPanel, newPanel, newPanel, newPanelWithExpertSearchTextArea, presentButtonAction, printButtonAction, propertyButtonAction, receive, recover, refreshList, refreshList, requestFocusInWindow, reset, resetExtensionMode, resetList, run, select, setAutoInitialListFill, setEditable, setFieldFocus, setInitialXLocation, setInitialYLocation, setListThreadPriority, setMaxListEntries, setOnChoice, setPresentationCreator, setSpecialNewEntryExpression

Methods inherited from class de.must.wuic.MustContainer

generalActionBeginnung, generalActionEnding, getAppResStr, getContentPane, getFrame, getHelpTarget, getHelpTopic, getImageIcon, getLocale, getRootPane, getTranslation, isCancelAllowed, isClosingAllowed, register, register, resetMessage, resetTemporaryMessage, setDefaultButton, setHelpContext, setHelpContext, setMessage, setMessageToKeep, setMessageToKeep, setTitle

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, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, 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, updateUI

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, getAccessibleContext, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, 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

Methods inherited from interface de.must.wuic.MustContainer.Owner

getFrame

Field Detail

tableIndiv

protected TableIndiv tableIndiv

selectTable

protected RecordSelectTable selectTable

selectTableModel

protected RecordSelectTableModel selectTableModel

Constructor Detail

ColumnDataListInlay

public ColumnDataListInlay(AbstractDataListInlay.Owner owner)

Constructs a new frame for selecting data.

Parameters:

ownerFrame - the frame form where this frame is called

ColumnDataListInlay

public ColumnDataListInlay(AbstractDataListInlay.Owner owner,
                           AbstractDataListInlay.Variant variant)

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

initCalledByAbstractDataListArea

protected final void initCalledByAbstractDataListArea()

Specified by:

initCalledByAbstractDataListArea in class AbstractDataListInlay

createTableIndiv

protected TableIndiv createTableIndiv()

Returns individual table information. Override it. Formally it was usual to use setPreferredColumnWidth() and override createListDataObjects(), getColumnNames() and getRowString(). This may be applied furthermore. Anyway this method has advantages. It is easier to implement column variations by user configuration due to reducing conditioning at a unique position.

Returns:

individual table information

getColumnNames

protected java.lang.String[] getColumnNames()

initCalledByColumnDataListArea

protected abstract void initCalledByColumnDataListArea()

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

clearSelection

protected final void clearSelection()

Clears the selection.

Specified by:

clearSelection in class AbstractDataListInlay

removeAllOfTheList

protected final void removeAllOfTheList()

Removes all items of the table.

Specified by:

removeAllOfTheList in class AbstractDataListInlay

beginListFill

protected void beginListFill()

Dummy due to SimpleDataListFrame.

Specified by:

beginListFill in class AbstractDataListInlay

See Also:

AbstractDataListInlay.completeListFill()

beginListExtension

protected void beginListExtension()

Specified by:

beginListExtension in class AbstractDataListInlay

completeListFill

protected void completeListFill()

Description copied from class: AbstractDataListInlay

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 AbstractDataListInlay

See Also:

AbstractDataListInlay.beginListFill()

getSelectedIdentifier

public Identifier getSelectedIdentifier()

Returns the selected identifier.

Specified by:

getSelectedIdentifier in class AbstractDataListInlay

Returns:

the selected identifier

getSelectedIdentifiers

public Identifier[] getSelectedIdentifiers()

Returns the selected identifiers.

Specified by:

getSelectedIdentifiers in class AbstractDataListInlay

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 AbstractDataListInlay

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: AbstractDataListInlay

Returns the selected items.

Specified by:

getSelectedItems in class AbstractDataListInlay

Returns:

the selected items

hasNext

public boolean hasNext()

Description copied from interface: NextPreviousSupporter

Returns true if next item is available.

Returns:

true if next item is available

getNextIdentifier

public Identifier getNextIdentifier(boolean setSelection)

Description copied from interface: NextPreviousSupporter

Returns the next item in sequence.

Returns:

the next item in sequence

getPreviousIdentifier

public Identifier getPreviousIdentifier(boolean setSelection)

Description copied from interface: NextPreviousSupporter

Returns the previous item in sequence.

Returns:

the previous item in sequence

requestListingFocus

protected void requestListingFocus()

Request the focus to the list.

Specified by:

requestListingFocus in class AbstractDataListInlay

handleDataChangeIndividually

protected void handleDataChangeIndividually(DataChangedEvent dce)

Description copied from class: AbstractDataListInlay

Called from DataObject when data have been changed.

Specified by:

handleDataChangeIndividually in class AbstractDataListInlay

Parameters:

dce - the data change event

See Also:

DataChangeListener, DataObject

setSelectedIdentifier

public void setSelectedIdentifier(Identifier identifier)

Description copied from class: AbstractDataListInlay

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

Specified by:

setSelectedIdentifier in class AbstractDataListInlay

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 AbstractDataListInlay

getSelectedIndex

protected final int getSelectedIndex()

Returns the index of the selected item.

Specified by:

getSelectedIndex in class AbstractDataListInlay

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 AbstractDataListInlay

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 AbstractDataListInlay

Returns:

the number of items in the table

getIdentifiers

public Identifier[] getIdentifiers()

Returns the identifiers of all listed items.

Specified by:

getIdentifiers in class AbstractDataListInlay

Returns:

the identifiers of all listed items

beginOfListThread

protected void beginOfListThread()

Called when the list thread begins.

Specified by:

beginOfListThread in class AbstractDataListInlay

endOfListThread

protected void endOfListThread()

Description copied from class: AbstractDataListInlay

Called when list thread ends.

Overrides:

endOfListThread in class AbstractDataListInlay

repaintSelectTable

protected void repaintSelectTable()

Repaints the select table.

getRowObjects

protected 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

setCellProperty

protected void setCellProperty(int column,
                               CellProperties cellProperties)

printAsShown

protected void printAsShown(java.lang.String outputFolder)

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

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)

destroy

public void destroy()

Overrides:

destroy in class AbstractDataListInlay