com.ibm.as400.vaccess
Class VPrinters

java.lang.Object
  com.ibm.as400.vaccess.VPrinters

All Implemented Interfaces:

VNode, VObject, Serializable, TreeNode

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

public class VPrinters
extends Object
implements VNode, Serializable

The VPrinters class represents a list of system printers for use in various models and panes in this package.

Both the children and details children of a VPrinters object are the printers (VPrinter objects) in this list.

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

VPrinters objects generate the following events:

• ErrorEvent
• PropertyChangeEvent
• VObjectEvent
• WorkingEvent

See Also:

Serialized Form

Field Summary

Modifier and Type	Field and Description

Fields inherited from interface com.ibm.as400.vaccess.VObject

DESCRIPTION_PROPERTY, NAME_PROPERTY

Constructor and Description

VPrinters()
Deprecated. Constructs a VPrinters object.

VPrinters(AS400 system)
Deprecated. Constructs a VPrinters object.

VPrinters(VNode parent, AS400 system)
Deprecated. Constructs a VPrinters object.

Method Summary

Modifier and Type	Method and Description
void	addErrorListener(ErrorListener listener) Deprecated. Adds a listener to be notified when an error occurs.
void	addPropertyChangeListener(PropertyChangeListener listener) Deprecated. Adds a listener to be notified when the value of any bound property changes.
void	addVetoableChangeListener(VetoableChangeListener listener) Deprecated. Adds a listener to be notified when the value of any constrained property changes.
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.
Enumeration	children() Deprecated. Returns the children of the node.
VAction[]	getActions() Deprecated. Returns the list of actions that can be performed.
boolean	getAllowsChildren() Deprecated. Indiciates if the node allows children.
TreeNode	getChildAt(int index) Deprecated. Returns the child node at the specified index.
int	getChildCount() Deprecated. Returns the number of children.
VAction	getDefaultAction() Deprecated. Returns the default action.
VObject	getDetailsChildAt(int index) Deprecated. Returns the child for the details at the specified index.
int	getDetailsChildCount() Deprecated. Returns the number of children for the details.
TableColumnModel	getDetailsColumnModel() Deprecated. Returns the table column model to use in the details when representing the children.
int	getDetailsIndex(VObject detailsChild) Deprecated. Returns the index of the specified child for the details.
Icon	getIcon(int size, boolean open) Deprecated. Returns the icon.
int	getIndex(TreeNode child) Deprecated. Returns the index of the specified child.
TreeNode	getParent() Deprecated. Returns the parent node.
String	getPrinterFilter() Deprecated. Returns the printer list filter.
VPropertiesPane	getPropertiesPane() Deprecated. Returns the properties pane.
Object	getPropertyValue(Object propertyIdentifier) Deprecated. Returns a property value.
AS400	getSystem() Deprecated. Returns the system from which the list will be retrieved.
String	getText() Deprecated. Returns the text.
boolean	isLeaf() Deprecated. Indicates if the node is a leaf.
boolean	isSortable() Deprecated. Indicates if the details children are sortable.
void	load() Deprecated. Loads information about the object from the system.
void	removeErrorListener(ErrorListener listener) Deprecated. Removes an error listener.
void	removePropertyChangeListener(PropertyChangeListener listener) Deprecated. Removes a property change listener.
void	removeVetoableChangeListener(VetoableChangeListener listener) Deprecated. Removes a vetoable change listener.
void	removeVObjectListener(VObjectListener listener) Deprecated. Removes a VObjectListener.
void	removeWorkingListener(WorkingListener listener) Deprecated. Removes a working listener.
void	setPrinterFilter(String printerFilter) Deprecated. Sets printer list filter.
void	setSystem(AS400 system) Deprecated. Sets the system from which the list will be retrieved.
void	sortDetailsChildren(Object[] propertyIdentifiers, boolean[] orders) Deprecated. Sorts the children for the details.
String	toString() Deprecated. Returns the string representation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

VPrinters

public VPrinters()

Deprecated.

Constructs a VPrinters object.

VPrinters

public VPrinters(AS400 system)

Deprecated.

Constructs a VPrinters object.

Parameters:

system - The system from which the list will be retrieved.

VPrinters

public VPrinters(VNode parent,
                 AS400 system)

Deprecated.

Constructs a VPrinters object.

Parameters:

parent - The parent.

system - The system from which the list will be retrieved.

Method Detail

addErrorListener

public void addErrorListener(ErrorListener listener)

Deprecated.

Adds a listener to be notified when an error occurs.

Specified by:

addErrorListener in interface VObject

Parameters:

listener - The listener.

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

Deprecated.

Adds a listener to be notified when the value of any bound property changes.

Parameters:

listener - The listener.

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener listener)

Deprecated.

Adds a listener to be notified when the value of any constrained property changes.

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.

Specified by:

addVObjectListener in interface VObject

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.

Specified by:

addWorkingListener in interface VObject

Parameters:

listener - The listener.

children

public Enumeration children()

Deprecated.

Returns the children of the node. The children are the printers.

Specified by:

children in interface TreeNode

Returns:

The children.

getActions

public VAction[] getActions()

Deprecated.

Returns the list of actions that can be performed.

Specified by:

getActions in interface VObject

Returns:

Always null. There are no actions.

getAllowsChildren

public boolean getAllowsChildren()

Deprecated.

Indiciates if the node allows children.

Specified by:

getAllowsChildren in interface TreeNode

Returns:

Always true.

getChildAt

public TreeNode getChildAt(int index)

Deprecated.

Returns the child node at the specified index.

Specified by:

getChildAt in interface TreeNode

Parameters:

index - The index.

Returns:

The child node, or null if the index is not valid.

getChildCount

