TextField.StyleSheet.setStyle()

Availability

Flash Player 7.

Usage

styleSheet.setStyle(name, style)

Parameters

name A string that specifies the name of the style to add to the style sheet.

style An object that describes the style, or null.

Returns

Nothing.

Description

Method; adds a new style with the specified name to the style sheet object. If the named style does not already exist in the style sheet, it is added. If the named style already exists in the style sheet, it is replaced. If the style parameter is null, the named style is removed.

Flash Player creates a copy of the style object that you pass to this method.

Example

The following code adds a style named emphasized to the style sheet myStyleSheet. The style includes two style properties: color and fontWeight. The style object is defined with the {} operator.

myStyleSheet.setStyle("emphasized", {color:'#000000',fontWeight:'bold'});

You could also create a style object using an instance of the Object class, and then pass that object as the style parameter, as the next example shows.

var styleObj = new Object();
styleObj.color = '#000000';
styleObj.fontWeight = 'bold';
myStyleSheet.setStyle("emphasized", styleObj);
delete styleObj;

Note: The last line of code (delete styleObj) deletes the original style object passed to setStyle() While not necessary, this step reduces memory usage, because Flash Player creates a copy of the style object you pass to setStyle().

See also

{} (object initializer)