borland Packages  Class Hierarchy  jbcl.control Package  Index 

PickListItemEditor component

java.lang.Object
   +----java.awt.Component
           +----java.awt.Container
                   +----java.awt.Panel
                           +----borland.jbcl.control.PickListItemEditor

About the PickListItemEditor component

Variables  Constructors  Properties  Methods  Event Listeners

Implements ItemEditor, BlackBox, ItemListener, KeyListener, ImageObserver, MenuContainer, Serializable, EventListener

The PickListItemEditor is a custom JBCL model-view ItemEditor that is specifically designed for use with DataSet column components. It is the default ItemEditor for a column on which a PickListDescriptor property has been set (through the UI Designer).

When editing a control that is attached to a Column with a PickListDescriptor, the user is presented with a drop-down list of values from a single display column of a "picklist" data set from which to make a selection. When a user makes a selection, the PickListItemEditor copies one or more column values from a row of the "picklist" data set into columns of the data set being edited.

For example, a PickListDescriptor has been specified for the Customer_ID column of the Orders data set. It specifies that the "picklist" data set is the Customer data set, the display column is the Last_Name field, and that the Customer_ID and Phone_Number columns from the Customer data set should be copied into the Customer_ID and Contact_Phone columns of the Orders data set. When the user edits the control containing the Customer_ID column, a drop-down list of last names from the Customer data set is presented in a ChoiceControl, from which the user can make a selection. If the user selects a last name, the Customer_ID and Phone_Number values for that customer are copied into the Customer_ID and Contact_Phone columns, respectively, of the Orders data set.

The PickListItemEditor is only able to display values from a single column of the "picklist" data set. To display values from multiple columns of a data set, assign the PopupPickListItemEditor as the itemEditor for the Column. The PickListItemEditor does not make use of the enforceIntegrity property of the PickListDescriptor.


PickListItemEditor variables

Variables implemented in java.awt.Component

PickListItemEditor constructors

PickListItemEditor properties

*Read-only properties **Write-only properties

Properties implemented in this class

Properties implemented in java.awt.Component

Properties implemented in java.awt.Container

Properties implemented in java.lang.Object

PickListItemEditor methods

Methods implemented in this class

Methods implemented in java.awt.Component

Methods implemented in java.awt.Container

Methods implemented in java.awt.Panel

Methods implemented in java.lang.Object

PickListItemEditor event listeners


PickListItemEditor constructors

PickListItemEditor()

  public PickListItemEditor()
Creates a PickListItemEditor.

PickListItemEditor properties

cachePickList

 public final boolean isCachePickList()
 public final void setCachePickList(boolean cache)
Determines whether or not values from the display ("picklist") DataSet are cached. If the column of display items to choose from is subject to frequent change, setting this property to false ensures that the most recent list of choices is displayed when the PickListItemEditor is invoked. For performance reasons, this property is true by default.

component

 public Component getComponent()
Read-only property that returns this instance of a PickListItemEditor as a Component.

value

 public Object getValue()
Read-only property that copies the PickList columns of the user-selected row to the corresponding destination columns.

PickListItemEditor methods

loadPickList(borland.jbcl.dataset.PickListDescriptor)

  protected void loadPickList(borland.jbcl.dataset.PickListDescriptor pickList)
This method is called when a user begins editing a control associated with this PickListItemEditor It has the side effect of extracting the pickListDescriptor information into class variables.

PickListItemEditor event listeners

This component is a source for the following event sets. For information on the standard AWT event sets, see Standard Java events. For information on the JBCL event sets, see Events in JBCL.

component

 public synchronized void addComponentListener(java.awt.event.ComponentListener )
 public synchronized void removeComponentListener(java.awt.event.ComponentListener )

container

 public synchronized void addContainerListener(java.awt.event.ContainerListener )
 public void removeContainerListener(java.awt.event.ContainerListener )

focus

 public void addFocusListener(java.awt.event.FocusListener l)
 public void removeFocusListener(java.awt.event.FocusListener l)

key

 public void addKeyListener(java.awt.event.KeyListener l)
 public void removeKeyListener(java.awt.event.KeyListener l)

mouse

 public synchronized void addMouseListener(java.awt.event.MouseListener )
 public synchronized void removeMouseListener(java.awt.event.MouseListener )

mouseMotion

 public synchronized void addMouseMotionListener(java.awt.event.MouseMotionListener )
 public synchronized void removeMouseMotionListener(java.awt.event.MouseMotionListener )

rowFilter

 public final void addRowFilterListener(borland.jbcl.dataset.RowFilterListener listener)
 public final void removeRowFilterListener(borland.jbcl.dataset.RowFilterListener listener)