Module org.autogui

Package org.autogui.swing

Class GuiSwingViewCollectionTable.CollectionTable

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JTable

org.autogui.swing.GuiSwingViewCollectionTable.CollectionTable

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, EventListener, Accessible, CellEditorListener, ListSelectionListener, RowSorterListener, TableColumnModelListener, TableModelListener, Scrollable, GuiMappingContext.SourceUpdateListener, GuiSwingView.SettingsWindowClient, GuiSwingView.ValuePane<List<?>>, GuiSwingPrefsSupports.PreferencesUpdateSupport, GuiSwingTableColumnSet.TableSelectionSource

Direct Known Subclasses:

LambdaProperty.LambdaCollectionTable

Enclosing class:

GuiSwingViewCollectionTable

public static class GuiSwingViewCollectionTable.CollectionTable
extends JTable
implements GuiMappingContext.SourceUpdateListener, GuiSwingView.ValuePane<List<?>>, GuiSwingTableColumnSet.TableSelectionSource, GuiSwingPrefsSupports.PreferencesUpdateSupport, GuiSwingView.SettingsWindowClient

See Also:

• Serialized Form

Nested Class Summary

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

JTable.AccessibleJTable, JTable.DropLocation, JTable.PrintMode

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 List<Action>	actions
protected JToolBar	actionToolBar
protected List<GuiSwingTableColumnSetDefault.TableSelectionListAction>	autoSelectionActions
protected int	autoSelectionDepth
protected List<PopupCategorized.CategorizedMenuItem>	columnHeaderMenuItems
protected GuiMappingContext	context
protected boolean	customHighlighting
protected boolean	customRowHeightByUser
protected boolean	customRowHeightIndividual	some row-height is customized by setRowHeight(int, int).
protected MenuBuilder.MenuLabel	infoLabel
protected List<Integer>	lastSelectionActionIndices
protected List<PopupCategorized.CategorizedMenuItem>	menuItems
protected GuiSwingViewCollectionTable.PopupExtensionCollection	popup
protected GuiSwingViewCollectionTable.PopupExtensionCollectionColumnHeader	popupColumnHeader
protected GuiSwingViewCollectionTable.TablePreferencesUpdater	preferencesUpdater
protected int	rowHeightByProgram
protected GuiSwingViewCollectionTable.RowHeightSetAction	rowHeightSetAction
protected EditingRunner	selectionRunner
protected GuiSwingViewCollectionTable.TableSelectionSourceForIndices	selectionSourceForRowAndColumnIndices
protected GuiSwingViewCollectionTable.TableSelectionSourceForIndices	selectionSourceForRowIndices
protected SettingsWindow	settingsWindow
protected List<?>	source
protected GuiSwingView.SpecifierManager	specifierManager
protected GuiTaskClock	viewClock

Fields inherited from class javax.swing.JTable

AUTO_RESIZE_ALL_COLUMNS, AUTO_RESIZE_LAST_COLUMN, AUTO_RESIZE_NEXT_COLUMN, AUTO_RESIZE_OFF, AUTO_RESIZE_SUBSEQUENT_COLUMNS, autoCreateColumnsFromModel, autoResizeMode, cellEditor, cellSelectionEnabled, columnModel, dataModel, defaultEditorsByColumnClass, defaultRenderersByColumnClass, editingColumn, editingRow, editorComp, gridColor, preferredViewportSize, rowHeight, rowMargin, rowSelectionAllowed, selectionBackground, selectionForeground, selectionModel, showHorizontalLines, showVerticalLines, tableHeader

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
CollectionTable(GuiMappingContext context, GuiSwingView.SpecifierManager specifierManager)

Method Summary

