flash.text.StyleSheet (ActionScript 3.0)

包	flash.text
类	public dynamic class StyleSheet
继承	StyleSheet EventDispatcher Object

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

使用 StyleSheet 类可以创建包含文本格式设置规则（例如，字体大小、颜色和其它格式样式）的 StyleSheet 对象。然后，可以将样式表定义的样式应用到包含 HTML 或 XML 格式文本的 TextField 对象。根据 StyleSheet 对象定义的标签样式自动设置 TextField 对象中文本的格式。可以使用文本样式来定义新的格式标签，重新定义内置的 HTML 标签，或创建可应用到某些 HTML 标签的样式类。

若要对一个 TextField 对象应用样式，请将该 StyleSheet 对象赋给 TextField 对象的 styleSheet 属性。

注意：具有样式表的文本字段不可编辑。也就是说，type 属性设置为 TextFieldType.INPUT 的文本字段会对文本字段的默认文本应用样式表，但用户不再能编辑该内容。考虑使用 TextFormat 类将样式分配给输入文本字段。

Flash Player 支持原 CSS1 规范 (www.w3.org/TR/REC-CSS1) 中的部分属性。下表显示受支持的层叠样式表 (CSS) 属性和值，及其相应的 ActionScript 属性名称。（每个 ActionScript 属性名称都是从对应的 CSS 属性名称派生的；如果名称中包含连字符，请省略连字符并将连字符后的字符变成大写。）

CSS 属性	ActionScript 属性	用法和支持的值
`color`	`color`	只支持十六进制颜色值。不支持具有指定名称的颜色（例如 `blue`）。颜色以下面的格式写入：`#FF0000`。
`display`	`display`	受支持的值为 `inline`、`block` 和 `none`。
`font-family`	`fontFamily`	用逗号分隔的供使用字体的列表，根据需要按降序排列。可以使用任何字体系列名称。如果您指定通用字体名称，它将转换为相应的设备字体。支持以下字体转换：`mono` 转换为 `_typewriter`，`sans-serif` 转换为 `_sans`，`serif` 转换为 `_serif`。
`font-size`	`fontSize`	只使用该值的数字部分。不分析单位（px、pt）；像素和磅是等价的。
`font-style`	`fontStyle`	可识别的值为 `normal` 和 `italic`。
`font-weight`	`fontWeight`	可识别的值为 `normal` 和 `bold`。
`kerning`	`kerning`	可识别的值为 `true` 和 `false`。仅嵌入字体支持字距调整。某些字体（如 Courier New）不支持字距调整。只有 Windows 中创建的 SWF 文件支持 kerning 属性，而 Macintosh 中创建的 SWF 文件不支持该属性。但是，这些 SWF 文件可以在 Flash Player 的非 Windows 版本中播放，并且仍可以应用字距调整。
`leading`	`leading`	两行之间统一分布的距离。该值指定在每行之后添加的像素数。负值将压缩两行之间的距离。只使用该值的数字部分。不分析单位（px、pt）；像素和磅是等价的。
`letter-spacing`	`letterSpacing`	两个字符之间统一分布的距离。该值指定在每个字符之后添加的像素数。负值将压缩两个字符之间的距离。只使用该值的数字部分。不分析单位（px、pt）；像素和磅是等价的。
`margin-left`	`marginLeft`	只使用该值的数字部分。不分析单位（px、pt）；像素和磅是等价的。
`margin-right`	`marginRight`	只使用该值的数字部分。不分析单位（px、pt）；像素和磅是等价的。
`text-align`	`textAlign`	可识别的值为 `left`、`center`、`right` 和 `justify`。
`text-decoration`	`textDecoration`	可识别的值为 `none` 和 `underline`。
`text-indent`	`textIndent`	只使用该值的数字部分。不分析单位（px、pt）；像素和磅是等价的。

查看示例

另请参见

