mx.controls.textClasses
public class TextRange
继承TextRange Inheritance Object

TextRange 类提供在 Label、Text、TextArea、TextEditor 和 RichTextEditor 控件中选择和格式化文本范围的属性。

另请参见

mx.controls.Label
mx.controls.RichTextEditor
mx.controls.Text
mx.controls.TextArea
mx.controls.TextInput
flash.text.TextFormatAlign


公共属性
 属性定义方
  beginIndex : int
范围中第一个字符的控件文本字段中从零开始的索引。
TextRange
  bullet : Boolean
范围中的文本是否位于带项目符合的列表中。
TextRange
  color : Object
范围中文本的颜色。
TextRange
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  endIndex : int
紧随范围中最后一个字符位置的控件文本字段中从零开始的索引;等效于最后一个字符从一开始的索引。
TextRange
  fontFamily : String
范围中文本的字体名称。
TextRange
  fontSize : int
范围中文本的磅值。
TextRange
  fontStyle : String
范围中的字体样式,例如“italic”或“normal”。
TextRange
  fontWeight : String
范围中字体的粗细,例如“bold”或“normal”。
TextRange
  htmlText : String
HTML 格式文本范围的内容。
TextRange
  kerning : Boolean
一个布尔值,指示是启用 (true) 还是禁用 (false) 字距调整。
TextRange
  letterSpacing : Number
各字符之间显示的附加像素数。
TextRange
  modifiesSelection : Boolean
[只读 (read-only)] TextRange 是否修改当前所选的文本。
TextRange
  owner : UIComponent
包含文本的控件。
TextRange
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  text : String
范围的纯文本内容。
TextRange
  textAlign : String
范围中文本的对齐方式。
TextRange
  textDecoration : String
范围中字体的效果,例如“underline”或“normal”。
TextRange
  url : String
范围中超文本链接的 URL。
TextRange
公共方法
 方法定义方
  
TextRange(owner:UIComponent, modifiesSelection:Boolean = false, beginIndex:int = -1, endIndex:int = -1)
创建提供文本控件内容子集的新 TextRange Object,包括格式化信息。
TextRange
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信息
beginIndex属性
beginIndex:int  [读写]

范围中第一个字符的控件文本字段中从零开始的索引。如果文本中的第五个字符是范围中的第一个字符,则此属性的值为 4。



实现
    public function get beginIndex():int
    public function set beginIndex(value:int):void
bullet属性 
bullet:Boolean  [读写]

范围中的文本是否位于带项目符合的列表中。如果带项目符号的列表中仅包含此范围的一部分,则此值为 false



实现
    public function get bullet():Boolean
    public function set bullet(value:Boolean):void
color属性 
color:Object  [读写]

范围中文本的颜色。您可以使用任何有效的颜色标识符设置此值。属性将以数值形式返回此值。如果范围包含多种颜色,则此值为 null



实现
    public function get color():Object
    public function set color(value:Object):void
endIndex属性 
endIndex:int  [读写]

紧随范围中最后一个字符位置的控件文本字段中从零开始的索引;等效于最后一个字符从一开始的索引。如果文本中的第五个字符是范围中的最后一个字符,则此属性的值为 5。



实现
    public function get endIndex():int
    public function set endIndex(value:int):void
fontFamily属性 
fontFamily:String  [读写]

范围中文本的字体名称。如果范围包含多种字体,则此值为 null



实现
    public function get fontFamily():String
    public function set fontFamily(value:String):void
fontSize属性 
fontSize:int  [读写]

范围中文本的磅值。如果范围有多种大小,则此值为 0。



实现
    public function get fontSize():int
    public function set fontSize(value:int):void
fontStyle属性 
fontStyle:String  [读写]

范围中的字体样式,例如“italic”或“normal”。将属性设置为其它任何字符串都会生成正常样式。如果范围包含多种样式,则此值为 null



实现
    public function get fontStyle():String
    public function set fontStyle(value:String):void
fontWeight属性 
fontWeight:String  [读写]