Modifier and Type	Method	Description
void	changeSelection(int[] selectedModelRowsIndices, GuiSwingTableColumnSet.TableSelectionChange change)
void	changeSelectionIndices(int[] selectedModelRowsIndices, GuiSwingTableColumnSet.TableSelectionChangeIndices change)
void	changeSelectionIndicesRowAndColumns(int[] selectedModelRowsIndices, GuiSwingTableColumnSet.TableSelectionChangeIndicesRowAndColumn change)
void	changeSelectionNothing(int[] selectedModelRowsIndices, GuiSwingTableColumnSet.TableSelectionChange change)
void	changeSelectionValues(int[] selectedModelRowsIndices, GuiSwingTableColumnSet.TableSelectionChangeValues change)
int	convertColumnIndexToView(int modelColumnIndex)
protected JTableHeader	createDefaultTableHeader()
List<Action>	getActions()
JToolBar	getActionToolBar()
List<PopupCategorized.CategorizedMenuItem>	getColumnHeaderMenuItems()
protected GuiInits	getInits()
GuiSwingTableModelCollection	getObjectTableModel()
GuiSwingViewCollectionTable.PopupExtensionCollection	getPopup()
int	getRowHeightByProgram()
GuiSwingViewCollectionTable.RowHeightSetAction	getRowHeightSetAction()	obtains an object for row-height customizing
GuiSwingTableColumn.SpecifierManagerIndex	getRowSpecifier()
List<?>	getSelectedItems()
GuiSwingViewCollectionTable.TableSelectionSourceForIndices	getSelectionSourceForRowAndColumnIndices()
GuiSwingViewCollectionTable.TableSelectionSourceForIndices	getSelectionSourceForRowIndices()
SettingsWindow	getSettingsWindow()
List<?>	getSource()
GuiReprValue.ObjectSpecifier	getSpecifier()
PopupExtension.PopupMenuBuilder	getSwingMenuBuilder()	a typical implementation if there are no dynamic items becomes like the following code:
List<PopupCategorized.CategorizedMenuItem>	getSwingStaticMenuItems()	a typical implementation becomes like the following code:
GuiMappingContext	getSwingViewContext()
List<?>	getSwingViewValue()
String	getTargetName()
String	getToolTipText(MouseEvent event)
boolean	hasCustomRowHeightByUser()
void	init()
void	initAction(JToolBar actionToolBar, Action action)
JToolBar	initActionToolBar(List<Action> actions)
void	initAfter()
void	initColor()
void	initContextUpdate()
void	initDragDrop()
void	initFocus()
void	initGrid()
void	initModel()
void	initName()
void	initPopup()
void	initPreferencesUpdater()
void	initRowHeight()
protected void	initRowHeightDefault()	set initial row-height settings from GuiInits; reusing setting methods of GuiSwingViewCollectionTable.PreferencesForTable
void	initSelection()
void	initSelectionClear()
void	initSelectionSource()
GuiSwingViewWrapper.ValueScrollPane<?>	initTableScrollPane()
void	initTableScrollPane(JScrollPane scrollPane)
void	initValue()
protected boolean	isAutoResizeOff()
boolean	isSelectionEmpty()
void	loadSwingPreferences(GuiPreferences prefs, GuiSwingPrefsApplyOptions options)	a sub-class which wraps another value-pane should overrides the method in order to omit needless value setting.
protected void	paintComponent(Graphics g)
protected void	paintSelectedRows(Graphics2D g2)
void	prepareForRefresh()	for each component, the method is called before refreshing in order to clear the view-clock.
void	runAutoSelectionActions(List<Object> es)
void	runListSelection(ListSelectionEvent e)
void	saveSwingPreferences(GuiPreferences prefs)	only save the component itself, not including children.
void	selectionActionFinished(boolean autoSelection, GuiSwingTableColumnSet.TableSelectionChange change)	the finisher for the action: the table implements the method in order to refresh selected rows.
void	selectionActionPrepare()	the preparation for the action: the table stops editing
void	setCellEditor(TableCellEditor anEditor)
void	setKeyStrokeString(String keyStrokeString)	set the key-stroke info.
void	setPreferencesUpdater(Consumer<GuiSwingPrefsSupports.PreferencesUpdateEvent> updater)
void	setRowHeight(int rowHeight)
void	setRowHeight(int row, int rowHeight)
void	setRowHeightByUser(int rowHeight)	setting the custom row-height
void	setSettingsWindow(SettingsWindow settingsWindow)	at initialization of the root-pane, the method will be called for existing sub-panes.
void	setSwingViewValue(List<?> value)	update GUI display, and it does NOT update the target model value.
void	setSwingViewValue(List<?> value, GuiTaskClock clock)	update if the clock is newer than the current view-clock of the pane.
void	setSwingViewValueWithUpdate(List<?> value)	update the GUI display and the model.
void	setSwingViewValueWithUpdate(List<?> value, GuiTaskClock clock)	update the GUI display and the model if the clock is newer than the current view-clock of the pane.
void	setupAfterAddingColumns()	setup related components for the table and actions
JComponent	setupAfterAddingColumns(List<Action> actions)
void	shutdownSwingView()	for each component, at the end of the process, this method will be called
void	tableChanged(TableModelEvent e)	overrides for preserving custom-row-heights if e is a total refreshing: If TableModelEvent.getLastRow() is Integer.MAX_VALUE, it indicates updating of all rows.
void	update(GuiMappingContext cause, Object newValue, GuiTaskClock contextClock)
void	updateFromGui(Object v, GuiTaskClock viewClock)
void	updateSwingViewSource()	update by context and refresh by ObjectTableModel.refreshData()
void	updateSwingViewSourceFromRoot()	update by context and refresh by ObjectTableModel.refreshData()

