Flash CS3 Documentation

ActionScript 2.0 Components Language Reference > Data binding classes > DataType.setAnyTypedValue()

DataType.setAnyTypedValue()

Availability

Flash Player 6 (6.0.79.0).

Edition

Flash MX Professional 2004.

Usage

dataTypeObject.setAnyTypedValue(newTypedValue)

Parameters

newTypedValue A TypedValue object value to set in the field. For more information, see TypedValue class.

Returns

An array of strings describing any errors that occurred while attempting to set the new value. Errors can occur under any of the following conditions:

The data provided cannot be converted to the data type of this field (for example, "abc" cannot be converted to Number).
The data is an acceptable type but does not meet the validation criteria of the field.
The field is read-only.

NOTE

The actual text of an error message varies depending on the data type, formatters, and encoders that are defined in the field's schema.

Description

Method; sets a new value in the field, using the information in the field's schema to process the field.

This method operates by first calling DataType.setTypedValue() to set the value. If that fails, the method checks to see if the destination object is willing to accept String, Boolean, or Number data, and if so, attempts to use the corresponding ActionScript conversion functions.

Example

The following example creates a new TypedValue object (a Boolean value), and then assigns that value to a DataType object named field. Any errors that occur are assigned to the errors array.

import mx.data.binding.*;
var t:TypedValue = new TypedValue (true, "Boolean");
var errors: Array = field.setAnyTypedValue (t);