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

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

Parameters:
listener - The listener.

addErrorListener

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

Parameters:
listener - The listener.

addVObjectListener

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

Parameters:
listener - The listener.

addWorkingListener

public 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

public 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

public 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

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

Parameters:
listener - The listener.

removeErrorListener

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

Parameters:
listener - The listener.

removeVObjectListener

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

Parameters:
listener - The listener.

removeWorkingListener

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

Parameters:
listener - The listener.