Methods inherited from class javax.swing.JTable

addColumn, addColumnSelectionInterval, addNotify, addRowSelectionInterval, changeSelection, clearSelection, columnAdded, columnAtPoint, columnMarginChanged, columnMoved, columnRemoved, columnSelectionChanged, configureEnclosingScrollPane, convertColumnIndexToModel, convertRowIndexToModel, convertRowIndexToView, createDefaultColumnModel, createDefaultColumnsFromModel, createDefaultDataModel, createDefaultEditors, createDefaultRenderers, createDefaultSelectionModel, createScrollPaneForTable, doLayout, editCellAt, editCellAt, editingCanceled, editingStopped, getAccessibleContext, getAutoCreateColumnsFromModel, getAutoCreateRowSorter, getAutoResizeMode, getCellEditor, getCellEditor, getCellRect, getCellRenderer, getCellSelectionEnabled, getColumn, getColumnClass, getColumnCount, getColumnModel, getColumnName, getColumnSelectionAllowed, getDefaultEditor, getDefaultRenderer, getDragEnabled, getDropLocation, getDropMode, getEditingColumn, getEditingRow, getEditorComponent, getFillsViewportHeight, getGridColor, getIntercellSpacing, getModel, getPreferredScrollableViewportSize, getPrintable, getRowCount, getRowHeight, getRowHeight, getRowMargin, getRowSelectionAllowed, getRowSorter, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getSelectedColumn, getSelectedColumnCount, getSelectedColumns, getSelectedRow, getSelectedRowCount, getSelectedRows, getSelectionBackground, getSelectionForeground, getSelectionModel, getShowHorizontalLines, getShowVerticalLines, getSurrendersFocusOnKeystroke, getTableHeader, getUI, getUIClassID, getUpdateSelectionOnSort, getValueAt, initializeLocalVars, isCellEditable, isCellSelected, isColumnSelected, isEditing, isRowSelected, moveColumn, paramString, prepareEditor, prepareRenderer, print, print, print, print, print, processKeyBinding, removeColumn, removeColumnSelectionInterval, removeEditor, removeNotify, removeRowSelectionInterval, resizeAndRepaint, rowAtPoint, selectAll, setAutoCreateColumnsFromModel, setAutoCreateRowSorter, setAutoResizeMode, setCellSelectionEnabled, setColumnModel, setColumnSelectionAllowed, setColumnSelectionInterval, setDefaultEditor, setDefaultRenderer, setDragEnabled, setDropMode, setEditingColumn, setEditingRow, setFillsViewportHeight, setGridColor, setIntercellSpacing, setModel, setPreferredScrollableViewportSize, setRowMargin, setRowSelectionAllowed, setRowSelectionInterval, setRowSorter, setSelectionBackground, setSelectionForeground, setSelectionMode, setSelectionModel, setShowGrid, setShowHorizontalLines, setShowVerticalLines, setSurrendersFocusOnKeystroke, setTableHeader, setUI, setUpdateSelectionOnSort, setValueAt, sizeColumnsToFit, sizeColumnsToFit, sorterChanged, unconfigureEnclosingScrollPane, updateUI, valueChanged

Methods inherited from class javax.swing.JComponent

addAncestorListener, 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, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, 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, 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

Methods inherited from interface org.autogui.swing.GuiSwingView.ValuePane