public int getChildCount()

Deprecated.

Returns the number of children. This is the number of printers.

Specified by:

getChildCount in interface TreeNode

Returns:

The number of children.

getDefaultAction

public VAction getDefaultAction()

Deprecated.

Returns the default action.

Specified by:

getDefaultAction in interface VObject

Returns:

Always null. There is no default action.

getDetailsChildAt

public VObject getDetailsChildAt(int index)

Deprecated.

Returns the child for the details at the specified index.

Specified by:

getDetailsChildAt in interface VNode

Parameters:

index - The index.

Returns:

The child, or null if the index is not valid.

getDetailsChildCount

public int getDetailsChildCount()

Deprecated.

Returns the number of children for the details.

Specified by:

getDetailsChildCount in interface VNode

Returns:

The number of children for the details.

getDetailsColumnModel

public TableColumnModel getDetailsColumnModel()

Deprecated.

Returns the table column model to use in the details when representing the children. This column model describes the details values for the children.

Specified by:

getDetailsColumnModel in interface VNode

Returns:

The details column model.

See Also:

VObject.getPropertyValue(java.lang.Object)

getDetailsIndex

public int getDetailsIndex(VObject detailsChild)

Deprecated.

Returns the index of the specified child for the details.

Specified by:

getDetailsIndex in interface VNode

Parameters:

detailsChild - The details child.

Returns:

The index, or -1 if the child is not found in the details.

getIcon

public Icon getIcon(int size,
                    boolean open)

Deprecated.

Returns the icon.

Specified by:

getIcon in interface VObject

Parameters:

size - The icon size, either 16 or 32. If any other value is given, then return the default of 16.

open - This parameter has no effect.

Returns:

The icon.

getIndex

public int getIndex(TreeNode child)

Deprecated.

Returns the index of the specified child.

Specified by:

getIndex in interface TreeNode

Parameters:

child - The child.

Returns:

The index, or -1 if the child is not found.

getParent

public TreeNode getParent()

Deprecated.

Returns the parent node.

Specified by:

getParent in interface TreeNode

Returns:

The parent node, or null if there is no parent.

getPrinterFilter

public String getPrinterFilter()

Deprecated.

Returns the printer list filter.

Returns:

The printer filter.

getPropertiesPane

public VPropertiesPane getPropertiesPane()

Deprecated.

Returns the properties pane.

Specified by:

getPropertiesPane in interface VObject

Returns:

The properties pane.

getPropertyValue

public Object getPropertyValue(Object propertyIdentifier)

Deprecated.

Returns a property value.

Specified by:

getPropertyValue in interface VObject

Parameters:

propertyIdentifier - The property identifier. The choices are

• NAME_PROPERTY
• DESCRIPTION_PROPERTY

Returns:

The property value, or null if the property identifier is not recognized.

getSystem

public AS400 getSystem()

Deprecated.

Returns the system from which the list will be retrieved.

Returns:

The system from which the list will be retrieved.

getText

public String getText()

Deprecated.

Returns the text. This is a constant string which identifies this object as a list of printers.

Specified by:

getText in interface VObject

Returns:

The text.

isLeaf

public boolean isLeaf()

Deprecated.

Indicates if the node is a leaf.

Specified by:

isLeaf in interface TreeNode

Returns:

true if the node if a leaf; false otherwise.

isSortable

public boolean isSortable()

Deprecated.

Indicates if the details children are sortable.

Specified by:

isSortable in interface VNode

Returns:

Always false.

load

public void load()

Deprecated.

Loads information about the object from the system.

Specified by:

load in interface VObject

removeErrorListener

public void removeErrorListener(ErrorListener listener)

Deprecated.

Removes an error listener.

Specified by:

removeErrorListener in interface VObject

Parameters:

listener - The listener.

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

Deprecated.

Removes a property change listener.

Parameters:

listener - The listener.

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener listener)

Deprecated.

Removes a vetoable change listener.

Parameters:

listener - The listener.

removeVObjectListener

public void removeVObjectListener(VObjectListener listener)

Deprecated.

Removes a VObjectListener.

Specified by:

removeVObjectListener in interface VObject

Parameters:

listener - The listener.

removeWorkingListener

public void removeWorkingListener(WorkingListener listener)

Deprecated.

Removes a working listener.

Specified by:

removeWorkingListener in interface VObject

Parameters:

listener - The listener.

setPrinterFilter

public void setPrinterFilter(String printerFilter)
                      throws PropertyVetoException

Deprecated.

Sets printer list filter. A call to load() must be done after calling this funtion inorder to update the details and tree children.

Parameters:

printerFilter - The name of the printers to list. It cannot be greater than 10 characters in length. It can be a specific name, a generic name, or the special value *ALL. The default for the printerFilter is *ALL.

Throws:

PropertyVetoException - If the change is vetoed.

setSystem

public void setSystem(AS400 system)
               throws PropertyVetoException

Deprecated.

Sets the system from which the list will be retrieved. A call to load() must be done after calling this funtion inorder to update the details and tree children.

Parameters:

system - The system from which the list will be retrieved.

Throws:

PropertyVetoException - If the change is vetoed.

sortDetailsChildren

public void sortDetailsChildren(Object[] propertyIdentifiers,
                                boolean[] orders)

Deprecated.

Sorts the children for the details. Since sorting is not supported, this method does nothing.

Specified by:

sortDetailsChildren in interface VNode

Parameters:

propertyIdentifiers - The property identifiers.

orders - The sort orders for each property identifier; true for ascending order, false for descending order.

toString

public String toString()

Deprecated.

Returns the string representation. This is a constant string which identifies this object as a list of printers.

Overrides:

toString in class Object

Returns:

The string representation.