com.klg.jclass.field.db.datasource
Class DSdbSpinField

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--com.klg.jclass.util.swing.AbstractSpinBox
                          |
                          +--com.klg.jclass.field.JCSpinField
                                |
                                +--com.klg.jclass.field.db.datasource.DSdbSpinField

All Implemented Interfaces:

ImageObserver, JCFieldComponent, MenuContainer, Serializable

public class DSdbSpinField

extends JCSpinField

This component is a data-bound spin field. A spin field enables end-users to cycle through a range of values.

The field displays the value at one column of the current record. The data type is set when the field is bound to a data source.

Behavior

• Input can be checked to ensure that it is within a range of values.
• The items in the spin field may be strings, in which case they are associated with integral values internally.
• The spin increment can be set to non-integral values.
• Default and custom display formats are possible.
• Audible and visual warnings may be given upon receipt of invalid entries.
• Various display and edit formats are possible, as well as locale-specific formats.
• Items may be matched against a pick list.
• Some characters may be chosen as invalid thereby preventing their use.
• Alternatively, a presumably shorter list of valid characters may be specified.

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class com.klg.jclass.util.swing.AbstractSpinBox

AbstractSpinBox.ArrowButton, AbstractSpinBox.MetalArrowButton, AbstractSpinBox.MetalBorder

Nested classes inherited from class javax.swing.JComponent

JComponent.AccessibleJComponent

Nested classes inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

protected com.klg.jclass.field.db.datasource.DataSourceValueModel

vm

Fields inherited from class com.klg.jclass.field.JCSpinField

field, required, text, version

Fields inherited from class com.klg.jclass.util.swing.AbstractSpinBox

arrowKeySpinningAllowed, buttonTimer, continuousScroll, currentButton, DECREMENT, downArrow, editable, editor, editorIsValidateRoot, INCREMENT, l, metalBorder, minimumHeight, NONE, renderer, renderPanel, rl, upArrow, userFont, valueListeners, valueModel

Fields inherited from class javax.swing.JComponent

accessibleContext, 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

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface com.klg.jclass.field.JCFieldComponent

INVALID, UNDEREDIT, VALID

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

DSdbSpinField()
Creates a DSdbSpinField which can be bound to a data source.

Method Summary

String	getDataBinding() Returns the field's value of the dataBinding object property.
void	setDataBinding(com.klg.jclass.datasource.BindingModel binding, String column_name) Binds using a Binding.
void	setDataBinding(com.klg.jclass.datasource.DataModel data_model, com.klg.jclass.datasource.MetaDataModel meta_data_model, String column_name) Sets the parameters for binding the component to a particular column in a MetaDataModel.
void	setDataBinding(String data_binding) Sets the data binding hierarchy string, starting from a JCTreeData instance name and containing full sequence of MetaDataModel levels starting from the root to the level the table is bound with.

Methods inherited from class com.klg.jclass.field.JCSpinField

addNotify, addPropertyChangeListener, addValueListener, checkArrowButtons, commitEdit, createField, doSpin, getAbout, getDataProperties, getInvalidInfo, getSelectOnEnter, getState, getValidator, getValue, getValueModel, isRequired, preferredHeightOfView, processFocusLost, removePropertyChangeListener, removeValueListener, setAbout, setBackground, setDataProperties, setEditable, setForeground, setInvalidInfo, setLocale, setRequired, setSelectOnEnter, setValidator, setValue, setValueModel, spinDown, spinUp

Methods inherited from class com.klg.jclass.util.swing.AbstractSpinBox

compareToValue, configureArrowButtons, createDecrArrow, createIncrArrow, doBorder, doFocusedLook, doLayout, doNonFocusedLook, getDecrementArrow, getEditor, getIncrementArrow, getPreferredSize, getRenderer, handleKeyPressed, isArrowKeySpinningAllowed, isContinuousScroll, isEditable, isEnabled, isFocusTraversable, paint, preferredWidthOfView, processValueChanged, processValueChanging, requestFocus, setArrowEnabled, setArrowKeySpinningAllowed, setContinuousScroll, setEditor, setEnabled, setFont, setLayout, setRenderer, setUI, swapEditorRenderer, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, paramString, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, transferFocusBackward, 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, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isFocusable, isFocusOwner, isFontSet, isForegroundSet, isLightweight, 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, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

vm

protected com.klg.jclass.field.db.datasource.DataSourceValueModel vm

Constructor Detail

DSdbSpinField

public DSdbSpinField()

Creates a DSdbSpinField which can be bound to a data source.

Method Detail

getDataBinding

public String getDataBinding()

Returns the field's value of the dataBinding object property. The dataBinding property specifies a string, describing a JCTreeData instance and meta data level of the instance this table is bound with. The format of the property is as follows:

 <JCTreeData name>:<MetaDataModel description>[|<MetaDataModel description>...]
 

See Also:

DSdbComboField.setDataBinding(java.lang.String), TreeData, MetaDataModel

setDataBinding

public void setDataBinding(String data_binding)

Sets the data binding hierarchy string, starting from a JCTreeData instance name and containing full sequence of MetaDataModel levels starting from the root to the level the table is bound with.

See Also:

NodeProperties.setDataSource(java.lang.Object), DSdbComboField.setDataBinding(java.lang.String)

setDataBinding

public void setDataBinding(com.klg.jclass.datasource.DataModel data_model,
                           com.klg.jclass.datasource.MetaDataModel meta_data_model,
                           String column_name)

Sets the parameters for binding the component to a particular column in a MetaDataModel. If the MetaDataModel is the root in the DataModel's MetaDataTree, the DataTableModel is automatically set to the root DataTableModel, otherwise, the DataTableModel is set when an appropriate table becomes available.

setDataBinding

public void setDataBinding(com.klg.jclass.datasource.BindingModel binding,
                           String column_name)

Binds using a Binding.