addSwingEditFinishHandler, asSwingViewComponent, executeContextTask, getActionByContext, getActionByName, getChildByName, getDescendantActionByContext, getDescendantByContext, getDescendantByValue, getDescendantByValueIf, getPrefsJsonSupported, getSwingFocusKeyStroke, isSwingCurrentValueSupported, isSwingEditable, loadSwingPreferences, refreshByContext, requestSwingViewFocus, setPrefsJsonSupported, setSwingViewHistoryValue, setSwingViewValueForTable, wrapSwingNamed, wrapSwingPane, wrapSwingProperty, wrapSwingScrollPane

Field Details

context

protected GuiMappingContext context

specifierManager

protected GuiSwingView.SpecifierManager specifierManager

source

protected List<?> source

popup

protected GuiSwingViewCollectionTable.PopupExtensionCollection popup

menuItems

protected List<PopupCategorized.CategorizedMenuItem> menuItems

actions

protected List<Action> actions

autoSelectionActions

protected List<GuiSwingTableColumnSetDefault.TableSelectionListAction> autoSelectionActions

autoSelectionDepth

protected int autoSelectionDepth

selectionRunner

protected volatile EditingRunner selectionRunner

preferencesUpdater

protected GuiSwingViewCollectionTable.TablePreferencesUpdater preferencesUpdater

lastSelectionActionIndices

protected List<Integer> lastSelectionActionIndices

selectionSourceForRowIndices

protected GuiSwingViewCollectionTable.TableSelectionSourceForIndices selectionSourceForRowIndices

selectionSourceForRowAndColumnIndices

protected GuiSwingViewCollectionTable.TableSelectionSourceForIndices selectionSourceForRowAndColumnIndices

popupColumnHeader

protected GuiSwingViewCollectionTable.PopupExtensionCollectionColumnHeader popupColumnHeader

columnHeaderMenuItems

protected List<PopupCategorized.CategorizedMenuItem> columnHeaderMenuItems

infoLabel

protected MenuBuilder.MenuLabel infoLabel

actionToolBar

protected JToolBar actionToolBar

viewClock

protected GuiTaskClock viewClock

settingsWindow

protected SettingsWindow settingsWindow

customHighlighting

protected boolean customHighlighting

customRowHeightByUser

protected boolean customRowHeightByUser

Since:

1.3

rowHeightByProgram

protected int rowHeightByProgram

Since:

1.3

customRowHeightIndividual

protected boolean customRowHeightIndividual

some row-height is customized by setRowHeight(int, int). cleared by setRowHeight(int)

Since:

1.6

rowHeightSetAction

protected GuiSwingViewCollectionTable.RowHeightSetAction rowHeightSetAction

Since:

1.6

Constructor Details

CollectionTable

public CollectionTable(GuiMappingContext context,
 GuiSwingView.SpecifierManager specifierManager)

Method Details

init

public void init()

initColor

public void initColor()

initName

public void initName()

initModel

public void initModel()

initContextUpdate

public void initContextUpdate()

initPopup

public void initPopup()

initGrid

public void initGrid()

initSelection

public void initSelection()

initSelectionSource

public void initSelectionSource()

initSelectionClear

public void initSelectionClear()

initRowHeight

public void initRowHeight()

initRowHeightDefault

protected void initRowHeightDefault()

set initial row-height settings from GuiInits; reusing setting methods of GuiSwingViewCollectionTable.PreferencesForTable

Since:

1.8

getInits

protected GuiInits getInits()

Returns:

GuiInits attached to the (parent) table property context, or default

Since:

1.8

initValue

public void initValue()

initPreferencesUpdater

public void initPreferencesUpdater()

initDragDrop

public void initDragDrop()

initFocus

public void initFocus()

initAfter

public void initAfter()

getSwingStaticMenuItems

public List<PopupCategorized.CategorizedMenuItem> getSwingStaticMenuItems()

Description copied from interface: GuiSwingView.ValuePane

a typical implementation becomes like the following code:

      if (menuItems == null) { menuItems = PopupCategorized.getMenuItems(actions, menus); }
      return menuItems;
  

the method returns original menu items for the pane. so, if a wrapper pane has a wrapped sub-pane added as a child component, it should not include items of the wrapped sub-pane.

