Flash CS3 Documentation

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

DataType.setTypedValue()

Availability

Flash Player 6 (6.0.79.0).

Edition

Flash MX Professional 2004.

Usage

dataTypeObject.setTypedValue(newTypedValue)

Parameters

newTypedValue A TypedValue object value to set in the field.

For more information about TypedValue objects, 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 is not an acceptable type.
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 behaves similarly to DataType.setAnyTypedValue(), except that it doesn't try as hard to convert the data to an acceptable data type. For more information, see DataType.setAnyTypedValue().

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 bool:TypedValue = new TypedValue (true, "Boolean");
var errors: Array = field.setTypedValue (bool);