ActionScript® 3.0 Reference for the Adobe® Flash® Platform
Home  |  Show Packages and Classes List |  Packages  |  Classes  |  What's New  |  Index  |  Appendixes
mx.collections.errors 

ItemPendingError  - AS3 Flex

Packagemx.collections.errors
Classpublic class ItemPendingError
InheritanceItemPendingError Inheritance Error Inheritance 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.

Related API Elements



Public Properties
 PropertyDefined By
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
 InheritederrorID : int
[read-only] Contains the reference number associated with the specific error message.
Error
 Inheritedmessage : String
Contains the message associated with the Error object.
Error
 Inheritedname : String
Contains the name of the Error object.
Error
  responders : Array
[read-only] An array of IResponder handlers that will be called when the asynchronous request completes.
ItemPendingError
Public Methods
 MethodDefined By
  
Constructor.
ItemPendingError
  
addResponder adds a responder to an Array of responders.
ItemPendingError
 Inherited
Returns the call stack for an error at the time of the error's construction as a string.
Error
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
[override] Returns the string "Error" by default or the value contained in the Error.message property, if defined.
Error
 Inherited
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.

Related API Elements