AIR 3.0 and later


FREResult FRESetObjectProperty ( 
                FREObject                 object, 
                const uint8_t*                 propertyName, 
                FREObject                propertyValue, 
                FREObject*                thrownException 


An FREObject that represents the ActionScript class object for which a property is to be set.

A uint8_t array. This array contains a string that is the name of property to set. Use UTF-8 encoding for the string and terminate it with the null character.

An FREObject that represents the value to set the property to.

A pointer to an FREObject. If calling this method results in the runtime throwing an ActionScript exception, this FREObject variable represents the ActionScript Error, or Error subclass, object. If no error occurs, the runtime sets this FREObject variable to be invalid. That is, FREGetObjectType() for the thrownException FREObject variable returns FRE_INVALID_OBJECT. This pointer can be NULL if you do not want to handle exception information.


An FREResult. The possible return values include, but are not limited to, the following:

The function succeeded and the ActionScript class object’s property is correctly set.

An ActionScript error occurred. The runtime sets the thrownException parameter to represent the ActionScript Error class or subclass object.

The extension context has acquired an ActionScript BitmapData or ByteArray object. The context cannot call this method until it releases the BitmapData or ByteArray object.

The propertyName parameter is NULL.

The object or propertyValue parameter is an invalid FREObject variable.

The propertyName parameter does not match a property of the ActionScript class object that the object parameter represents. Another, less likely, reason for this return value exists. Specifically, consider the unusual case when an ActionScript class has two properties with the same name but the names are in different ActionScript namespaces.

The property to set is a read-only property.

The FREObject object parameter does not represent an ActionScript class object.

The method was called from a thread other than the one on which the runtime has an outstanding call to a native extension function.


Call this function to set the value of a public property of the ActionScript class object that an FREObject variable represents. Pass the name of the property to set in the propertyName parameter. Pass the new property value in the propertyValue parameter.