mx.collections.errors.ItemPendingError - Adobe® Flex® 4 Language Reference (Flex 4)

Package	mx.collections.errors
Class	public class ItemPendingError
Inheritance	ItemPendingError Error Object
Subclasses	ChildItemPendingError

Language Version:

ActionScript 3.0

Product Version:

Flex 3

Runtime Versions:

Flash Player 9, AIR 1.1

This error is thrown when retrieving an item from a collection view requires an asynchronous call. This error occurs when the backing data is provided from a remote source and the data is not yet available locally.

If the receiver of this error needs notification when the requested item becomes available (that is, when the asynchronous call completes), it must use the addResponder() method and specify an object that supports the mx.rpc.IResponder interface to respond when the item is available. The mx.collections.ItemResponder class implements the IResponder interface and supports a data property.

Public Properties

Hide Inherited Public Properties

Show Inherited Public Properties

	Property		Defined By
		constructor : Object A reference to the class object or constructor function for a given object instance.	Object
		errorID : int [read-only] Contains the reference number associated with the specific error message.	Error
		message : String Contains the message associated with the Error object.	Error
		name : String Contains the name of the Error object.	Error
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object
		responders : Array [read-only] An array of IResponder handlers that will be called when the asynchronous request completes.	ItemPendingError

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		ItemPendingError(message:String) Constructor.	ItemPendingError
		addResponder(responder:IResponder):void addResponder adds a responder to an Array of responders.	ItemPendingError
		getStackTrace():String Returns the call stack for an error as a string at the time of the error's construction (for the debugger version of Flash Player and the AIR Debug Launcher (ADL) only; returns null if not using the debugger version of Flash Player or the ADL.	Error
		hasOwnProperty(name:String):Boolean Indicates whether an object has a specified property defined.	Object
		isPrototypeOf(theClass:Object):Boolean Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.	Object
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Sets the availability of a dynamic property for loop operations.	Object
		toLocaleString():String Returns the string representation of this object, formatted according to locale-specific conventions.	Object
		toString():String [override] Returns the string "Error" by default or the value contained in the Error.message property, if defined.	Error
		valueOf():Object Returns the primitive value of the specified object.	Object

Property Detail

responders

property

responders:Array [read-only]

Language Version:

ActionScript 3.0

Product Version:

Flex 3

Runtime Versions:

Flash Player 9, AIR 1.1

An array of IResponder handlers that will be called when the asynchronous request completes.

Implementation
public function get responders():Array

Constructor Detail

ItemPendingError

()

Constructor

public function ItemPendingError(message:String)

Language Version:

ActionScript 3.0

Product Version:

Flex 3

Runtime Versions:

Flash Player 9, AIR 1.1

Constructor.

Called by the Flex Framework when a request is made for an item that isn't local.

Parameters

message:String — A message providing information about the error cause.

Method Detail

addResponder

()

method

public function addResponder(responder:IResponder):void

Language Version:

ActionScript 3.0

Product Version:

Flex 3

Runtime Versions:

Flash Player 9, AIR 1.1

addResponder adds a responder to an Array of responders. The object assigned to the responder parameter must implement the mx.rpc.IResponder interface.

Parameters

responder:IResponder — A handler which will be called when the asynchronous request completes.