borland Packages  Class Hierarchy  dbswing Package 

JdbTree component

java.lang.Object
   +----java.awt.Component
           +----java.awt.Container
                   +----javax.swing.JComponent
                           +----javax.swing.JTree
                                   +----com.borland.dbswing.JdbTree

About the JdbTree component

Variables  Constructors  Properties  Methods  Event Listeners

Implements DBDataBinder, ColumnAware, DataSetAware, ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

Note: This is a feature of JBuilder Professional and Enterprise.

JdbTree is a data-aware extension of the JTree component. It displays a tree of choices from which a user may choose a single value. The selected value can be written to a Column of a DataSet, and it can be retrieved using the standard Swing TreeSelectionModel methods. When JdbTree is bound to a DataSet and DataSet Column, the currently selected choice always reflects the value of the corresponding Column in the current DataSet row.

JdbTree uses a DBTreeDataBinder to bind a tree to a DataSet and make JdbTree data-aware.

To fill the tree presented by JdbTree, choose one of these:

By default, JdbTree sets its selection mode to TreeSelectionModel.SINGLE_TREE_SELECTION because only a single tree selection can be copied to its DataSet target. Even if the selection mode is changed to allow the selection of multiple items simultaneously, only the first item of the selection group is copied to the DataSet.

See also: DBTreeDataBinder, JdbNavTree


JdbTree variables

Variables implemented in this class

Variables implemented in java.awt.Component

Variables implemented in javax.swing.JComponent

Variables implemented in javax.swing.JTree

JdbTree constructors

JdbTree 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

Properties implemented in javax.swing.JComponent

Properties implemented in javax.swing.JTree

JdbTree methods

Methods implemented in this class

Methods implemented in java.awt.Component

Methods implemented in java.awt.Container

Methods implemented in java.lang.Object

Methods implemented in javax.swing.JComponent

Methods implemented in javax.swing.JTree

JdbTree event listeners


JdbTree variables

dataBinder

  protected DBTreeDataBinder dataBinder
The DBTreeDataBinder that makes this a data-aware component.

JdbTree constructors

JdbTree()

  public JdbTree()
Creates a JdbTree component by calling the constructor of this class that takes an array of Objects and passing it a newly instantiated empty array.

JdbTree(java.lang.Object[])

  public JdbTree(Object[] value)
Creates a JdbTree component that is populated with an array of Objects by calling the constructor of its superclass and passing the specified array.

Parameters:

value
The array of Objects that become nodes of the tree.

JdbTree(java.util.Hashtable)

  public JdbTree(Hashtable value)
Creates a JdbTree component by calling the constructor of its superclass, passing it the specified Hashtable.

Parameters:

value
The Hashtable with the values that become the nodes of the tree.

JdbTree(java.util.Vector)

  public JdbTree(Vector value)
Creates a JdbTree component by calling the constructor of its superclass and passing it the specified Vector.

Parameters:

value
The Vector that contains the values that become the nodes of the tree.

JdbTree(javax.swing.tree.TreeModel)

  public JdbTree(TreeModel treeModel)
Creates a JdbTree component by calling the constructor of its superclass and passing it the specified TreeModel.

Parameters:

treeModel
The TreeModel that contains the values that become the nodes of the tree.

JdbTree(javax.swing.tree.TreeNode)

  public JdbTree(TreeNode root)
Creates a JdbTree component by calling the constructor of its superclass and passing it the specified TreeNode.

Parameters:

root
The TreeNode that becomes the first or root node of the tree.

JdbTree(javax.swing.tree.TreeNode, boolean)

  public JdbTree(TreeNode root, boolean asksAllowsChildren)
Creates a JdbTree component that is populated with a TreeNode. Calls the constructor of this class that takes a TreeModel as a parameter, passing it a newly instantiated model using the specified root node and asksAllowsChildren value.

Parameters:

root
The TreeNode that becomes the first or root node of the tree.
asksAllowsChildren
Determines whether the tree can have child nodes.

JdbTree properties

columnName

 public String getColumnName()
 public void setColumnName(String columnName)
Returns and sets the column name of the DataSet to which the JdbTree is bound.

See also: dataSet

dataSet

 public DataSet getDataSet()
 public void setDataSet(DataSet dataSet)
Returns and sets the DataSet to which the JdbTree is bound.

See also: columnName

unknownDataValueMode

 public int getUnknownDataValueMode()
 public void setUnknownDataValueMode(int mode)
Returns and sets the policy for setting the tree state when synchronizing a tree with its DataSet value when the value doesn't match either of the selectedDataValue or unselectedDataValue property values. These are the values used for the mode parameter:

See also: DBTreeDataBinder

useLeafNodesOnly

 public boolean isUseLeafNodesOnly()
 public void setUseLeafNodesOnly(boolean useLeafNodesOnly)
Returns whether to ignore internal node values during selection changes and when locating nodes by value. Sets whether to ignore internal node values during selection changes and when locating nodes by value.

JdbTree methods

commonInit()

  protected void commonInit()
Used to initialize JdbTree with the same defaults, regardless of the constructor used.

JdbTree event listeners

This component is a source for the following event sets.

ancestor

 public void addAncestorListener(javax.swing.event.AncestorListener )
 public void removeAncestorListener(javax.swing.event.AncestorListener )

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 synchronized void removeContainerListener(java.awt.event.ContainerListener )

focus

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

inputMethod

 public synchronized void addInputMethodListener(java.awt.event.InputMethodListener )
 public synchronized void removeInputMethodListener(java.awt.event.InputMethodListener )

key

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

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 )

propertyChange

 public synchronized void addPropertyChangeListener(java.beans.PropertyChangeListener )
 public synchronized void removePropertyChangeListener(java.beans.PropertyChangeListener )

treeExpansion

 public void addTreeExpansionListener(javax.swing.event.TreeExpansionListener )
 public void removeTreeExpansionListener(javax.swing.event.TreeExpansionListener )

treeSelection

 public void addTreeSelectionListener(javax.swing.event.TreeSelectionListener )
 public void removeTreeSelectionListener(javax.swing.event.TreeSelectionListener )

treeWillExpand

 public void addTreeWillExpandListener(javax.swing.event.TreeWillExpandListener )
 public void removeTreeWillExpandListener(javax.swing.event.TreeWillExpandListener )

vetoableChange

 public synchronized void addVetoableChangeListener(java.beans.VetoableChangeListener )
 public synchronized void removeVetoableChangeListener(java.beans.VetoableChangeListener )