Specified by:

getSwingStaticMenuItems in interface GuiSwingView.ValuePane<List<?>>

Returns:

a list of actions (or menu-components) statically determined, that should be always same instances

getPopup

public GuiSwingViewCollectionTable.PopupExtensionCollection getPopup()

setupAfterAddingColumns

public JComponent setupAfterAddingColumns(List<Action> actions)

setupAfterAddingColumns

public void setupAfterAddingColumns()

setup related components for the table and actions

Since:

1.1

initTableScrollPane

public GuiSwingViewWrapper.ValueScrollPane<?> initTableScrollPane()

initTableScrollPane

public void initTableScrollPane(JScrollPane scrollPane)

isAutoResizeOff

protected boolean isAutoResizeOff()

initActionToolBar

public JToolBar initActionToolBar(List<Action> actions)

runListSelection

public void runListSelection(ListSelectionEvent e)

runAutoSelectionActions

public void runAutoSelectionActions(List<Object> es)

initAction

public void initAction(JToolBar actionToolBar,
 Action action)

setSettingsWindow

public void setSettingsWindow(SettingsWindow settingsWindow)

Description copied from interface: GuiSwingView.SettingsWindowClient

at initialization of the root-pane, the method will be called for existing sub-panes. a dynamically created view needs to be manually set by those panes.

Specified by:

setSettingsWindow in interface GuiSwingView.SettingsWindowClient

Parameters:

settingsWindow - a settings-window from the root-pane, which will be disposed at closing of the main window

getSettingsWindow

public SettingsWindow getSettingsWindow()

Specified by:

getSettingsWindow in interface GuiSwingView.SettingsWindowClient

getActions

public List<Action> getActions()

getSwingMenuBuilder

public PopupExtension.PopupMenuBuilder getSwingMenuBuilder()

Description copied from interface: GuiSwingView.ValuePane

a typical implementation if there are no dynamic items becomes like the following code:

     if (popup == null) { popup = new PopupExtension(this,
                                    new PopupCategorized(this::getSwingStaticMenuItems)); }
     return popup.getMenuBuilder();
 

Specified by:

getSwingMenuBuilder in interface GuiSwingView.ValuePane<List<?>>

Returns:

a menu builder

getObjectTableModel

public GuiSwingTableModelCollection getObjectTableModel()

getSource

public List<?> getSource()

getSelectionSourceForRowAndColumnIndices

public GuiSwingViewCollectionTable.TableSelectionSourceForIndices getSelectionSourceForRowAndColumnIndices()

getSelectionSourceForRowIndices

public GuiSwingViewCollectionTable.TableSelectionSourceForIndices getSelectionSourceForRowIndices()

update

public void update(GuiMappingContext cause,
 Object newValue,
 GuiTaskClock contextClock)

Specified by:

update in interface GuiMappingContext.SourceUpdateListener

getSwingViewValue

public List<?> getSwingViewValue()

Specified by:

getSwingViewValue in interface GuiSwingView.ValuePane<List<?>>

Returns:

basically, the source value of the context, held by the component without touching the context.

setSwingViewValue

public void setSwingViewValue(List<?> value)

Description copied from interface: GuiSwingView.ValuePane

update GUI display, and it does NOT update the target model value. processed under the event thread. also increment the view-clock.

Specified by:

setSwingViewValue in interface GuiSwingView.ValuePane<List<?>>

Parameters:

value - the new value

setSwingViewValueWithUpdate

public void setSwingViewValueWithUpdate(List<?> value)

Description copied from interface: GuiSwingView.ValuePane

update the GUI display and the model. processed under the event thread. also increment the view-clock

Specified by:

setSwingViewValueWithUpdate in interface GuiSwingView.ValuePane<List<?>>

Parameters:

value - the new value

setSwingViewValue

public void setSwingViewValue(List<?> value,
 GuiTaskClock clock)

Description copied from interface: GuiSwingView.ValuePane

update if the clock is newer than the current view-clock of the pane. the view-clock becomes the given clock. Note: instead, GuiSwingView.ValuePane.setSwingViewValue(Object) increments the current clock

Specified by:

setSwingViewValue in interface GuiSwingView.ValuePane<List<?>>

Parameters:

