DAString Class

Creates a DAString object. At any given time, the value of the object is a character string. This value can vary over time.

This class inherits from the DABehavior class.

For relevant functions from the DAStatics class, see DAStatics Functions Relevant to DAString Objects.

DAString Functions

AnimateProperty Enables control properties to be animated (vary over time).

Extract Extracts the value of the stringObj, returning a string.

AnimateProperty

DAString Class

Enables control properties to be animated (vary over time). This function forms fragments of script and passes them to the scripting engine on every frame.

Syntax

stringObj.AnimateProperty( property, language, invoke, update )

Parameters

property
String that is either the name of the property to animate or the name of a scripting function to invoke that will set the property.
language
String that is name of the scripting language.
invoke
Boolean value that determines if the property is set directly or if a function is invoked. If FALSE, the property is set directly. If TRUE, a function is invoked.
update
A double value specifying how frequently the position is updated.

Return Value

Returns the DAString object.

Remarks

When the invoke parameter is FALSE, the property is set directly as shown in this fragment from the JScript sample in JScript\Templates\AnimatedProperties.html:
filterStr = filterStr.AnimateProperty("DropWave1.style.filter", "JScript", false, .1));
If the invoke parameter is TRUE, then a function name should be specified in the string parameter (property) and is invoked as shown in this fragment from the same JScript sample:
filterMethod = getNumber().AnimateProperty("SetFilter", "JScript", true, .1);

Extract

DAString Class

Extracts the value of the stringObj, returning a string. This object must have a constant value.

Syntax

stringObj.Extract

Return Value

Returns a string.