com.ibm.as400.vaccess
Interface VPropertiesPane


Deprecated. Use Java Swing instead, along with the classes in package com.ibm.as400.access

public interface VPropertiesPane

The VPropertiesPane interface defines the representation of a properties pane. A properties pane is a graphical user interface that allows the user to view and optionally edit properties of a system resource.

When the user makes a change using the editor, the properties pane fires a change event. This signals to the dialog that a change was made so that it can enable the Apply button. The change to the underlying system resource is not made at this time. This way the user can still choose to cancel the changes.

When the user clicks the OK or Apply button, then applyChanges() is called. The change to the underlying system resource is made at this time.

Most errors are reported as ErrorEvents rather than throwing exceptions. Users should listen for ErrorEvents in order to diagnose and recover from error conditions.

VPropertiesPane objects generate the following events:

See Also:
VObject.getPropertiesPane(), VPropertiesAction

Method Summary
 void addChangeListener(ChangeListener listener)
          Deprecated. Adds a listener to be notified when the user makes a change.
 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.
 void applyChanges()
          Deprecated. Applies the changes made by the user.
 Component getComponent()
          Deprecated. Returns the graphical user interface component.
 void removeChangeListener(ChangeListener listener)
          Deprecated. Removes a change listener.
 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.
 

Method Detail

addChangeListener

void addChangeListener(ChangeListener listener)
Deprecated. 
Adds a listener to be notified when the user makes a change.

Parameters:
listener - The listener.

addErrorListener

void addErrorListener(ErrorListener listener)
Deprecated. 
Adds a listener to be notified when an error occurs.

Parameters:
listener - The listener.

addVObjectListener

void addVObjectListener(VObjectListener listener)
Deprecated. 
Adds a listener to be notified when a VObject is changed, created, or deleted.

Parameters:
listener - The listener.

addWorkingListener

void addWorkingListener(WorkingListener listener)
Deprecated. 
Adds a listener to be notified when work starts and stops on potentially long-running operations.

Parameters:
listener - The listener.

applyChanges

void applyChanges()
                  throws Exception
Deprecated. 
Applies the changes made by the user. It will change the resources on the system.

Throws:
Exception - If an error occurs.

getComponent

Component getComponent()
Deprecated. 
Returns the graphical user interface component. This does not include the dialog or the OK, Cancel, and Apply buttons.

Returns:
The graphical user interface component.

removeChangeListener

void removeChangeListener(ChangeListener listener)
Deprecated. 
Removes a change listener.

Parameters:
listener - The listener.

removeErrorListener

void removeErrorListener(ErrorListener listener)
Deprecated. 
Removes an error listener.

Parameters:
listener - The listener.

removeVObjectListener

void removeVObjectListener(VObjectListener listener)
Deprecated. 
Removes a VObjectListener.

Parameters:
listener - The listener.

removeWorkingListener

void removeWorkingListener(WorkingListener listener)
Deprecated. 
Removes a working listener.

Parameters:
listener - The listener.