value - the new value

clock - the clock of the value: if the clock is newer than the current view-clock of the pane, it can update

setSwingViewValueWithUpdate

public void setSwingViewValueWithUpdate(List<?> value,
 GuiTaskClock clock)

Description copied from interface: GuiSwingView.ValuePane

update the GUI display and the model if the clock is newer than the current view-clock of the pane. the view-clock becomes the given clock.

Specified by:

setSwingViewValueWithUpdate in interface GuiSwingView.ValuePane<List<?>>

Parameters:

value - the new value

clock - the clock of the value

updateFromGui

public void updateFromGui(Object v,
 GuiTaskClock viewClock)

setPreferencesUpdater

public void setPreferencesUpdater(Consumer<GuiSwingPrefsSupports.PreferencesUpdateEvent> updater)

Specified by:

setPreferencesUpdater in interface GuiSwingPrefsSupports.PreferencesUpdateSupport

shutdownSwingView

public void shutdownSwingView()

Description copied from interface: GuiSwingView.ValuePane

for each component, at the end of the process, this method will be called

Specified by:

shutdownSwingView in interface GuiSwingView.ValuePane<List<?>>

prepareForRefresh

public void prepareForRefresh()

Description copied from interface: GuiSwingView.ValuePane

for each component, the method is called before refreshing in order to clear the view-clock.

Specified by:

prepareForRefresh in interface GuiSwingView.ValuePane<List<?>>

getActionToolBar

public JToolBar getActionToolBar()

getTargetName

public String getTargetName()

Specified by:

getTargetName in interface GuiSwingTableColumnSet.TableSelectionSource

isSelectionEmpty

public boolean isSelectionEmpty()

Specified by:

isSelectionEmpty in interface GuiSwingTableColumnSet.TableSelectionSource

getSelectedItems

public List<?> getSelectedItems()

Specified by:

getSelectedItems in interface GuiSwingTableColumnSet.TableSelectionSource

selectionActionFinished

public void selectionActionFinished(boolean autoSelection,
 GuiSwingTableColumnSet.TableSelectionChange change)

Description copied from interface: GuiSwingTableColumnSet.TableSelectionSource

the finisher for the action: the table implements the method in order to refresh selected rows. However, naive executions of the action by list selection changes will cause infinite loop. To avoid this, an impl. of the method needs to check the flag and avoid handling list selection events caused by the method.

Specified by:

selectionActionFinished in interface GuiSwingTableColumnSet.TableSelectionSource

Parameters:

autoSelection - true if the action is automatically executed by selection changes

change - specification of selection changes

changeSelection

public void changeSelection(int[] selectedModelRowsIndices,
 GuiSwingTableColumnSet.TableSelectionChange change)

changeSelectionNothing

public void changeSelectionNothing(int[] selectedModelRowsIndices,
 GuiSwingTableColumnSet.TableSelectionChange change)

changeSelectionIndices

public void changeSelectionIndices(int[] selectedModelRowsIndices,
 GuiSwingTableColumnSet.TableSelectionChangeIndices change)

changeSelectionValues

public void changeSelectionValues(int[] selectedModelRowsIndices,
 GuiSwingTableColumnSet.TableSelectionChangeValues change)

changeSelectionIndicesRowAndColumns

public void changeSelectionIndicesRowAndColumns(int[] selectedModelRowsIndices,
 GuiSwingTableColumnSet.TableSelectionChangeIndicesRowAndColumn change)

getSwingViewContext

public GuiMappingContext getSwingViewContext()

Specified by:

getSwingViewContext in interface GuiSwingView.ValuePane<List<?>>

loadSwingPreferences

public void loadSwingPreferences(GuiPreferences prefs,
 GuiSwingPrefsApplyOptions options)

Description copied from interface: GuiSwingView.ValuePane

a sub-class which wraps another value-pane should overrides the method in order to omit needless value setting. it can use GuiSwingView.loadPreferencesDefault(JComponent, GuiPreferences)

Specified by:

loadSwingPreferences in interface GuiSwingView.ValuePane<List<?>>

Parameters:

prefs - target prefs or ancestor of the target; actual target can be obtained by GuiPreferences.getDescendant(GuiMappingContext)

options - options for applying

saveSwingPreferences