范围中字体的粗细,例如“bold”或“normal”。将属性设置为其它任何字符串都会生成正常粗细。如果范围包含多种粗细,则此值为 null



实现
    public function get fontWeight():String
    public function set fontWeight(value:String):void
htmlText属性 
htmlText:String  [读写]

HTML 格式文本范围的内容。此属性返回范围内的所有 HTML 标签,包括 Flex 所应用的格式设置标签,而不仅是使用 htmlText 属性指定的 HTML。因此,此属性将出现在控件中,是文本完整的 HTML 表示形式。



实现
    public function get htmlText():String
    public function set htmlText(value:String):void
kerning属性 
kerning:Boolean  [读写]

一个布尔值,指示是启用 (true) 还是禁用 (false) 字距调整。通过字距调整可为了提高可读性而调整某些字符对之间的像素,并且只在需要时(如使用大字体标题时)使用字距调整。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。

默认值为 false.



实现
    public function get kerning():Boolean
    public function set kerning(value:Boolean):void
letterSpacing属性 
letterSpacing:Number  [读写]

各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。

默认值为 0.



实现
    public function get letterSpacing():Number
    public function set letterSpacing(value:Number):void
modifiesSelection属性 
modifiesSelection:Boolean  [只读 (read-only)]

TextRange 是否修改当前所选的文本。由构造函数设置。



实现
    public function get modifiesSelection():Boolean
owner属性 
owner:UIComponent  [读写]

包含文本的控件。所有者控件必须包含 textField 属性,或者像 RichTextEditor 控件一样包含 textArea 属性。RichTextEditor 控件中文本的所有者是 RichTextEditor 控件,而非其 TextArea 子控件。最初由构造函数设置。



实现
    public function get owner():UIComponent
    public function set owner(value:UIComponent):void
text属性 
text:String  [读写]

范围的纯文本内容。



实现
    public function get text():String
    public function set text(value:String):void
textAlign属性 
textAlign:String  [读写]

范围中文本的对齐方式。Flash.text.TextFormatAlign 常数将指定有效值。将此属性设置为其它任何值都不会产生影响。如果范围包含多种对齐方式,则此值为 null



实现
    public function get textAlign():String
    public function set textAlign(value:String):void

另请参见

textDecoration属性 
textDecoration:String  [读写]

范围中字体的效果,例如“underline”或“normal”。将属性设置为其它任何字符串都会生成正常文本。如果范围包含多种效果设置,则此值为 null



实现
    public function get textDecoration():String
    public function set textDecoration(value:String):void
url属性 
url:String  [读写]

范围中超文本链接的 URL。如果范围不包括链接,则此值是空字符串。如果范围包括多个链接,则此值为 null



实现
    public function get url():String
    public function set url(value:String):void
构造函数详细信息
TextRange()构造函数
public function TextRange(owner:UIComponent, modifiesSelection:Boolean = false, beginIndex:int = -1, endIndex:int = -1)

创建提供文本控件内容子集的新 TextRange Object,包括格式化信息。

参数
owner:UIComponent — 包含文本的控件。此控件必须包含 textField 属性,或者像 RichTextEditor 控件一样包含 textArea 属性。
 
modifiesSelection:Boolean (default = false) — 是否选择范围中的文本。如果将此参数设置为 true 并且不指定与控件中文本相对应的起始或结束索引,则 Flex 将使用当前文本选项的起始或结束索引。如果此参数为 true,您省略了 beginIndexendIndex 参数,并且不存在任何选项,则 TextRange 对象为空。
 
beginIndex:int (default = -1) — 范围中第一个字符从零开始的索引。如果 modifiesSelection 参数为 false,并且您省略此参数或指定了一个负值,则范围将从第一个文本字符开始。
 
endIndex:int (default = -1) — 范围中最后一个字符的位置从零开始的索引。如果 modifiesSelection 参数为 false,并且您省略此参数、指定了一个负值或指定的值超出文本结束范围,则范围将以最后一个文本字符结束。