MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE, Reference

Page: 867 / 1104

TextField.StyleSheet.setStyle() 867
TextField.StyleSheet.setStyle()
Availability
Flash Player 7.
Usage
styleSheet .setStyle( name:String , style:Object ) : Void
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 my_styleSheet:TextField.StyleSheet = new TextField.StyleSheet();
var styleObj:Object = new Object();
styleObj.color = "#000000";
styleObj.fontWeight = "bold";
my_styleSheet.setStyle("emphasized", styleObj);
delete styleObj;
var styleNames_array:Array = my_styleSheet.getStyleNames();
for (var i=0;i<styleNames_array.length;i++) {
var styleName:String = styleNames_array[i];
var thisStyle:Object = my_styleSheet.getStyle(styleName);
trace(styleName);
for (var prop in thisStyle) {
trace("\t"+prop+": "+thisStyle[prop]);
}
trace("");
}