borland Packages  Class Hierarchy  dx.dataset Package 

StatusEvent class

java.lang.Object
   +----java.util.EventObject
           +----com.borland.jb.util.DispatchableEvent
                   +----com.borland.dx.dataset.StatusEvent

About the StatusEvent class

Variables  Constructors  Properties  Methods  

Implements Serializable

This class is used to inform listeners of specified types of status messages. Typically, these are informative messages, but if the listener (StatusListener) wants to take action for a particular status message, the getCode() method can be used to determine the type of message being sent.


StatusEvent variables

Variables implemented in this class

Variables implemented in java.util.EventObject

StatusEvent constructors

StatusEvent properties

*Read-only properties **Write-only properties

Properties implemented in this class

Properties implemented in com.borland.jb.util.DispatchableEvent

Properties implemented in java.lang.Object

Properties implemented in java.util.EventObject

StatusEvent methods

Methods implemented in this class

Methods implemented in com.borland.jb.util.DispatchableEvent

Methods implemented in java.lang.Object


StatusEvent variables

CHECKING_DATASTORE

  public static final int CHECKING_DATASTORE = 15
Checking to see if the DataStore was not closed properly. This check can take 7-10 seconds.

CLEAR

  public static final int CLEAR = 10
Sent by the DataSet.clearStatus() method to clear status information, for example, the StatusBar control.

DATA_CHANGE

  public static final int DATA_CHANGE = 8
Status message when data in a DataSet has changed. Use enter key to start the locate operation. Sent by DataSet.interactiveLocate().

EDIT_CANCELED

  public static final int EDIT_CANCELED = 12
Cancelled edit for new or existing row of a DataSet.

EDIT_STARTED

  public static final int EDIT_STARTED = 11
Entered edit state for new or existing row of a DataSet.

EXCEPTION

  public static final int EXCEPTION = 9
An exception was thrown.

LOADING_DATA

  public static final int LOADING_DATA = 1
Status notification about loading rows in a DataSet.

LOCATE_MATCH_FOUND

  public static final int LOCATE_MATCH_FOUND = 3
Status notification that a match was found during a locate operation. Sent by DataSet.interactiveLocate().

LOCATE_MATCH_NOT_FOUND

  public static final int LOCATE_MATCH_NOT_FOUND = 4
Status notification that a match could not be found for a location operation. Sent by DataSet.interactiveLocate().

LOCATE_NON_STRING

  public static final int LOCATE_NON_STRING = 7
Status notification that a locate operation on a non-String column expects a value whose length is greater than zero. Enter a value and press enter to begin search. Sent by DataSet.interactiveLocate().

LOCATE_STRING

  public static final int LOCATE_STRING = 6
Status notification that a locate operation of Locate.NEXT or Locate.PRIOR on a String column expects a value of length greater than zero. Enter a value and press enter to begin search. Sent by DataSet.interactiveLocate().

LOCATE_USE_ENTER

  public static final int LOCATE_USE_ENTER = 2

Status notification that the user should press the Enter to perform the locate. This notification is sent by DataSet.interactiveLocate() and applies to all locates on non-String columns.

LOCATE_USE_MIXED_CASE

  public static final int LOCATE_USE_MIXED_CASE = 5
Enter a value and use mixed case characters for a case-sensitive search. Sent by DataSet.interactiveLocate().

RESTRUCTURING

  public static final int RESTRUCTURING = 14
Status notification sent by long-running restructure operations.

SORTING

  public static final int SORTING = 13
Status notification sent by long-running sort operations.

StatusEvent constructors

StatusEvent(java.lang.Object, int, java.lang.String)

  public StatusEvent(Object source, int code, String message)
A constructor for a StatusEvent object with the following parameters:

Parameters:

source
The object generating the notification.
code
The type of message being sent. The int value represents one of the StatusEvent variables.
message
The String text associated with the code.

StatusEvent(java.lang.Object, java.lang.Throwable)

  public StatusEvent(Object source, Throwable ex)
A constructor for a StatusEvent object with the following parameters:

Parameters:

source
The object generating the notification.
ex
The Exception that occurred.

StatusEvent properties

code

 public final int getCode()
Gets the code that indicates the type of message. The int value returned represents one of the StatusEvent variables.

exception

 public final Throwable getException()
Get the exception which caused the message. Null unless code = EXCEPTION *

message

 public final String getMessage()
 public final void setMessage(String message)
Determines the String text associated with the status notification.

StatusEvent methods

dispatch(java.util.EventListener)

  public void dispatch(EventListener listener)
Sends the StatusEvent notification to all registered StatusListeners.

Overrides: com.borland.jb.util.DispatchableEvent.dispatch(EventListener)