borland.jbcl Packages  borland.jbcl Class Hierarchy  borland.jbcl.control 

StatusBar component

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

About the StatusBar component

Variables  Constructors  Properties  Methods  Event Listeners

Implements AccessListener, NavigationListener, StatusListener, BlackBox, MenuContainer, ImageObserver, Serializable, EventListener

The StatusBar control is a container for a java.awt.Label and displays custom messages as well as status messages generated by its associated DataSet. Status messages generated from the DataSet include:

The main properties of the StatusBar are its associated dataSet, and a text property that you can use to set additional custom messages to display. Other inherited properties include visual display properties such as font, alignment, and color.

The StatusBar control differs from the LabelControl in that the LabelControl displays the data from a particular row and column of the DataSet and the StatusBar displays status messages generated by the DataSet, but not its data.


StatusBar variables

Variables implemented in this class

Variables implemented in borland.jbcl.control.BevelPanel

Variables implemented in java.awt.Component

StatusBar constructors

StatusBar properties

*Read-only properties **Write-only properties

Properties implemented in this class

Properties implemented in borland.jbcl.control.BevelPanel

Properties implemented in java.awt.Component

Properties implemented in java.awt.Container

Properties implemented in java.lang.Object

StatusBar methods

Methods implemented in this class

Methods implemented in borland.jbcl.control.BevelPanel

Methods implemented in java.awt.Component

Methods implemented in java.awt.Container

Methods implemented in java.awt.Panel

Methods implemented in java.lang.Object

StatusBar event listeners


StatusBar variables

dataSet

  protected DataSet dataSet
Protected variable that specifies the DataSet object associated with the StatusBar control. Use accessor methods for the dataSet property to access this variable.

label

  protected Label label
Protected variable that returns the java.awt.Label contained in StatusBar control.

StatusBar constructors

StatusBar()

  public StatusBar()
Creates a StatusBar component with default properties.

StatusBar properties

alignment

 public int getAlignment()
 public void setAlignment(int alignment)
Stores the current alignment of the StatusBar. Valid values for int are defined in Alignment variables. If an invalid alignment value is specified, the setAlignment() method throws an IllegalArgumentException.

dataSet

 public DataSet getDataSet()
 public void setDataSet(borland.jbcl.dataset.DataSet dataSet)
Specifies the DataSet object whose status messages display in the StatusBar control.

preferredSize

 public Dimension getPreferredSize()
Stores the preferred dimensions that are used when drawing the StatusBar.

text

 public String getText()
 public void setText(java.lang.String text)
Stores the text that displays in the java.awt.Label of the StatusBar component. Use this property to display custom text in the StatusBar. This text is overwritten with the next setText call or, when the next status message is generated by the associated DataSet (if the dataset property of the StatusBar is set).

StatusBar methods

toString()

  public String toString()
Returns the string value of the java.awt.Label contained in the StatusBar component.

Overrides: java.awt.Component.toString()

updateValue()

  protected void updateValue()
Protected method that retrieves the value in the DataSet and updates the StatusBar by calling the setText() method.

StatusBar event listeners

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

component

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

container

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

focus

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

key

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

mouse

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

mouseMotion

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