Flash ActionScript 30 语言和组件参考TextFormat.docx
《Flash ActionScript 30 语言和组件参考TextFormat.docx》由会员分享，可在线阅读，更多相关《Flash ActionScript 30 语言和组件参考TextFormat.docx（25页珍藏版）》请在冰豆网上搜索。
FlashActionScript30语言和组件参考TextFormat
包
flash.text
类
publicclassTextFormat
继承
TextFormat
Object
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9
TextFormat类描述字符格式设置信息。
使用TextFormat类可以为文本字段创建特定的文本格式。
您可以将文本格式应用于静态文本字段和动态文本字段。
TextFormat类的属性适用于设备字体和嵌入字体。
不过，对于嵌入字体，粗体和斜体文本实际上需要特定字体。
如果要使用嵌入字体来显示粗体或斜体文本，则需要嵌入该字体的粗体和斜体变体。
必须先使用构造函数newTextFormat（）创建TextFormat对象，才能设置该构造函数的属性。
在使用TextField.defaultTextFormat属性或TextField.setTextFormat（）方法对文本字段应用TextFormat对象时，将只应用该对象的已定义的属性。
在向TextField添加文本前，请使用TextField.defaultTextFormat属性应用格式，在向theTextField添加文本后，请使用setTextFormat（）方法添加格式。
默认情况下，TextFormat属性为null，因为如果没有提供属性值，FlashPlayer将使用自己的默认格式设置。
FlashPlayer用于各个属性的默认格式（如果属性的值为null）如下所示：
align="left"
blockIndent=0
bold=false
bullet=false
color=0x000000
font="TimesNewRoman"（在MacOSX上，默认字体为Times）
indent=0
italic=false
kerning=false
leading=0
leftMargin=0
letterSpacing=0
rightMargin=0
size=12
tabStops=[]（emptyarray）
target=""（emptystring）
underline=false
url=""（emptystring）
各个属性的默认格式设置在各自的说明中也有所描述。
查看示例
另请参见
flash.text.TextField.setTextFormat（）
flash.text.TextField.defaultTextFormat
flash.text.TextField.getTextFormat（）
公共属性
属性
定义方
align:
String
指示段落的对齐方式。
TextFormat
blockIndent:
Object
指示块缩进，以像素为单位。
TextFormat
bold:
Object
指定文本是否为粗体字。
TextFormat
bullet:
Object
指示文本为带项目符号的列表的一部分。
TextFormat
color:
Object
指示文本的颜色。
TextFormat
constructor:
Object
对类对象或给定对象实例的构造函数的引用。
Object
font:
String
使用此文本格式的文本的字体名称，以字符串形式表示。
TextFormat
indent:
Object
指示从左边距到段落中第一个字符的缩进。
TextFormat
italic:
Object
指示使用此文本格式的文本是否为斜体。
TextFormat
kerning:
Object
一个布尔值，指示是启用（true）还是禁用（false）字距调整。
TextFormat
leading:
Object
一个整数，表示行与行之间的垂直间距（称为前导）量。
TextFormat
leftMargin:
Object
段落的左边距，以像素为单位。
TextFormat
letterSpacing:
Object
一个数字，表示在所有字符之间均匀分配的空间量。
TextFormat
prototype:
Object
[静态]对类或函数对象的原型对象的引用。
Object
rightMargin:
Object
段落的右边距，以像素为单位。
TextFormat
size:
Object
使用此文本格式的文本的大小（以像素为单位）。
TextFormat
tabStops:
Array
将自定义Tab停靠位指定为一个非负整数的数组。
TextFormat
target:
String
指示显示超链接的目标窗口。
TextFormat
underline:
Object
指示使用此文本格式的文本是带下划线（true）还是不带下划线（false）。
TextFormat
url:
String
指示使用此文本格式的文本的目标URL。
TextFormat
公共方法
方法
定义方
TextFormat（font:
String=null,size:
Object=null,color:
Object=null,bold:
Object=null,italic:
Object=null,underline:
Object=null,url:
String=null,target:
String=null,align:
String=null,leftMargin:
Object=null,rightMargin:
Object=null,indent:
Object=null,leading:
Object=null）
创建一个具有指定属性的TextFormat对象。
TextFormat
hasOwnProperty（name:
String）:
Boolean
指示对象是否已经定义了指定的属性。
Object
isPrototypeOf（theClass:
Object）:
Boolean
指示Object类的实例是否在指定为参数的对象的原型链中。
Object
propertyIsEnumerable（name:
String）:
Boolean
指示指定的属性是否存在、是否可枚举。
Object
setPropertyIsEnumerable（name:
String,isEnum:
Boolean=true）:
void
设置循环操作动态属性的可用性。
Object
toString（）:
String
返回指定对象的字符串表示形式。
Object
valueOf（）:
Object
返回指定对象的原始值。
Object
属性详细信息
align
属性
align:
String [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
指示段落的对齐方式。
有效值为TextFormatAlign常量。
默认值为TextFormatAlign.LEFT
实现
publicfunctiongetalign（）:
String
publicfunctionsetalign（value:
String）:
void引发
ArgumentError—指定的align不是flash.text.TextFormatAlign的成员。
另请参见flash.text.TextFormatAlign
示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
blockIndent
属性
blockIndent:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
指示块缩进，以像素为单位。
块缩进应用于整个文本块，即文本的所有行。
而普通缩进（TextFormat.indent）只影响各段的第一行。
如果此属性为null，则TextFormat对象不指定块缩进（块缩进为0）。
实现
publicfunctiongetblockIndent（）:
Object
publicfunctionsetblockIndent（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
bold
属性
bold:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
指定文本是否为粗体字。
默认值为null，这意味着不使用粗体字。
如果值为true，则文本为粗体字。
实现
publicfunctiongetbold（）:
Object
publicfunctionsetbold（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
bullet
属性
bullet:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
指示文本为带项目符号的列表的一部分。
在带项目符号的列表中，文本的各段都是缩进的。
项目符号显示在各段第一行的左侧。
默认值为null，这意味着不使用带项目符号的列表。
实现
publicfunctiongetbullet（）:
Object
publicfunctionsetbullet（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
color
属性
color:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
指示文本的颜色。
包含三个8位RGB颜色成分的数字；例如，0xFF0000为红色，0x00FF00为绿色。
默认值为null，这意味着FlashPlayer使用黑色（0x000000）。
实现
publicfunctiongetcolor（）:
Object
publicfunctionsetcolor（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
font
属性
font:
String [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
使用此文本格式的文本的字体名称，以字符串形式表示。
默认值为null，这意味着FlashPlayer对文本使用TimesNewRoman字体。
实现
publicfunctiongetfont（）:
String
publicfunctionsetfont（value:
String）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
indent
属性
indent:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
指示从左边距到段落中第一个字符的缩进。
默认值为null，它指示不使用缩进。
实现
publicfunctiongetindent（）:
Object
publicfunctionsetindent（value:
Object）:
void
另请参见flash.text.TextFormat.blockIndent
示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
italic
属性
italic:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
指示使用此文本格式的文本是否为斜体。
默认值为null，这意味着不使用斜体。
实现
publicfunctiongetitalic（）:
Object
publicfunctionsetitalic（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
kerning
属性
kerning:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
一个布尔值，指示是启用（true）还是禁用（false）字距调整。
通过字距调整可为了提高可读性而调整某些字符对之间的像素，并且只在需要时（如使用大字体标题时）使用字距调整。
仅嵌入字体支持字距调整。
某些字体（如宋体）和等宽字体（如CourierNew）不支持字距调整。
默认值为null，这意味着没有启用字距调整。
实现
publicfunctiongetkerning（）:
Object
publicfunctionsetkerning（value:
Object）:
void
leading
属性
leading:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
一个整数，表示行与行之间的垂直间距（称为前导）量。
默认值为null，它指示使用的前导量为0。
实现
publicfunctiongetleading（）:
Object
publicfunctionsetleading（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
leftMargin
属性
leftMargin:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
段落的左边距，以像素为单位。
默认值为null，它指示左边距为0像素。
实现
publicfunctiongetleftMargin（）:
Object
publicfunctionsetleftMargin（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
letterSpacing
属性
letterSpacing:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
一个数字，表示在所有字符之间均匀分配的空间量。
该值指定在每个字符之后添加到进距的像素数。
默认值为null，这意味着使用的字母间距为0个像素。
可以使用十进制值，如1.75。
实现
publicfunctiongetletterSpacing（）:
Object
publicfunctionsetletterSpacing（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
rightMargin
属性
rightMargin:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
段落的右边距，以像素为单位。
默认值为null，它指示右边距为0像素。
实现
publicfunctiongetrightMargin（）:
Object
publicfunctionsetrightMargin（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
size
属性
size:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
使用此文本格式的文本的大小（以像素为单位）。
默认值为null，这意味着使用的大小为12。
实现
publicfunctiongetsize（）:
Object
publicfunctionsetsize（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
tabStops
属性
tabStops:
Array [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
将自定义Tab停靠位指定为一个非负整数的数组。
指定每个Tab停靠位，以像素为单位。
如果没有指定自定义Tab停靠位（null），则默认的Tab停靠位为4（平均字符宽度）。
实现
publicfunctiongettabStops（）:
Array
publicfunctionsettabStops（value:
Array）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
target
属性
target:
String [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
指示显示超链接的目标窗口。
如果目标窗口为空字符串，则文本显示在默认目标窗口_self中。
可以选择自定义名称或以下四种名称中的一个：
_self指定当前窗口中的当前帧，_blank指定一个新窗口，_parent指定当前帧的父级，_top指定当前窗口中的顶级帧。
如果TextFormat.url属性是空字符串或null，则虽然您可以获取或设置此属性，但该属性不起作用。
实现
publicfunctiongettarget（）:
String
publicfunctionsettarget（value:
String）:
void
另请参见flash.text.TextFormat.url
示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
underline
属性
underline:
Object [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
指示使用此文本格式的文本是带下划线（true）还是不带下划线（false）。
此下划线类似于用标签生成的下划线，但后者不是真正的下划线，因为它不能正确地跳过下行字符。
默认值为null，它指示不使用下划线。
实现
publicfunctiongetunderline（）:
Object
publicfunctionsetunderline（value:
Object）:
void示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
url
属性
url:
String [读写]
语言版本:
ActionScript3.0
运行时版本:
AIR1.0,FlashPlayer9.
指示使用此文本格式的文本的目标URL。
如果url属性为空字符串，则文本没有超链接。
默认值为null，它指示文本没有超链接。
注意：
必须使用htmlText属性对具有指定文本格式的文本进行设置以使超链接起作用。
实现
publicfunctiongeturl（）:
String
publicfunctionseturl（value:
String）:
void
另请参见flash.text.TextField.htmlText
示例
如何使用示例
有关如何使用此属性的说明，请参阅TextFormat（）构造函数示例。
构造函数详细信息
TextFormat
（）
构造函数
publicfunctionTextFormat（font:
String=null,size:
Object=null,color:
Object=null,bold:
Object=null,italic:
Object=null,underline:
Obje
升级会员 