org.openide.awt 7.3.1

org.openide.awt
Class StatusDisplayer

java.lang.Object
  extended by org.openide.awt.StatusDisplayer

public abstract class StatusDisplayer
extends Object

Permits control of a status line. The default instance may correspond to the NetBeans status line in the main window.

Since:
3.14

Constructor Summary
protected StatusDisplayer()
          Subclass constructor.
 
Method Summary
abstract  void addChangeListener(ChangeListener l)
          Add a listener for when the text changes.
static StatusDisplayer getDefault()
          Get the default status displayer.
abstract  String getStatusText()
          Get the currently displayed text.
abstract  void removeChangeListener(ChangeListener l)
          Remove a listener for the text.
abstract  void setStatusText(String text)
          Show text in the status line.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

StatusDisplayer

protected StatusDisplayer()
Subclass constructor.

Method Detail

getDefault

public static StatusDisplayer getDefault()
Get the default status displayer.

Returns:
the default instance from lookup

getStatusText

public abstract String getStatusText()
Get the currently displayed text.

Modules should not need to call this method. If you think you really do, please explain why on nbdev. The implementation of the GUI component (if any) which displays the text naturally needs to call it.

Returns:
some text

setStatusText

public abstract void setStatusText(String text)
Show text in the status line. Can be called at any time, but remember the text may not be updated until the AWT event queue is ready for it - so if you are hogging the event queue the text will not appear until you release it (finish your work or display a modal dialog, for example).

Default implementation of status line in NetBeans displays the text in status line and clears it after a while. Also there is no guarantee how long the text will be displayed as it can be replaced with new call to this method at any time.

Parameters:
text - the text to be shown

addChangeListener

public abstract void addChangeListener(ChangeListener l)
Add a listener for when the text changes.

Parameters:
l - a listener

removeChangeListener

public abstract void removeChangeListener(ChangeListener l)
Remove a listener for the text.

Parameters:
l - a listener

org.openide.awt 7.3.1

Built on November 10 2008.  |  Portions Copyright 1997-2007 Sun Microsystems, Inc. All rights reserved.