flash.text.TextField

	属性	定义方
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		prototype : Object [static] 对类或函数对象的原型对象的引用。	Object
		styleNames : Array [read-only] 一个数组，其中包含此样式表中注册的所有样式的名称（字符串形式）。	StyleSheet

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		定义方
		StyleSheet() 创建新的 StyleSheet 对象。	StyleSheet
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		clear():void 从样式表对象中删除所有样式。	StyleSheet
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getStyle(styleName:String):Object 返回与名为 styleName 的样式相关联的样式对象的一个副本。	StyleSheet
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		parseCSS(CSSText:String):void 分析 CSSText 中的 CSS 并用它加载样式表。	StyleSheet
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setStyle(styleName:String, styleObject:Object):void 将具有指定名称的新样式添加到样式表对象中。	StyleSheet
		toString():String 返回指定对象的字符串表示形式。	Object
		transform(formatObject:Object):TextFormat 扩展 CSS 分析功能。	StyleSheet
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。	EventDispatcher

	事件	摘要	定义方
		activate	Flash Player 获得操作系统焦点并变为活动状态时调度。	EventDispatcher
		deactivate	Flash Player 失去操作系统焦点并变为非活动状态时调度。	EventDispatcher

属性详细信息

styleNames

属性

styleNames:Array [read-only]

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

一个数组，其中包含此样式表中注册的所有样式的名称（字符串形式）。

实现
public function get styleNames():Array

构造函数详细信息

StyleSheet

()

构造函数

public function StyleSheet()

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

创建新的 StyleSheet 对象。

另请参见

flash.text.StyleSheet.getStyle()

方法详细信息

clear

()

方法

public function clear():void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

从样式表对象中删除所有样式。

getStyle

()

方法

public function getStyle(styleName:String):Object

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

返回与名为 styleName 的样式相关联的样式对象的一个副本。如果没有与 styleName 相关联的样式对象，则返回 null。

参数

styleName:String — 一个字符串，该字符串指定要检索的样式的名称。

Object — 一个对象。

另请参见

flash.text.StyleSheet.setStyle()

parseCSS

()

方法

public function parseCSS(CSSText:String):void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

分析 CSSText 中的 CSS 并用它加载样式表。如果 CSSText 中的某个样式在 styleSheet 中已经存在，则保留 styleSheet 中的属性，在 styleSheet 中只添加或更改 CSSText 中的属性。

若要扩展本机 CSS 分析功能，可通过创建 StyleSheet 类的子类来覆盖此方法。

参数

CSSText:String — 要分析的 CSS 文本（字符串）。

setStyle

()

方法

public function setStyle(styleName:String, styleObject:Object):void

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

将具有指定名称的新样式添加到样式表对象中。如果该样式表中没有指定名称的样式，将添加该样式。如果该样式表中已经有指定名称的样式，将替换该样式。如果 styleObject 参数为 null，则删除指定名称的样式。

Flash Player 将创建传递给此方法的样式对象的一个副本。

要获取所支持样式的列表，请参阅 StyleSheet 类说明中的表。

参数

	`styleName:String` — 一个字符串，用于指定要添加到样式表中的样式的名称。

	`styleObject:Object` — 一个说明样式的对象，或 `null`。

transform

()

方法

public function transform(formatObject:Object):TextFormat

语言版本 :

ActionScript 3.0

Player 版本 :

Flash Player 9

扩展 CSS 分析功能。高级开发人员可通过扩展 StyleSheet 类覆盖此方法。

参数

formatObject:Object — 一个说明样式的对象（包含作为对象属性的样式规则），或 null。

TextFormat — 一个包含 CSS 规则向文本格式属性映射的结果的 TextFormat 对象。

另请参见

flash.text.TextFormat

示例如何使用示例

下例创建了一个新样式表并将粗体和红色字体处理分配给标题样式。

 
package {
    import flash.display.Sprite;
    import flash.text.StyleSheet;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class StyleSheetExample extends Sprite {

        public function StyleSheetExample() {
            var style:StyleSheet = new StyleSheet();

            var heading:Object = new Object();
            heading.fontWeight = "bold";
            heading.color = "#FF0000";

            var body:Object = new Object();
            body.fontStyle = "italic";

            style.setStyle(".heading", heading);
            style.setStyle("body", body);

            var label:TextField = new TextField();
            label.styleSheet = style;
            label.htmlText = "<body><span class='heading'>Hello </span>World...</body>";
            addChild(label);
        }
    }
}

当前页: http://livedocs.adobe.com/flash/9.0_cn/ActionScriptLangRefV3/flash/text/StyleSheet.html

ActionScript 3.0 语言和组件参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 帧无帧
StyleSheet	属性 \| 方法 \| 事件 \| 示例