TextField.setTextFormat()

可用性

Flash Player 6。

用法

my_txt.setTextFormat (textFormat)
my_txt.setTextFormat (index, textFormat)
my_txt.setTextFormat (beginIndex, endIndex, textFormat)

参数

textFormat 一个包含字符和段落格式设置信息的 TextFormat 对象。

index 整数，指定 my_txt 内的一个字符。

beginIndex 一个整数。

endIndex 一个整数，指定所需文本范围后的第一个字符。

返回

无。

说明

方法；为文本字段中指定范围内的文本设置一个 TextFormat 对象。可以为文本字段中的每个字符分配一种文本格式。测试段落的第一个字符的文本格式，以执行整个段落的段落格式设置。setTextFormat() 方法更改应用于文本字段中单个字符、字符组或整体文本的文本格式。

文本格式在新 TextFormat 对象中设置。它包含字符和段落格式设置信息。字符格式设置信息描述单个字符的外观，例如，字体名称、磅值、颜色及关联 URL。段落格式设置信息描述段落的外观，例如，左边距、右边距、首行缩进和左对齐、右对齐及居中对齐。

用法 1：将 textFormat 的属性应用于文本字段中的所有文本。

用法 2：将 textFormat 的属性应用于 index 处的字符。

用法 3：将 textFormat 参数的属性应用于参数 beginIndex 到 endIndex 之间的文本范围。

请注意，用户手动插入的任何文本或使用 TextField.replaceSel() 替换的任何文本均不采用在 setTextFormat() 调用中指定的格式。若要设置 TextField 对象的默认格式，可使用 TextField.setNewTextFormat()。

示例

此示例新建一个名为 myTextFormat 的 TextFormat 对象，并将其 bold 属性设置为 true。然后调用 setTextFormat()，将新文本格式应用到 my_txt 文本字段。

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

另请参见

TextField.setNewTextFormat()、TextFormat 类