User Guide

Object.addProperty() 377
Returns
A reference to an Object object.
Description
Constructor; creates an Object object and stores a reference to the object’s constructor method in
the object’s
constructor property.
Example
The following example creates a generic object named myObject:
var myObject:Object = new Object();
Object.addProperty()
Availability
Flash Player 6. In ActionScript 2.0 classes, you can use get or set instead of this method.
Usage
myObject.addProperty(prop:String, getFunc:Function, setFunc:Function) :
Boolean
Parameters
prop
A string; the name of the object property to create.
getFunc The function that is invoked to retrieve the value of the property; this parameter is a
Function object.
setFunc The function that is invoked to set the value of the property; this parameter is a
Function object. If you pass the value
null for this parameter, the property is read-only.
Returns
A Boolean value: true if the property is successfully created; false otherwise.
Description
Method; creates a getter/setter property. When Flash reads a getter/setter property, it invokes the
get function, and the function’s return value becomes the value of prop. When Flash writes a
getter/setter property, it invokes the
set function and passes it the new value as a parameter. If a
property with the given name already exists, the new property overwrites it.
A “get” function is a function with no parameters. Its return value can be of any type. Its type can
change between invocations. The return value is treated as the current value of the property.
A “set” function is a function that takes one parameter, which is the new value of the property. For
example, if property
x is assigned by the statement x = 1, the set function is passed the parameter
1 of type number. The return value of the set function is ignored.