spark.utils.DataItem - ActionScript® 3.0 Reference for the Adobe® Flash® Platform

Package	spark.utils
Class	public dynamic class DataItem
Inheritance	DataItem ObjectProxy Proxy Object

Language Version:

ActionScript 3.0

Product Version:

Flex 4.5

Runtime Versions:

Flash Player 10, AIR 2.5

The DataItem class represents a dynamic object with bindable properties. That means the Flex data binding mechanism recognizes when properties of a DataItem change at runtime. For example, a Spark DataGrid item renderer relies on data binding to a property of the items in the control's data provider. Because of data binding, when the property changes at runtime, the item renderer updates automatically.

This class is intended to be used in MXML to define object literals whose properties must be bindable. It's typically used to define List or DataGrid data provider items within an MXML file for small applications or examples with item renderers that bind to their data. Non-trival applications, or any application for which performance is a concern, should define a [Bindable] class with a fixed set of strongly typed properties and use that class to define data provider items.

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
		prototype : Object [static] A reference to the prototype object of a class or function object.	Object
		uid : String The unique identifier for this object.	ObjectProxy

Protected Properties

Hide Inherited Protected Properties

Show Inherited Protected Properties

	Property		Defined By
		dispatcher : EventDispatcher A reference to the EventDispatcher for this proxy.	ObjectProxy
		notifiers : Object A hashmap of property change notifiers that this proxy is listening for changes from; the key of the map is the property name.	ObjectProxy
		object : Object [read-only] The object being proxied.	ObjectProxy
		propertyList : Array Contains a list of all of the property names for the proxied object.	ObjectProxy
		proxyClass : Class Indicates what kind of proxy to create when proxying complex properties.	ObjectProxy
		type : QName The qualified type name associated with this object.	ObjectProxy

Public Methods

Hide Inherited Public Methods

Show Inherited Public Methods

	Method		Defined By
		DataItem() Constructor	DataItem
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registers an event listener object so that the listener receives notification of an event.	ObjectProxy
		dispatchEvent(event:Event):Boolean Dispatches an event into the event flow.	ObjectProxy
		hasEventListener(type:String):Boolean Checks whether there are any event listeners registered for a specific type of event.	ObjectProxy
		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
		propertyChangeHandler(event:PropertyChangeEvent):void Called when a complex property is updated.	ObjectProxy
		propertyIsEnumerable(name:String):Boolean Indicates whether the specified property exists and is enumerable.	Object
		readExternal(input:IDataInput):void Since Flex only uses ObjectProxy to wrap anonymous objects, the server flex.messaging.io.ObjectProxy instance serializes itself as a Map that will be returned as a plain ActionScript object.	ObjectProxy
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Removes an event listener.	ObjectProxy
		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 Returns the string representation of the specified object.	Object
		valueOf():Object Returns the primitive value of the specified object.	Object
		willTrigger(type:String):Boolean Checks whether an event listener is registered with this object or any of its ancestors for the specified event type.	ObjectProxy
		writeExternal(output:IDataOutput):void Since Flex only serializes the inner ActionScript object that it wraps, the server flex.messaging.io.ObjectProxy populates itself with this anonymous object's contents and appears to the user as a Map.	ObjectProxy

Protected Methods

Hide Inherited Protected Methods

Show Inherited Protected Methods

	Method		Defined By
		setupPropertyList():void This method creates an array of all of the property names for the proxied object.	ObjectProxy

Constructor Detail

DataItem

()

Constructor

public function DataItem()