S-PLUS Connect/Java v1.0

com.insightful.splus
Class SplusDataSetComboBox

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by javax.swing.JComponent
              extended by com.insightful.controls.SplusLabelBox
                  extended by com.insightful.controls.SplusComboBox
                      extended by com.insightful.splus.SplusDataSetComboBox
All Implemented Interfaces:
SplusControlMethods, SplusDataColumnListProvider, ImageObserver, MenuContainer, Serializable

public class SplusDataSetComboBox
extends SplusComboBox
implements SplusDataColumnListProvider

Combo box listing S-PLUS data sets. Queries the S-PLUS engine for a list of objects extending data.frame. Keeps a list of the columns in the selected data.frame, and updates this list when the selection changes. Updates the option lists of registered SplusDataColumnComboBox and SplusDataColumnListBox objects when the column list changes.

See Also:
Serialized Form

Nested Class Summary
 
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.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
 
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 java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
SplusDataSetComboBox()
          Create a combo box labeled "Data Set".
SplusDataSetComboBox(String text)
          Create a combo box with the specified label.
SplusDataSetComboBox(String text, char mnemonic)
          Create a combo box with the specified label and mnemonic.
SplusDataSetComboBox(String text, int mnemonic)
          Create a combo box with the specified label and mnemonic.
 
Method Summary
 String[] getColumnList()
          Get the stashed column names for the current data set.
static String getCurrentDataSet()
          Get the "current data set".
static String[] getDataSetList()
          Get the names of all objects inheriting from data.frame in the first S-PLUS database.
 void registerColumnControl(SplusControlMethods control)
          Register a control whose option list should be the column names of the data set selected in this combo box.
static void updateDataSetList()
          Query the engine to refresh the list of data.frames.
 
Methods inherited from class com.insightful.controls.SplusComboBox
addActionListener, addItemListener, getActionCommand, getAppend, getOptionList, getPrepend, getSelectedIndex, getValue, isEditable, isEnabled, setActionCommand, setAppend, setEditable, setEnabled, setOptionList, setPrepend, setSelectedIndex, setValue
 
Methods inherited from class com.insightful.controls.SplusLabelBox
getMnemonic, getText, setActionControl, setLabelEnabled, setLabelFor, setMnemonic, setMnemonic, setText
 
Methods inherited from class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getAccessibleContext, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, 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, getToolTipText, getTopLevelAncestor, getTransferHandler, getUIClassID, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, 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, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, 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, 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, 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, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, 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, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.insightful.controls.SplusControlMethods
getMnemonic, getText, setMnemonic, setMnemonic, setText
 

Constructor Detail

SplusDataSetComboBox

public SplusDataSetComboBox()
Create a combo box labeled "Data Set".


SplusDataSetComboBox

public SplusDataSetComboBox(String text,
                            char mnemonic)
Create a combo box with the specified label and mnemonic.


SplusDataSetComboBox

public SplusDataSetComboBox(String text,
                            int mnemonic)
Create a combo box with the specified label and mnemonic.


SplusDataSetComboBox

public SplusDataSetComboBox(String text)
Create a combo box with the specified label.

Method Detail

getCurrentDataSet

public static final String getCurrentDataSet()
Get the "current data set". This method is here as a stub in case support is added for selecting a current data set which will be used as the default value for the combo box. Currently this always returns "".


getDataSetList

public static final String[] getDataSetList()
Get the names of all objects inheriting from data.frame in the first S-PLUS database.


updateDataSetList

public static final void updateDataSetList()
Query the engine to refresh the list of data.frames.


getColumnList

public String[] getColumnList()
Get the stashed column names for the current data set.

Specified by:
getColumnList in interface SplusDataColumnListProvider

registerColumnControl

public void registerColumnControl(SplusControlMethods control)
Register a control whose option list should be the column names of the data set selected in this combo box.

We maintain a Vector of SplusDataColumnListBox and similar controls registered as corresponding to this SplusDataSetComboBox. When the data set is changed we call setOptionList() for these controls to reflect the set of columns in the new data set.

This mechanism is used rather than just having the other controls be listeners so that we can obtain the list of column names once and reliably update this.columnList before telling the controls to refresh their option lists.

Specified by:
registerColumnControl in interface SplusDataColumnListProvider

S-PLUS Connect/Java v1.0

Copyright © 2000, 2002 Insightful Corporation
Warning: Classes not documented in the S-PLUS Programmer's Guide may change in future releases.