public interface VObject
An object has any number of properties. These are attributes of the object itself and are identified by property identifiers. Every object has at least name and desctiption properties, and most will define more.
Many of these methods are not called directly by programs. Instead, they are called by the server panes to respond to the user interface as needed.
Most errors are reported as ErrorEvents rather than throwing exceptions. Users should listen for ErrorEvents in order to diagnose and recover from error conditions.
VObject objects generate the following events:
An implementation of this interface should pass on all events fired by its actions and properties pane to its listeners.
Modifier and Type | Field and Description |
---|---|
static java.lang.Object |
DESCRIPTION_PROPERTY
Deprecated.
Property identifier for the description.
|
static java.lang.Object |
NAME_PROPERTY
Deprecated.
Property identifier for the name.
|
Modifier and Type | Method and Description |
---|---|
void |
addErrorListener(ErrorListener listener)
Deprecated.
Adds a listener to be notified when an error occurs.
|
void |
addVObjectListener(VObjectListener listener)
Deprecated.
Adds a listener to be notified when a VObject is changed,
created, or deleted.
|
void |
addWorkingListener(WorkingListener listener)
Deprecated.
Adds a listener to be notified when work starts and stops
on potentially long-running operations.
|
VAction[] |
getActions()
Deprecated.
Returns the list of actions that can be performed.
|
VAction |
getDefaultAction()
Deprecated.
Returns the default action.
|
javax.swing.Icon |
getIcon(int size,
boolean open)
Deprecated.
Returns the icon.
|
VPropertiesPane |
getPropertiesPane()
Deprecated.
Returns the properties pane.
|
java.lang.Object |
getPropertyValue(java.lang.Object propertyIdentifier)
Deprecated.
Returns a property value.
|
java.lang.String |
getText()
Deprecated.
Returns the descriptive text associated with this object.
|
void |
load()
Deprecated.
Loads information about the object from the system.
|
void |
removeErrorListener(ErrorListener listener)
Deprecated.
Removes an error listener.
|
void |
removeVObjectListener(VObjectListener listener)
Deprecated.
Removes a VObjectListener.
|
void |
removeWorkingListener(WorkingListener listener)
Deprecated.
Removes a working listener.
|
static final java.lang.Object NAME_PROPERTY
static final java.lang.Object DESCRIPTION_PROPERTY
void addErrorListener(ErrorListener listener)
listener
- The listener.void addVObjectListener(VObjectListener listener)
listener
- The listener.void addWorkingListener(WorkingListener listener)
listener
- The listener.VAction[] getActions()
VAction getDefaultAction()
javax.swing.Icon getIcon(int size, boolean open)
size
- The icon size, either 16 or 32. If any other
value is given, then return a default.open
- true for the open icon; false for the closed
icon. If there is only one icon, then this
parameter has no effect.VPropertiesPane getPropertiesPane()
java.lang.Object getPropertyValue(java.lang.Object propertyIdentifier)
An implementation of this interface should describe the properties that it supports. At minimum, it should support the following property identifiers:
Property | Return value |
---|---|
NAME_PROPERTY | Returns the VObject itself ("this"). This will be rendered using an icon and a name. |
DESCRIPTION_PROPERTY | Returns a text description of the VObject. |
propertyIdentifier
- The property identifier.java.lang.String getText()
void load()
void removeErrorListener(ErrorListener listener)
listener
- The listener.void removeVObjectListener(VObjectListener listener)
listener
- The listener.void removeWorkingListener(WorkingListener listener)
listener
- The listener.