TextRange

包	mx.controls.textClasses
类	public class TextRange
继承	TextRange Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		beginIndex : int 范围中第一个字符的控件文本字段中从零开始的索引。	TextRange
		bullet : Boolean 范围中的文本是否位于带项目符合的列表中。	TextRange
		color : Object 范围中文本的颜色。	TextRange
		constructor : 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 [只读] TextRange 是否修改当前所选的文本。	TextRange
		owner : UIComponent 包含文本的控件。	TextRange
		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
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

beginIndex

属性

beginIndex:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get beginIndex():int
public function set beginIndex(value:int):void

bullet

属性

bullet:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get bullet():Boolean
public function set bullet(value:Boolean):void

color

属性

color:Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get color():Object
public function set color(value:Object):void

endIndex

属性

endIndex:int

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get endIndex():int
public function set endIndex(value:int):void

fontFamily

属性

fontFamily:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

fontStyle

属性

fontStyle:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

fontWeight

属性

fontWeight:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

htmlText

属性

htmlText:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

kerning

属性

kerning:Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

默认值为 false。

实现
public function get kerning():Boolean
public function set kerning(value:Boolean):void

letterSpacing

属性

letterSpacing:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

默认值为 0。

实现
public function get letterSpacing():Number
public function set letterSpacing(value:Number):void

modifiesSelection

属性

modifiesSelection:Boolean [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get modifiesSelection():Boolean

owner

属性

owner:UIComponent

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

实现
public function get owner():UIComponent
public function set owner(value:UIComponent):void

text

属性

text:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

范围的纯文本内容。

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

textAlign

属性

textAlign:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

textDecoration

属性

textDecoration:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

url

属性

url:String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

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

构造函数详细信息

()

构造函数

public function TextRange(owner:UIComponent, modifiesSelection:Boolean = false, beginIndex:int = -1, endIndex:int = -1)

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

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

参数

	`owner:UIComponent` — 包含文本的控件。此控件必须包含 `textField` 属性，或者像 RichTextEditor 控件一样包含 `textArea` 属性。

	`modifiesSelection:Boolean` (default = `false`) — 是否选择范围中的文本。如果将此参数设置为 `true` 并且不指定与控件中文本相对应的起始或结束索引，则 Flex 将使用当前文本选项的起始或结束索引。如果此参数为 `true`，您省略了 `beginIndex` 和 `endIndex` 参数，并且不存在任何选项，则 TextRange 对象为空。

	`beginIndex:int` (default = `-1`) — 范围中第一个字符从零开始的索引。如果 `modifiesSelection` 参数为 `false`，并且您省略此参数或指定了一个负值，则范围将从第一个文本字符开始。

	`endIndex:int` (default = `-1`) — 范围中最后一个字符后的位置从零开始的索引。如果 `modifiesSelection` 参数为 `false`，并且您省略此参数、指定了一个负值或指定的值超出文本结束范围，则范围将以最后一个文本字符结束。

法律声明 | 在线隐私策略

TextRange - AS3 Flex

包x

语言元素

附录

包 mx.controls.textClasses

beginIndex

bullet

color

endIndex

fontFamily

fontSize

fontStyle

fontWeight

htmlText

kerning

letterSpacing

modifiesSelection

owner

text

textAlign

textDecoration

url

TextRange