public void saveSwingPreferences(GuiPreferences prefs)

Description copied from interface: GuiSwingView.ValuePane

only save the component itself, not including children. it can use GuiSwingView.savePreferencesDefault(JComponent, GuiPreferences)

Specified by:

saveSwingPreferences in interface GuiSwingView.ValuePane<List<?>>

Parameters:

prefs - target prefs or ancestor of the target; actual target can be obtained by GuiPreferences.getDescendant(GuiMappingContext)

paintComponent

protected void paintComponent(Graphics g)

Overrides:

paintComponent in class JComponent

paintSelectedRows

protected void paintSelectedRows(Graphics2D g2)

getSpecifier

public GuiReprValue.ObjectSpecifier getSpecifier()

Specified by:

getSpecifier in interface GuiSwingView.ValuePane<List<?>>

Returns:

the specifier for the context value, typically obtained from GuiSwingView.SpecifierManager

getRowSpecifier

public GuiSwingTableColumn.SpecifierManagerIndex getRowSpecifier()

setKeyStrokeString

public void setKeyStrokeString(String keyStrokeString)

Description copied from interface: GuiSwingView.ValuePane

set the key-stroke info. to the pane as a guide

Specified by:

setKeyStrokeString in interface GuiSwingView.ValuePane<List<?>>

Parameters:

keyStrokeString - the key stroke info to be set.

getColumnHeaderMenuItems

public List<PopupCategorized.CategorizedMenuItem> getColumnHeaderMenuItems()

convertColumnIndexToView

public int convertColumnIndexToView(int modelColumnIndex)

Overrides:

convertColumnIndexToView in class JTable

updateSwingViewSource

public void updateSwingViewSource()

update by context and refresh by ObjectTableModel.refreshData()

Specified by:

updateSwingViewSource in interface GuiSwingView.ValuePane<List<?>>

Since:

1.1

updateSwingViewSourceFromRoot

public void updateSwingViewSourceFromRoot()

update by context and refresh by ObjectTableModel.refreshData()

Specified by:

updateSwingViewSourceFromRoot in interface GuiSwingView.ValuePane<List<?>>

Since:

1.1

setCellEditor

public void setCellEditor(TableCellEditor anEditor)

Overrides:

setCellEditor in class JTable

selectionActionPrepare

public void selectionActionPrepare()

Description copied from interface: GuiSwingTableColumnSet.TableSelectionSource

the preparation for the action: the table stops editing

Specified by:

selectionActionPrepare in interface GuiSwingTableColumnSet.TableSelectionSource

setRowHeight

public void setRowHeight(int rowHeight)

Overrides:

setRowHeight in class JTable

setRowHeightByUser

public void setRowHeightByUser(int rowHeight)

setting the custom row-height

Parameters:

rowHeight - the new row-height

Since:

1.3

setRowHeight

public void setRowHeight(int row,
 int rowHeight)

Overrides:

setRowHeight in class JTable

hasCustomRowHeightByUser

public boolean hasCustomRowHeightByUser()

Returns:

true if it has the value set by setRowHeightByUser(int)

Since:

1.3

getRowHeightByProgram

public int getRowHeightByProgram()

Returns:

the last row-height set by setRowHeight(int)

Since:

1.3

getToolTipText

public String getToolTipText(MouseEvent event)

Overrides:

getToolTipText in class JTable

createDefaultTableHeader

protected JTableHeader createDefaultTableHeader()

Overrides:

createDefaultTableHeader in class JTable

tableChanged

public void tableChanged(TableModelEvent e)

overrides for preserving custom-row-heights if e is a total refreshing: If TableModelEvent.getLastRow() is Integer.MAX_VALUE, it indicates updating of all rows. Then, the default impl. of JTable clears custom all-row-heights set by setRowHeight(int, int). This causes unintended row-heights expansion by re-painting after the method. So, the overriding impl. saves before super call, and resets the saved values before re-painting.

Specified by:

tableChanged in interface TableModelListener

Overrides:

tableChanged in class JTable

Parameters:

e - a model-event

getRowHeightSetAction

public GuiSwingViewCollectionTable.RowHeightSetAction getRowHeightSetAction()

obtains an object for row-height customizing

Returns:

the action instance associated to the table

Since:

1.6