TextFormat 类

可用性

Flash Player 6。

说明

TextFormat 类描述字符格式设置信息。

必须在使用构造函数 new TextFormat() 创建了 TextFormat 对象之后,才能调用其方法。

可将 TextFormat 参数设置为 null,以指示它们是未定义的。使用 TextField.setTextFormat() 将 TextFormat 对象应用到文本字段时,只会应用该对象已定义的属性,如下面的示例所示:

my_fmt = new TextFormat();
my_fmt.bold = true;
my_txt.setTextFormat(my_fmt);

此代码首先创建一个空 TextFormat 对象,该对象的所有属性都未定义,然后将 bold 属性设置为一个定义的值。

代码 my_txt.setTextFormat(my_fmt) 只更改该文本字段默认文本格式的 bold 属性,因为
bold 属性是 my_fmt 中定义的唯一属性。该文本字段默认文本格式的所有其它内容保持不变。

调用 TextField.getTextFormat() 时,将返回一个 TextFormat 对象,该对象的所有属性均已定义;所有属性都不为 null

TextFormat 类的方法摘要

方法

说明

TextFormat.getTextExtent()

返回文本字符串的文本度量信息。

TextFormat 类的属性摘要

属性

说明

TextFormat.align

指示段落的对齐方式。

TextFormat.blockIndent

指示块的缩进,以磅为单位。

TextFormat.bold

指示文本是否为粗体。

TextFormat.bullet

指示文本是否在带有项目符号的列表中。

TextFormat.color

指示文本的颜色。

TextFormat.font

指示带有文本格式的文本的字体名称。

TextFormat.indent

指示从左边距到段落中第一个字符的缩进。

TextFormat.italic

指示文本是否为斜体。

TextFormat.leading

指示行与行之间的垂直间距量(称为前导)。

TextFormat.leftMargin

以磅为单位指示段落的左边距。

TextFormat.rightMargin

以磅为单位指示段落的右边距。

TextFormat.size

指示文本的磅值。

TextFormat.tabStops

指定 Tab 键的自定义停靠位。

TextFormat.target

指示浏览器中显示超链接的窗口。

TextFormat.underline

指示文本是否带有下划线。

TextFormat.url

指示文本所链接到的 URL。

TextFormat 类的构造函数

可用性

Flash Player 6。

用法

new TextFormat([font, [size, [color, [bold, [italic, [underline, [url, [target, [align, [leftMargin, [rightMargin, [indent, [leading]]]]]]]]]]]]])

参数

font 以字符串形式表示的文本字体名称。

size 指示磅值的整数。

color 使用此文本格式的文本的颜色。包含三个 8 位 RGB 分量的数字;例如,0xFF0000 为红色、0x00FF00 为绿色。

bold 指示文本是否为粗体的布尔值。

italic 指示文本是否为斜体的布尔值。

underline 指示文本是否带有下划线的布尔值。

url 使用此文本格式的文本超链接到的 URL。如果 url 为空字符串,则表示文本没有超链接。

target 显示超链接的目标窗口。如果目标窗口为空字符串,则文本显示在默认目标窗口 _self 中。如果 url 参数设置为空字符串或值 null,虽然您可以获取或设置此属性,但该属性不起作用。

align 以字符串形式表示的段落对齐方式。如果为 "left",则段落为左对齐。如果为
"center",则段落居中。如果为 "right",则段落为右对齐。

leftMargin 指示段落的左边距,以磅为单位。

rightMargin 指示段落的右边距,以磅为单位。

indent 一个整数,指示从左边距到段落中第一个字符的缩进量。

leading 一个数字,指示行与行之间的前导垂直间距量。

返回

无。

说明

构造函数;使用指定的属性创建一个 TextFormat 对象。然后可更改 TextFormat 对象的属性以更改文本字段的格式设置。

任何参数都可设置为 null 以指示该参数未定义。所有的参数都是可选的;任何被忽略的参数都被视为 null