MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT - Page 708

708 Chapter 12: ActionScript Dictionary
Description
Method; parses the CSS in cssText and loads the style sheet with it. If a style in cssText is
already in
styleSheet, the properties in styleSheet are retained, and only the ones in cssText
are added or changed in
styleSheet.
To extend the native CSS parsing capability, you can override this method by creating a subclass
of the TextField.StyleSheet class. For more information, see “Creating subclasses” on page 162.
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)