| 包 | spark.components |
| 类 | public class RichEditableText |
| 继承 | RichEditableText  UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| 实现 | IFocusManagerComponent, IIMESupport, ISystemCursorClient, IViewport, IEditableText |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
 | Adobe 建议不要在使用 mobileDevice 配置文件的应用程序中使用此组件。 |
RichEditableText 为低级的 UIComponent，用于显示、滚动、选择和编辑各种格式的文本。
富文本可以包含可单击的超链接以及可嵌入或从 URL 加载的内嵌图形。
RichEditableText 不包含滚动条，但是可以实现用于以编程方式滚动的 IViewport 接口，这样可以由确实能够提供滚动条的 Scroller 控制。它还支持使用鼠标滚轮垂直滚动。
它不包括用于更改文本格式的任何用户界面。但是，它提供了可以通过编程方式执行此操作的 API；例如，这些 API 可以创建使所选文本变成粗体的 Bold 按钮。
该类用于 Spark 版本的 TextInput 和 TextArea 的外观。（TextInput 不显示处理富文本的功能，但 TextArea 可以。）默认情况下，RichEditableText 具有透明背景，但不支持绘制边框。
RichEditableText 使用 Text Layout Framework (TLF) 库，而该库又基于 Flash Player 10 中的 Flash 文本引擎 (FTE) 新版本。组合后，可以在这些层上使用高质量的国际印刷效果和布局编辑文本。
Spark 体系结构提供三个文本“原型”- Label、RichText 和 RichEditableText。Label 运行速度最快且占用内存最少，因为它仅使用 FTE，没有 TLF，但其功能有限：无富文本、不可滚动、不可选择、不可编辑。RichText 新增了使用复杂布局显示富文本的功能，但仍然完全是非交互式的。RichEditableText 占用内存最多，但是提供 TLF 可以执行的大部分功能。一般来说，请使用能够满足需求的最快速的文本原型。
RichEditableText 与用于 MX 组件的 UITextField 类相似。该类不使用 FTE 或 TLF，而是扩展了旧版 TextField 类。
UITextField 与 RichEditableText 之间最重要的区别在于：
- RichEditableText 可提供更佳的印刷效果和文本布局，且能更好地支持各国语言。
- RichEditableText 包含面向对象模型的富文本，而 UITextField 不包含。
- 在显示大量文本时，RichEditableText 性能表现得更好。
- RichEditableText 嵌入字体的方式与 UITextField 不同。嵌入字体时，请有关有关如何使用
embedAsCFF属性的文档。
RichEditableText 使用 TLF 面向对象模型的富文本，其中，诸如分段、段落、范围、超链接和图像等文本布局元素在运行时由 ActionScript 对象表示，可以通过编程方式访问和操纵该对象。TLF 中用于表示富文本的中心对象是 TextFlow，因此可以通过将要显示的 RichEditableText 控件的 textFlow 属性设置为 TextFlow 实例，来指定其富文本。有关如何创建 TextFlow（如通过导入 TLF 标记）的信息，请参阅 textFlow 属性的描述。如果不需要显示含有多种格式的文本，可使用 text 属性设置“纯文本”字符串。有关 text 属性和 textFlow 属性如何进行交互（例如，可以设置一个属性，然后获取另一个属性）的信息，请参阅这两个属性的描述。
编译时，可以将 TLF 标记标签放在 RichEditableText 标签内，如下例所示：
<s:RichEditableText>Hello <s:span fontWeight="bold">World!</s:span></s:RichEditableText>
在此示例中，MXML 编译器设置了 content 属性，从而导致基于所指定的 FlowElement 自动创建 TextFlow。
默认文本格式由 CSS 样式确定，例如 fontFamily 和 fontSize。TextFlow 中的任何格式信息都会覆盖 CSS 样式确定的默认格式。
使用 lineHeight 样式可以控制行间距；使用 paragraphSpaceBefore 和 paragraphSpaceAfter 样式可以控制段间距。可以使用 textAlign 和 textAlignLast 样式将文本对齐或两端对齐。可以使用 paddingLeft、paddingTop、paddingRight 和 paddingBottom 样式从组件边缘插入文本。
默认情况下，RichEditableText“自动调整大小”：最初不包含任何文本时非常小，随着文本的输入，其宽度不断增大直到 maxWidth。按 Enter 键开始新行时其高度增加。
通过 widthInChars 和 heightInLines 属性，可以采用随字体大小缩放的方式很方便地指定宽度和高度。也可以使用 typicalText 属性。请注意，如果使用 typicalText，则 widthInChars 和 heightInLines 将被忽略。还可以指定显式宽度或高度像素值，或者使用宽度和高度百分比值或各种约束（例如 left 和 right 或 top 和 bottom）。
当指定某种类型的宽度（无论是显式宽度或百分比宽度、maxWidth 还是 left 和 right 约束）时，文本将在组件的右边缘换行，且当文本超出组件宽度时垂直滚动查看。如果将 lineBreak 样式设置为 explicit，则仅在显式换行符处开始新行，例如，在 text 中使用 CR (\r)、LF (\n) 或 CR+LF (\r\n) 时，或者在 TLF 标记中使用 <p> 和 <br/> 时。在这些情况下，如果任何文本行的宽度超出了控件的范围，则可以水平滚动查看文本。
可以使用 maxChars 属性限制用户可以输入的字符数，使用 restrict 限制用户可以输入的字符。
multiline 属性确定了按 Enter 键后发生的操作。如果为 true，则按 Enter 键会开始一个新段落。如果为 false，则导致调度 FlexEvent.ENTER 事件。
如果不希望文本可编辑，请将 editable 属性设置为 false。如果甚至不希望文本可以进行选择，请将 selectable 属性设置为 false。
因为 RichEditableText 使用 TLF，所以它支持显示从左到右 (LTR) 书写的文本（如法语）、从右到左 (RTL) 书写的文本（如阿拉伯语）以及双向书写的文本（如阿拉伯语语句中的法语语句）。如果文本的主要书写方向为从右到左，请将 direction 样式设置为 rtl。textAlign 样式默认为 "start"，这样，当 direction 为 ltr 时，文本左对齐；当 direction 为 rtl 时，文本右对齐。要获得反向对齐，请将 textAlign 设置为 end。
使用 TLF 后，RichEditableText 支持在一个编辑会话内执行无限次撤消/重做操作。编辑会话在组件获得键盘焦点时启动，在组件失去焦点时结束。
RichEditableText 使用 TLF 的 TextContainerManager 类处理其文本显示、滚动、选择、编辑和上下文菜单。
要在基于列表的组件（如 List 或 DataGrid）中使用此组件，请创建项呈示器。有关创建项呈示器的信息，请参阅自定义 Spark 项呈示器。
MXML 语法
显示 MXML 语法
隐藏 MXML 语法The <s:RichEditableText> tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:RichEditableText
Properties
clipAndEnableScrolling="false|true"
contentHeight="Calculated default"
contentWidth="Calculated default"
displayAsPassword="false"
editable="true"
heightInLines="NaN"
horizontalScrollPosition="0"
imeMode="null"
maxChars="0"
multiline="true"
restrict="null"
selectable="true"
selectionActivePosition="-1"
selectionAnchorPosition="-1"
selectionHighlighting="TextSelectionHighlighting.WHEN_FOCUSED"
text=""
textFlow="TextFlow"
typicalText=null
verticalScrollPosition="0"
widthInChars="NaN"
Events
change="No default"
changing="No default"
enter="No default"
selectionChange="No default"
/>
默认 MXML 属性content
相关 API 元素
spark.components.RichText
spark.utils.TextFlowUtil
flashx.textLayout.container.TextContainerManager
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | accessibilityDescription : String
一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 description 属性。 | UIComponent | |
| accessibilityEnabled : Boolean
一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 silent 属性。 | UIComponent | |
| accessibilityImplementation : AccessibilityImplementation
InteractiveObject 实例的当前辅助功能实现 (AccessibilityImplementation)。 | InteractiveObject | |
| accessibilityName : String
一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 name 属性。 | UIComponent | |
| accessibilityProperties : AccessibilityProperties
此显示对象的当前辅助功能选项。 | DisplayObject | |
| accessibilityShortcut : String
一个方便的存取器，用于访问此 UIComponent 的 accessibilityProperties 对象的 shortcut 属性。 | UIComponent | |
| activeEffects : Array [只读]
组件上当前播放的效果列表，如 EffectInstance 实例的 Array。 | UIComponent | |
| alpha : Number
表示指定对象的 Alpha 透明度值。 | DisplayObject | |
| automationDelegate : Object
处理自动化相关功能的委托对象。 | UIComponent | |
| automationEnabled : Boolean [只读]
如果此组件启用了自动化，则为 true；否则为 false。 | UIComponent | |
| automationName : String
可用作此对象的标识符的名称。 | UIComponent | |
| automationOwner : DisplayObjectContainer [只读]
用于自动化目的的此组件的所有者。 | UIComponent | |
| automationParent : DisplayObjectContainer [只读]
用于自动化目的的此组件的父级。 | UIComponent | |
| automationTabularData : Object [只读]
IAutomationTabularData 接口的实现，可用于检索数据。 | UIComponent | |
| automationValue : Array [只读]
此值通常对应于对象的经呈示的外观，当对象在应用中以可视方式显示时，此值使标识符与该对象相关联。 | UIComponent | |
| automationVisible : Boolean [只读]
如果此组件对于自动化是可见的，则为 true；否则为 false。 | UIComponent | |
| baseline : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| baselinePosition : Number [只读]
组件第一行文本的基线的 y 坐标。 | UIComponent | |
| blendMode : String
BlendMode 类中的一个值，用于指定要使用的混合模式。 | DisplayObject | |
| blendShader : Shader [只写]
设置用于混合前景和背景的着色器。 | DisplayObject | |
| bottom : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| buttonMode : Boolean
指定此 sprite 的按钮模式。 | Sprite | |
| cacheAsBitmap : Boolean
如果设置为 true，则 Flash 运行时将缓存显示对象的内部位图表示形式。 | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
如果为非 null，则 Matrix 对象会定义显示对象在 cacheAsBitmap 设置为 true 时的呈现方式。 | DisplayObject | |
| cacheHeuristic : Boolean [只写]
供 Flex 使用，表示建议为对象实施位图缓存。 | UIComponent | |
| cachePolicy : String
指定此对象的位图缓存策略。 | UIComponent | |
| className : String [只读]
此实例的类的名称，如“Button”。 | UIComponent | |
| clipAndEnableScrolling : Boolean
如果为 true，指定将子代剪切到视区的边界。 | RichEditableText | ||
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| content : Object
该属性旨在编译时用于 MXML；在运行时获得或设置富文本内容并改用 textFlow 属性。 | RichEditableText | ||
| contentHeight : Number [只读]
文本高度。 | RichEditableText | ||
| contentMouseX : Number [只读]
返回鼠标在内容坐标系中的 x 位置。 | UIComponent | |
| contentMouseY : Number [只读]
返回内容坐标系中鼠标的 y 位置。 | UIComponent | |
| contentWidth : Number [只读]
文本的宽度。 | RichEditableText | ||
| contextMenu : NativeMenu
指定与此对象相关联的上下文菜单。 | InteractiveObject | |
| currentState : String
组件的当前视图状态。 | UIComponent | |
| cursorManager : ICursorManager [只读]
获取控制此组件及其同级组件的光标的 CursorManager。 | UIComponent | |
| depth : Number
确定容器内各项目的呈示顺序。 | UIComponent | |
| descriptor : UIComponentDescriptor
引用 UIComponentDescriptor（如果有），过去曾通过 createComponentFromDescriptor() 方法使用它来创建此 UIComponent 实例。 | UIComponent | |
| designLayer : DesignLayer
指定与该可视元素关联的可选 DesignLayer 实例。 | UIComponent | |
| displayAsPassword : Boolean
指定文本字段是否是密码文本字段。 | RichEditableText | ||
| document : Object
引用与此 UIComponent 相关联的文档对象。 | UIComponent | |
| doubleClickEnabled : Boolean [覆盖]
指定 UIComponent 对象是否接收 doubleClick 事件。 | UIComponent | |
| dropTarget : DisplayObject [只读]
指定拖动 sprite 时经过的显示对象，或放置 sprite 的显示对象。 | Sprite | |
| editable : Boolean
指示用户是否可以编辑此控件中的文本的标志。 | RichEditableText | ||
| enabled : Boolean
组件是否可以接受用户交互。 | UIComponent | |
| enableIME : Boolean [只读]
一个标志，用于指示当组件获得焦点时是否应启用 IME。 | RichEditableText | ||
| errorString : String
当验证程序监视组件并且验证失败时，组件的错误提示中将显示的文本。 | UIComponent | |
| explicitHeight : Number
指定该组件在组件坐标中显式高度（以像素为单位）的数字。 | UIComponent | |
| explicitMaxHeight : Number
布局过程中父级要考虑的组件最大建议高度。 | UIComponent | |
| explicitMaxWidth : Number
布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | |
| explicitMinHeight : Number
布局过程中父级要考虑的组件最小建议高度。 | UIComponent | |
| explicitMinWidth : Number
布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | |
| explicitWidth : Number
指定该组件在组件坐标中显式宽度（以像素为单位）的数字。 | UIComponent | |
| filters : Array
包含当前与显示对象关联的每个滤镜对象的索引数组。 | DisplayObject | |
| flexContextMenu : IFlexContextMenu
此 UIComponent 的上下文菜单。 | UIComponent | |
| focusEnabled : Boolean
指示切换到此组件时，是否可以获得焦点。 | UIComponent | |
| focusManager : IFocusManager
获取控制此组件及其同级组件的焦点的 FocusManager。 | UIComponent | |
| focusPane : Sprite
与此对象相关联的焦点窗格。 | UIComponent | |
| focusRect : Object
指定此对象是否显示焦点矩形。 | InteractiveObject | |
| graphics : Graphics [只读]
指定属于此 sprite 的 Graphics 对象，在此 sprite 中可执行矢量绘图命令。 | Sprite | |
| hasFocusableChildren : Boolean
一个标志，指示子对象是否能够获得焦点。 | UIComponent | |
| hasLayoutMatrix3D : Boolean [只读]
如果元素具有 3D 矩阵，则为 true。 | UIComponent | |
| height : Number [覆盖]
指定组件在父坐标中的高度的数字（以像素为单位）。 | UIComponent | |
| heightInLines : Number
控件的默认高度（以行为单位测量）。 | RichEditableText | ||
| hitArea : Sprite
指定一个 sprite 用作另一个 sprite 的点击区域。 | Sprite | |
| horizontalCenter : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| horizontalScrollPosition : Number
文本水平滚动的像素数。 | RichEditableText | ||
| id : String
组件 ID。 | UIComponent | |
| imeMode : String
指定 IME（输入法编辑器）模式。 | RichEditableText | ||
| includeInLayout : Boolean
指定此组件是否包含在父容器的布局中。 | UIComponent | |
| inheritingStyles : Object
此组件的继承样式链的开头内容。 | UIComponent | |
| initialized : Boolean
一个标志，用于确定某个对象是否已通过布局的所有三个阶段：提交、测量和布局（假设每个阶段都是必需的）。 | UIComponent | |
| instanceIndex : int [只读]
重复组件的索引。 | UIComponent | |
| instanceIndices : Array
一个 Array，包含从此 UIComponent 对象的父文档引用该对象所需的索引。 | UIComponent | |
| is3D : Boolean [只读]
当元素为 3D 时，则为 true。 | UIComponent | |
| isDocument : Boolean [只读]
如果此 UIComponent 实例为文档对象，则为 true。 | UIComponent | |
| isPopUp : Boolean
PopUpManager 将其设置为 true 以指示已弹出该组件。 | UIComponent | |
| layoutMatrix3D : Matrix3D [只写]
用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | |
| left : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| loaderInfo : LoaderInfo [只读]
返回一个 LoaderInfo 对象，其中包含加载此显示对象所属的文件的相关信息。 | DisplayObject | |
| maintainProjectionCenter : Boolean
如果为 true，则该组件将使其投影矩阵在其边框的中央保持居中。 | UIComponent | |
| mask : DisplayObject
调用显示对象被指定的 mask 对象遮罩。 | DisplayObject | |
| maxChars : int
文本字段中最多可包含的字符数（即用户输入的字符数）。 | RichEditableText | ||
| maxHeight : Number
布局过程中父级要考虑的组件最大建议高度。 | UIComponent | |
| maxWidth : Number
布局过程中父级要考虑的组件最大建议宽度。 | UIComponent | |
| measuredHeight : Number
组件的默认高度（以像素为单位）。 | UIComponent | |
| measuredMinHeight : Number
组件的默认最小高度（以像素为单位）。 | UIComponent | |
| measuredMinWidth : Number
组件的默认最小宽度（以像素为单位）。 | UIComponent | |
| measuredWidth : Number
组件的默认宽度（以像素为单位）。 | UIComponent | |
| metaData : Object
如果元数据是通过 PlaceObject4 标记与此 DisplayObject 的实例一起存储在 SWF 文件中的，则获取 DisplayObject 实例的元数据对象。 | DisplayObject | |
| minHeight : Number
布局过程中父级要考虑的组件最小建议高度。 | UIComponent | |
| minWidth : Number
布局过程中父级要考虑的组件最小建议宽度。 | UIComponent | |
| moduleFactory : IFlexModuleFactory
模块工厂用作上下文，用于为此组件使用嵌入字体以及查找用于控制此组件样式的样式管理器。 | UIComponent | |
| mouseChildren : Boolean
确定对象的子级是否支持鼠标或用户输入设备。 | DisplayObjectContainer | |
| mouseEnabled : Boolean
指定此对象是否接收鼠标或其他用户输入、消息。 | InteractiveObject | |
| mouseFocusEnabled : Boolean
单击时是否可获得焦点。 | UIComponent | |
| mouseX : Number [只读]
表示此鼠标或用户输入设备位置的 x 坐标，以像素为单位。 | DisplayObject | |
| mouseY : Number [只读]
表示此鼠标或用户输入设备位置的 y 坐标，以像素为单位。 | DisplayObject | |
| multiline : Boolean
确定用户是否可以输入多行文本。 | RichEditableText | ||
| name : String
表示 DisplayObject 的实例名称。 | DisplayObject | |
| needsSoftKeyboard : Boolean
指定当该 InteractiveObject 实例获得焦点时，是否显示虚拟键盘（显示在屏幕上的软键盘）。 | InteractiveObject | |
| nestLevel : int
此对象在所属关系层次结构中的深度。 | UIComponent | |
| nonInheritingStyles : Object
此组件的非继承样式链的开头内容。 | UIComponent | |
| numAutomationChildren : int [只读]
此容器包含的自动化子项数。 | UIComponent | |
| numChildren : int [只读]
返回此对象的子项数目。 | DisplayObjectContainer | |
| opaqueBackground : Object
指定显示对象是否由于具有某种背景颜色而不透明。 | DisplayObject | |
| owner : DisplayObjectContainer
此 IVisualElement 对象的所有者。 | UIComponent | |
| parent : DisplayObjectContainer [覆盖] [只读]
此组件的父容器或组件。 | UIComponent | |
| parentApplication : Object [只读]
引用包含此 UIComponent 实例的 Application 对象。 | UIComponent | |
| parentDocument : Object [只读]
引用此 UIComponent 的父文档对象。 | UIComponent | |
| percentHeight : Number
以组件父代大小百分比的方式指定组件高度。 | UIComponent | |
| percentWidth : Number
以组件父代大小百分比的方式指定组件宽度。 | UIComponent | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
定义能够应用于对象转换且在一定程度上对其父布局不可视的一组调整。 | UIComponent | |
| processedDescriptors : Boolean
临时或延迟子项创建操作后设置为 true，具体取决于发生对象。 | UIComponent | |
| repeater : IRepeater [只读]
对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | |
| repeaterIndex : int [只读]
项目在生成此 UIComponent 的 Repeater 数据提供程序中的索引。 | UIComponent | |
| repeaterIndices : Array
一个 Array，包含项目在生成此 UIComponent 的父文档的 Repeater 数据提供程序中的索引。 | UIComponent | |
| repeaters : Array
一个 Array，包含对生成此 UIComponent 的父文档中 Repeater 对象的引用。 | UIComponent | |
| restrict : String
表示用户可输入到文本字段中的字符集。 | RichEditableText | ||
| right : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| root : DisplayObject [只读]
对于加载的 SWF 文件中的显示对象，root 属性是此 SWF 文件所表示的显示列表树结构部分中的顶级显示对象。 | DisplayObject | |
| rotation : Number [覆盖]
表示 DisplayObject 实例距其原始方向的旋转程度，以度为单位。 | UIComponent | |
| rotationX : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。 | UIComponent | |
| rotationY : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。 | UIComponent | |
| rotationZ : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 z 轴旋转（以度为单位）。 | UIComponent | |
| scale9Grid : Rectangle
当前有效的缩放网格。 | DisplayObject | |
| scaleX : Number [覆盖]
用于指定水平缩放系数的数字。 | UIComponent | |
| scaleY : Number [覆盖]
用于指定垂直缩放系数的数字。 | UIComponent | |
| scaleZ : Number [覆盖]
指定沿着 z 轴的缩放因子的数值。 | UIComponent | |
| screen : Rectangle [只读]
返回包含此对象的基本绘图表面大小和位置的对象。 | UIComponent | |
| scrollRect : Rectangle
显示对象的滚动矩形范围。 | DisplayObject | |
| selectable : Boolean
一个标志，指示是用鼠标选择内容，还是用键盘选择内容（当控件具有键盘焦点时）。 | RichEditableText | ||
| selectionActivePosition : int [只读]
相对于 text 字符串开头的字符位置，用于指定用箭头键扩展选区时该选区的终点。 | RichEditableText | ||
| selectionAnchorPosition : int [只读]
相对于 text 字符串开头的字符位置，用于指定用箭头键扩展选区时该选区保持固定的终点。 | RichEditableText | ||
| selectionHighlighting : String
确定何时加亮选择的文本。 | RichEditableText | ||
| showInAutomationHierarchy : Boolean
用于确定自动化对象是否显示在自动化层次中的标志。 | UIComponent | |
| showSystemCursor : Boolean [只读]
如果鼠标滑过组件时应始终显示系统光标，则此属性为 true。 | RichEditableText | ||
| softKeyboard : String
控制软键盘的外观。 | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
定义当显示软键盘时应在屏幕上保留的区域（在 iOS 上不支持）。 | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
控制此 sprite 中的声音。 | Sprite | |
| stage : Stage [只读]
显示对象的舞台。 | DisplayObject | |
| states : Array
为此组件定义的视图状态。 | UIComponent | |
| styleDeclaration : CSSStyleDeclaration
存储此对象的内嵌继承样式。 | UIComponent | |
| styleManager : IStyleManager2 [只读]
返回此组件使用的 StyleManager 实例。 | UIComponent | |
| styleName : Object
此组件使用的类样式。 | UIComponent | |
| styleParent : IAdvancedStyleClient
组件的父项用于评估后代选择器。 | UIComponent | |
| systemManager : ISystemManager
返回此组件使用的 SystemManager 对象。 | UIComponent | |
| tabChildren : Boolean
确定对象的子项是否支持 Tab 键。 | DisplayObjectContainer | |
| tabEnabled : Boolean
指定此对象是否遵循 Tab 键顺序。 | InteractiveObject | |
| tabFocusEnabled : Boolean
一个标志，指示该对象是否能够通过 Tab 键获得焦点。这与 Flash Player 使用的 tabEnabled 属性类似。对于处理键盘输入的组件该标志通常为 true，但是控件栏中的一些组件将其设置为 false，因为它们不能像编辑器一样从另外的组件窃取焦点。 | UIComponent | |
| tabIndex : int
指定 SWF 文件中的对象按 Tab 键顺序排列。 | InteractiveObject | |
| text : String
此组件所显示的 text 字符串。 | RichEditableText | ||
| textFlow : flashx.textLayout.elements:TextFlow
用于表示该组件显示的富文本的 TextFlow。 | RichEditableText | ||
| textSnapshot : flash.text:TextSnapshot [只读]
返回此 DisplayObjectContainer 实例的 TextSnapshot 对象。 | DisplayObjectContainer | |
| toolTip : String
要在 ToolTip 中显示的文本。 | UIComponent | |
| top : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| transform : flash.geom:Transform [覆盖]
一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。 | UIComponent | |
| transformX : Number
设置组件转换中心的 x 坐标。 | UIComponent | |
| transformY : Number
设置组件转换中心的 y 坐标。 | UIComponent | |
| transformZ : Number
设置组件转换中心的 z 坐标。 | UIComponent | |
| transitions : Array
一个 Transition 对象 Array，其中的每个 Transition 对象都定义一组效果，用于在视图状态发生更改时播放。 | UIComponent | |
| tweeningProperties : Array
当前在此对象上进行补间的属性数组。 | UIComponent | |
| typicalText : String
用于不实际显示即可确定控件的默认宽度和高度的文本。 | RichEditableText | ||
| uid : String
对象的唯一标识符。 | UIComponent | |
| updateCompletePendingFlag : Boolean
一个标志，确定某个对象是否已通过所有三个阶段的布局验证（假设需要通过所有验证）。 | UIComponent | |
| useHandCursor : Boolean
布尔值，表示当指针滑过 buttonMode 属性设置为 true 的 sprite 时是否显示指针手形（手形光标）。 | Sprite | |
| validationSubField : String
供验证程序用来将子字段与此组件相关联。 | UIComponent | |
| verticalCenter : Object
对于组件，此布局约束属性是基于类似命名的样式的外观。 | UIComponent | |
| verticalScrollPosition : Number
文本垂直滚动的像素数。 | RichEditableText | ||
| visible : Boolean [覆盖]
显示对象是否可见。 | UIComponent | |
| width : Number [覆盖]
指定组件在父坐标中的宽度的数字（以像素为单位）。 | UIComponent | |
| widthInChars : Number
控件的默认宽度（使用 em 单位测量）。 | RichEditableText | ||
| x : Number [覆盖]
指定组件在其父容器中的水平位置（以像素为单位）的数字。 | UIComponent | |
| y : Number [覆盖]
指定组件在其父容器中的垂直位置（以像素为单位）的数字。 | UIComponent | |
| z : Number [覆盖]
表示 DisplayObject 实例相对于 3D 父容器沿 z 轴的 z 坐标位置。 | UIComponent | |
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构造函数。 | RichEditableText | ||
|
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
|
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
|
将非可视样式客户端添加到该组件实例。 | UIComponent | |
将指定文本追加到 RichEditableText 的结尾，就好像您已在该结尾处单击并键入它一样。 | RichEditableText | ||
|
表示安全限制是否会导致出现以下情况：在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | |
|
排队稍后调用的函数。 | UIComponent | |
|
删除此组件实例的样式属性。 | UIComponent | |
|
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | |
|
将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | |
|
将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | |
|
返回标识此容器中的子项的一组属性。 | UIComponent | |
|
返回标识此容器中的子项的一组属性。 | UIComponent | |
|
在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | |
|
在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | |
|
返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | |
| [覆盖]
将事件调度到事件流中。 | UIComponent | |
|
在此组件周围显示或隐藏焦点指示符。 | UIComponent | |
| drawRoundRect(x:Number, y:Number, w:Number, h:Number, r:Object = null, c:Object = null, alpha:Object = null, rot:Object = null, gradient:String = null, ratios:Array = null, hole:Object = null):void
通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | |
|
停止在组件上播放效果实例时，由效果实例调用。 | UIComponent | |
|
开始在组件上播放效果实例时，由效果实例调用。 | UIComponent | |
|
结束组件上当前播放的所有效果。 | UIComponent | |
|
执行 UIComponent 对象是目标的所有绑定。 | UIComponent | |
|
打印完成后调用。 | UIComponent | |
|
在指定的索引位置提供自动化对象。 | UIComponent | |
|
提供自动化对象列表。 | UIComponent | |
|
返回一个矩形，该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | |
|
按指定的元素大小，返回元素边界的 x 坐标。 | UIComponent | |
|
按指定的元素大小，返回元素边界的 y 坐标。 | UIComponent | |
|
返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | |
|
返回具有指定名称的子显示对象。 | DisplayObjectContainer | |
|
返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | |
|
查找此 UIComponent 实例的类型选择器。 | UIComponent | |
|
返回一个约束布局值，这与获取此组件的约束样式的方式类似。 | UIComponent | |
|
确定是使用显式高度还是测量高度的一种简便方法
| UIComponent | |
|
确定是使用显式宽度还是测量宽度的一种简便方法
| UIComponent | |
|
获取当前具有焦点的对象。 | UIComponent | |
getFormatOfRange(requestedFormats:Vector.<String> = null, anchorPosition:int = -1, activePosition:int = -1):flashx.textLayout.formats:TextLayoutFormat
返回 TextLayoutFormat 对象，用于为指定范围的字符指定计算格式。 | RichEditableText | ||
返回要添加到视域的当前 horizontalScrollPosition 的数量，以按请求的滚动单位进行滚动。 | RichEditableText | ||
|
返回元素的布局高度。 | UIComponent | |
|
返回元素的布局宽度。 | UIComponent | |
|
返回元素在屏幕上进行绘制时所用的 x 坐标。 | UIComponent | |
|
返回元素在屏幕上进行绘制时所用的 y 坐标。 | UIComponent | |
|
返回用于相对于其同级组件计算组件的布局的转换矩阵。 | UIComponent | |
|
返回此元素的布局转换 Matrix3D。 | UIComponent | |
|
返回元素的最大高度。 | UIComponent | |
|
返回元素的最大宽度。 | UIComponent | |
|
返回元素的最小高度。 | UIComponent | |
|
返回元素的最小宽度。 | UIComponent | |
|
返回对象的数组，这些对象位于指定点下，并且是该 DisplayObjectContainer 实例的子项（或孙子项，依此类推）。 | DisplayObjectContainer | |
|
返回元素的首选高度。 | UIComponent | |
|
返回元素的首选宽度。 | UIComponent | |
|
返回一个矩形，该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界，但不包括形状上的任何笔触。 | DisplayObject | |
|
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目；如果此 Repeater 未重复，则返回 null。 | UIComponent | |
|
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | |
返回要添加到视域的当前 verticalScrollPosition 的数量，以按请求的滚动单位进行滚动。 | RichEditableText | ||
|
将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | |
|
将 point 对象从舞台（全局）坐标转换为显示对象的（本地）坐标。 | DisplayObject | |
|
将二维点从舞台（全局）坐标转换为三维显示对象的（本地）坐标。 | DisplayObject | |
|
如果 currentCSSState 不为 null，则返回 true。 | UIComponent | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
确定是否已在此 UIComponent 上定义指定的状态。 | UIComponent | |
|
计算显示对象的边框，以确定它是否与 obj 显示对象的边框重叠或相交。 | DisplayObject | |
|
计算显示对象，以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | |
|
返回一个框 Matrix，在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | |
|
初始化此组件的内部结构。 | UIComponent | |
|
初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | |
将指定的文本插入到 RichEditableText，就好像您已键入它一样。 | RichEditableText | ||
|
标记组件，以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | |
|
由某个组件的项目进行调用，以指示其 depth 属性已更改。 | UIComponent | |
|
当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时，该元素必须调用该方法。 | UIComponent | |
|
标记组件，以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | |
|
标记组件，以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
将三维显示对象的（本地）坐标的三维点转换为舞台（全局）坐标中的二维点。 | DisplayObject | |
|
将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | |
|
将 point 对象从显示对象的（本地）坐标转换为舞台（全局）坐标。 | DisplayObject | |
|
如果 cssState 与 currentCSSState 匹配，则返回 true。 | UIComponent | |
|
确定此实例与给定类型相同，还是属于给定类型的子类。 | UIComponent | |
|
测量指定的 HTML 文本（该文本中可能包含 <font> 和 <b> 等 HTML 标签），假定该文本显示在单行 UITextField（使用由此 UIComponent 的样式确定的 UITextFormat）中。 | UIComponent | |
|
测量指定的文本，假定该文本使用由此 UIComponent 的样式确定的 UITextFormat 显示在单行 UITextField（或 UIFTETextField）中。 | UIComponent | |
|
将组件移动到其父项内的指定位置。 | UIComponent | |
|
将样式更改传播到子项。 | UIComponent | |
|
如果 owner 属性链从 child 指向此 UIComponent，则返回 true。 | UIComponent | |
|
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | |
|
准备 IFlexDisplayObject 用于打印。 | UIComponent | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
为此组件及其所有后代生成或重新生成 CSS 样式缓存，前提条件是递归参数为 true。 | UIComponent | |
|
针对每个效果事件，将 EffectManager 注册为一个事件侦听器。 | UIComponent | |
|
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | |
|
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | |
|
从 DisplayObjectContainer 实例的子级列表中删除所有子 DisplayObject 实例。 | DisplayObjectContainer | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
|
从该组件实例删除非可视样式客户端。 | UIComponent | |
|
重放指定的事件。 | UIComponent | |
|
显示虚拟键盘。 | InteractiveObject | |
|
使用提供的 ID 解析子项。 | UIComponent | |
| [静态]
在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | |
允许滚动，使文本范围在容器中可见。 | RichEditableText | ||
选择所有文本。 | RichEditableText | ||
选择指定范围的字符。 | RichEditableText | ||
|
调整对象大小。 | UIComponent | |
|
更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | |
|
设置一个布局约束值的方式，与设置此组件的约束样式的方式相同。 | UIComponent | |
|
设置当前状态。 | UIComponent | |
|
设置此组件的焦点。 | UIComponent | |
setFormatOfRange(format:flashx.textLayout.formats:TextLayoutFormat, anchorPosition:int = -1, activePosition:int = -1):void
将指定的格式应用于指定范围中的每个元素，以与所给定的格式相对应。 | RichEditableText | ||
|
设置元素在屏幕上进行绘制时所用的坐标。 | UIComponent | |
|
设置元素的布局大小。 | UIComponent | |
|
设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。 | UIComponent | |
|
设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。 | UIComponent | |
|
设置循环操作动态属性的可用性。 | Object | |
|
对此组件实例设置样式属性。 | UIComponent | |
|
当 visible 属性发生更改时调用。 | UIComponent | |
|
允许用户拖动指定的 Sprite。 | Sprite | |
|
使用户可以在启用触摸的设备上拖动指定的 Sprite。 | Sprite | |
|
对源起于此对象的所有 MovieClip 递归停止时间轴执行。 | DisplayObjectContainer | |
|
结束 startDrag() 方法。 | Sprite | |
|
结束 startTouchDrag() 方法，用于启用触摸的设备。 | Sprite | |
[覆盖]
检测对样式属性的更改。 | RichEditableText | ||
[覆盖]
首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。 | RichEditableText | ||
| [静态]
阻止对使用 callLater() 排队的方法进行背景处理，直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | |
|
交换两个指定子对象的 Z 轴顺序（从前到后顺序）。 | DisplayObjectContainer | |
|
在子级列表中两个指定的索引位置，交换子对象的 Z 轴顺序（前后顺序）。 | DisplayObjectContainer | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
| [覆盖]
返回一个字符串，用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | |
| transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
用于更新转换的旋转、缩放和平移的一种实用程序方法，同时保留某个特定点，该点是在组件自己的坐标空间中指定的，且在父项的坐标空间中是固定的。 | UIComponent | |
|
一种实用程序方法，用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。 | UIComponent | |
|
验证子项的位置和大小，并绘制其他可视内容。 | UIComponent | |
|
验证并更新此对象的属性和布局，如果需要的话重绘对象。 | UIComponent | |
|
由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | |
|
如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法，随后在测量时调用了 validateSize() 方法，则验证组件的度量大小。 | UIComponent | |
|
处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | |
|
返回指定对象的原始值。 | Object | |
|
返回一个框 Matrix，在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
| 事件 | 摘要 | 由以下参数定义 | ||
|---|---|---|---|---|
| [广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。 | EventDispatcher | ||
| 当组件通过使用 addChild()、addChildAt()、addElement() 或 addElementAt() 方法作为内容子项添加到容器后调度。 | UIComponent | ||
| 将显示对象添加到显示列表中时调度。 | DisplayObject | ||
| 在将显示对象直接添加到舞台显示列表或将包含显示对象的子树添加至舞台显示列表中时调度。 | DisplayObject | ||
| 在用户编辑操作完成后调度。 | RichEditableText | |||
| 在用户编辑操作发生前调度。 | RichEditableText | |||
| 当用户从文本上下文菜单中选择“清除”（或“删除”）时调度。 | InteractiveObject | ||
| 用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。 | InteractiveObject | ||
| 当用户手势触发 AIR 应用程序中与此交互式对象相关联的上下文菜单时调度。 | InteractiveObject | ||
| 在用户为复制操作激活特定于平台的加速键组合或从文本上下文菜单中选择“复制”时调度。 | InteractiveObject | ||
| 当组件完成其构建、属性处理、测量、布置和绘制时调度。 | UIComponent | ||
| 视图状态更改后调度。 | UIComponent | ||
| 在 currentState 属性更改后但视图状态更改前调度。 | UIComponent | ||
| 在用户为剪切操作激活特定于平台的加速键组合或从文本上下文菜单中选择“剪切”时调度。 | InteractiveObject | ||
| [广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。 | EventDispatcher | ||
| 如果 InteractiveObject 的 doubleClickEnabled 标志设置为 true，当用户在该对象上快速连续按下两次并释放指针设备的主按钮时调度。 | InteractiveObject | ||
| 在拖动操作完成时（将拖动的数据放到放置目标时或在没有执行放置操作的情况下结束拖放操作时）由拖动启动器（作为要拖动的数据源的组件）调度。 | UIComponent | ||
| 用户在放置目标上释放鼠标时由放置目标调度。 | UIComponent | ||
| 当用户在拖动操作过程中将鼠标移动到某个组件所处的位置时，由该组件调度。 | UIComponent | ||
| 用户在组件外拖动但没有将数据放置到目标时，由组件调度。 | UIComponent | ||
| 在拖动操作期间，当用户在鼠标位于组件上方的情况下移动鼠标时，由组件调度。 | UIComponent | ||
| 启动拖动操作时，由拖动启动器调度。 | UIComponent | ||
| 在一个效果结束后调度。 | UIComponent | ||
| 在即将开始播放效果前调度。 | UIComponent | ||
| 在停止某个效果（仅当对该效果调用 stop() 时发生）之后调度。 | UIComponent | ||
| 如果 multiline 属性为 false，当用户按 Enter 键时调度。 | RichEditableText | |||
| [播放事件] 播放头进入新帧时调度。 | DisplayObject | ||
| 在组件已进入视图状态之后调度。 | UIComponent | ||
| [广播事件] 播放头退出当前帧时调度。 | DisplayObject | ||
| 在组件即将退出视图状态之前调度。 | UIComponent | ||
| 显示对象获得焦点后调度。 | InteractiveObject | ||
| 显示对象失去焦点后调度。 | InteractiveObject | ||
| [广播事件] 在帧显示对象的构造函数运行之后但在帧脚本运行之前调度。 | DisplayObject | ||
| 当用户使用 InteractiveObject 实例沿触摸面边缘创建接触点时调度（如在 Siri Remote for Apple TV 上沿触摸面边缘轻击）。有些设备也可能将这种接触解释为多个触摸事件的组合。 | InteractiveObject | ||
| 当用户在启用触摸设备上的同一 InteractiveObject 实例上按下两个接触点时（例如，在配有触摸屏的移动电话或平板电脑上的显示对象上按下和释放两个手指）调度。 | InteractiveObject | ||
| 当用户在启用触摸的设备上的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上的显示对象上从左向右移动手指）调度。 | InteractiveObject | ||
| 当用户在接触点处使用 InteractiveObject 实例执行旋转手势时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或平板电脑上的显示对象上旋转这两个手指）调度。 | InteractiveObject | ||
| 当用户在接触点处使用 InteractiveObject 实例执行滑动手势（例如，在配有触摸屏的移动电话或平板电脑上用三根手指触摸屏幕，然后在一个显示对象上平行移动这三根手指）时调度。 | InteractiveObject | ||
| 当用户使用 InteractiveObject 实例创建接触点，然后点击启用触屏的设备时（例如，将几个手指放在显示对象上以打开菜单，然后点击一个手指在配有触摸屏的移动电话或平板电脑上选择一个菜单项）调度。 | InteractiveObject | ||
| 当用户在接触点处使用 InteractiveObject 实例执行缩放手势操作时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或平板电脑上的显示对象上快速分开手指）调度。 | InteractiveObject | ||
| 当对象的状态从可见变为不可见时调度。 | UIComponent | ||
| 此事件被调度到任何支持使用 IME 进行内联输入的客户端应用程序 | InteractiveObject | ||
| 当组件完成构建并设置了所有初始化属性后调度。 | UIComponent | ||
| 当组件由 Validator 监控且未通过验证时调度。 | UIComponent | ||
| 用户按下某个键时调度。 | InteractiveObject | ||
| 用户尝试使用键盘导航更改焦点时调度。 | InteractiveObject | ||
| 用户释放某个键时调度。 | InteractiveObject | ||
| 当用户在同一 InteractiveObject 上按下并释放用户指针设备的中间按钮时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上按下指针设备的中间按钮时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | ||
| 当用户在使用 PopUpManager 打开的某个组件外部单击时，从该组件调度。 | UIComponent | ||
| 用户尝试使用指针设备更改焦点时调度。 | InteractiveObject | ||
| 用户移动 InteractiveObject 上的指针设备时调度。 | InteractiveObject | ||
| 用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | ||
| 用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
| 当鼠标滚轮滚动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
| 当用户使用鼠标滚轮滚动到使用 PopUpManager 打开的某个组件外部时，从该组件调度。 | UIComponent | ||
| 移动对象后调度。 | UIComponent | ||
| 当用户释放拖动手势时由拖动启动器 InteractiveObject 调度。 | InteractiveObject | ||
| 在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时，由目标 InteractiveObject 调度。 | InteractiveObject | ||
| 当拖动手势进入其边界时由 InteractiveObject 调度。 | InteractiveObject | ||
| 当拖动手势离开其边界时由 InteractiveObject 调度。 | InteractiveObject | ||
| 当拖动手势保持在其边界内时，由 InteractiveObject 持续调度。 | InteractiveObject | ||
| 在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | ||
| 在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。 | InteractiveObject | ||
| 在用户为粘贴操作激活特定于平台的加速键组合或从文本上下文菜单中选择“粘贴”时调度。 | InteractiveObject | ||
| 在组件初始化序列开始时调度。 | UIComponent | ||
| 当用户将活动笔针放低经过屏幕的邻近检测阈值上时调度。 | InteractiveObject | ||
| 当用户将活动笔针抬高放在屏幕的邻近检测阈值上时调度。 | InteractiveObject | ||
| 当用户将活动笔针移动到屏幕上但仍保留在邻近检测阈值中时调度。 | InteractiveObject | ||
| 当用户直接将活动笔针从此 InteractiveObject 上移开但仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | ||
| 当用户直接将活动笔针移动到此 InteractiveObject 上但仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | ||
| 当用户从此 InteractiveObject 及其任一子项中移开而仍保留在屏幕的邻近检测阈值中时调度。 | InteractiveObject | ||
| 当用户将活动笔针从显示列表中子项的对象树中滑过此 InteractiveObject 时（而仍保留在屏幕的邻近检测阈值中）时调度。 | InteractiveObject | ||
| 在用户首先在 InteractiveObject 实例上按下按钮，然后将指针设备移离 InteractiveObject 实例，释放指针设备上的按钮时调度。 | InteractiveObject | ||
| 当组件通过使用 removeChild()、removeChildAt()、removeElement() 或 removeElementAt() 方法作为内容子项从容器中删除后调度。 | UIComponent | ||
| 将要从显示列表中删除显示对象时调度。 | DisplayObject | ||
| 在从显示列表中直接删除显示对象或删除包含显示对象的子树时调度。 | DisplayObject | ||
| [广播事件] 将要更新和呈现显示列表时调度。 | DisplayObject | ||
| 在调整组件大小时调度。 | UIComponent | ||
| 当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上按下指针设备按钮时调度。 | InteractiveObject | ||
| 当用户在 InteractiveObject 实例上释放指针设备按钮时调度。 | InteractiveObject | ||
| 用户将指针设备从 InteractiveObject 实例上移开时调度。 | InteractiveObject | ||
| 用户将指针设备移动到 InteractiveObject 实例上时调度。 | InteractiveObject | ||
| 在用户为全选操作激活特定于平台的加速键组合或从文本上下文菜单中选择“全选”时调度。 | InteractiveObject | ||
| 在 selectionAnchorPosition 和/或 selectionActivePosition 属性因任意原因而更改后调度。 | RichEditableText | |||
| 当对象的状态从不可见变为可见时调度。 | UIComponent | ||
| 在放开软键盘之后立即调度。 | InteractiveObject | ||
| 在放开软键盘之前立即调度。 | InteractiveObject | ||
| 在隐藏软键盘之后立即调度。 | InteractiveObject | ||
| 在组件进入新状态且切换到该状态的状态转换动画已经播放完时调度。 | UIComponent | ||
| 在组件中断转换到当前状态从而切换到新状态时调度。 | UIComponent | ||
| 对象的 tabChildren 标志值发生更改时调度。 | InteractiveObject | ||
| 对象的 tabEnabled 标志发生更改时调度。 | InteractiveObject | ||
| 对象的 tabIndex 属性值发生更改时调度。 | InteractiveObject | ||
| 当用户输入一个或多个文本字符时调度。 | InteractiveObject | ||
| 要创建 ToolTip 时由组件调度。 | UIComponent | ||
| 已隐藏组件的 ToolTip 并要将其放弃时由组件调度。 | UIComponent | ||
| 要隐藏组件的 ToolTip 时由组件调度。 | UIComponent | ||
| 要显示组件的 ToolTip 时由组件调度。 | UIComponent | ||
| 显示组件的 ToolTip 时由组件调度。 | UIComponent | ||
| 用户将鼠标移动到设置了 toolTip 属性的组件上方后，由该组件调度。 | UIComponent | ||
| 当用户第一次触摸启用触摸的设备时（例如，用手指触摸配有触摸屏的移动电话或平板）调度。 | InteractiveObject | ||
| 当用户移除与启用触摸的设备的接触时（例如，将手指从配有触摸屏的移动电话或平板电脑上抬起）调度。 | InteractiveObject | ||
| 不可撤消事件，在组件结束响应 touch 交互用户操作时由组件调度。 | UIComponent | ||
| 不可撤消事件，在组件开始响应 touch 交互用户操作时由组件调度。 | UIComponent | ||
| 可撤消事件，在组件试图响应 touch 交互用户操作时由组件调度。 | UIComponent | ||
| 当用户触碰设备时进行调度，而且会连续调度，直到接触点被删除。 | InteractiveObject | ||
| 当用户将接触点从启用触摸的设备上的 InteractiveObject 实例移开时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从一个显示对象拖到另一个显示对象）调度。 | InteractiveObject | ||
| 当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。 | InteractiveObject | ||
| 当用户移动接触点，使其远离启用触摸的设备上的 InteractiveObject 实例时（例如，在配有触摸屏的移动电话或平板电脑上将一个手指从显示对象上的一点移动到显示对象外的一点）调度。 | InteractiveObject | ||
| 当用户在启用触摸的设备的 InteractiveObject 实例上移动接触点时（例如，在配有触摸屏的移动电话或平板电脑上，将手指从显示对象外的一点拖动到显示对象上的一点）调度。 | InteractiveObject | ||
| 当用户在启用触摸设备上的已启动接触的同一 InteractiveObject 实例上抬起接触点时（例如，在配有触摸屏的移动电话或平板的显示对象上的某一点处按下并释放手指）调度。 | InteractiveObject | ||
| 当调用了对象的 commitProperties()、measure() 和 updateDisplayList() 方法后调度（如果需要）。 | UIComponent | ||
| 当组件由 Validator 监控并且成功通过验证时调度。 | UIComponent | ||
| 当以编程方式或通过用户交互更改值时调度。 | UIComponent | ||
样式为常见样式，或与特定主题关联。如果为常见样式，则可以用于任何主题。如果样式与特定主题关联，则只有应用程序使用该主题时才能使用该样式。
| 样式 | 说明 | 由以下参数定义 | ||
|---|---|---|---|---|
alignmentBaseline | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定主要基线对齐到的基线。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.alignmentBaseline。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
backgroundAlpha | 类型: Number CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 由 backgroundColor 样式定义的颜色的 Alpha 级别。有效值范围是 0.0 到 1.0。
默认值为 1.0。 | RichEditableText | ||
backgroundColor | 类型: uint 格式: Color CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件的整个边界矩形的背景色。如果此样式为 undefined，则不绘制任何背景。否则，此 RGB 颜色是使用由 backgroundAlpha 样式确定的 Alpha 级别绘制的。
默认值为 undefined。 | RichEditableText | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从内容区域的上边缘到控件的基线位置的垂直距离（以像素为单位）. | UIComponent | ||
baselineShift | 类型: Object CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 要偏移基线的量。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.baselineShift。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
blockProgression | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定线位置的垂直或水平行进。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.blockProgression。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件底边到其父容器的内容区域底边之间的垂直距离（以像素为单位）. | UIComponent | ||
breakOpportunity | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 控制在将连续文本断开为多行时允许行断开的位置。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.breakOpportunity。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
cffHinting | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 用于此文本的 CFF 提示的类型。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.cffHinting。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
clearFloats | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 控制文本在浮点周围的环绕方式。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.clearFloats。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
color | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 文本的颜色。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.color。 对于 Mobile 主题，如果使用 StyleableTextField，请参阅 spark.components.supportClasses.StyleableTextField Style color；如果使用 StyleableStageText，则参阅 spark.components.supportClasses.StyleableStageText Style color。 默认值为 0x000000。相关 API 元素 | RichEditableText | ||
columnCount | 类型: Object CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 文本列数。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.columnCount。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
columnGap | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 在列之间留出来的装订空间量（以像素为单位）。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.columnGap。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
columnWidth | 类型: Object CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 列宽（像素数）。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.columnWidth。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
digitCase | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 用于此文本的数字大小写类型。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.digitCase。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
digitWidth | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 用于此文本的数字宽度类型。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.digitWidth。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
direction | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定文本的默认双向嵌入级别。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.direction。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
dominantBaseline | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定该元素的哪条基线对齐到 alignmentBaseline 以确定元素在该行上的垂直位置。
有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.dominantBaseline。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
| 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 验证失败时，组件加亮部分的颜色. | UIComponent | ||
firstBaselineOffset | 类型: Object CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定容器中第一行的基线位置。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.firstBaselineOffset。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 焦点矩形使用的混合模式. | UIComponent | ||
focusedTextSelectionColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件已启用且有焦点时文本的颜色。 对于 Mobile 主题，它不受支持。 | RichEditableText | ||
| 类型: Class CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 用于绘制焦点矩形的外观. | UIComponent | ||
| 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 焦点矩形轮廓的粗细（以像素为单位）. | UIComponent | ||
fontFamily | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 要使用的字体的名称或用逗号分隔的字体名称列表。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.fontFamily。 对于 Mobile 主题，如果使用 StyleableTextField，请参阅 spark.components.supportClasses.StyleableTextField Style fontFamily；如果使用 StyleableStageText，则参阅 spark.components.supportClasses.StyleableStageText Style fontFamily。 Spark 主题的默认值为 相关 API 元素 | RichEditableText | ||
fontLookup | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 要使用的字体查找。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.fontLookup。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
fontSize | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 文本的高度，以像素为单位。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.fontSize。 对于 Mobile 主题，如果使用 StyleableTextField，请参阅 spark.components.supportClasses.StyleableTextField Style fontSize；如果使用 StyleableStageText，则参阅 spark.components.supportClasses.StyleableStageText Style fontSize。 Spark 主题的默认值为 相关 API 元素 | RichEditableText | ||
fontStyle | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 确定文本是否使用斜体。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.fontStyle。 对于 Mobile 主题，如果使用 StyleableTextField，请参阅 spark.components.supportClasses.StyleableTextField Style fontStyle；如果使用 StyleableStageText，则参阅 spark.components.supportClasses.StyleableStageText Style fontStyle。 相关 API 元素 | RichEditableText | ||
fontWeight | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 确定文本是否使用粗体。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.fontWeight。 对于 Mobile 主题，如果使用 StyleableTextField，请参阅 spark.components.supportClasses.StyleableTextField Style fontWeight；如果使用 StyleableStageText，则参阅 spark.components.supportClasses.StyleableStageText Style fontWeight。 相关 API 元素 | RichEditableText | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的水平距离（以像素为单位）. | UIComponent | ||
inactiveTextSelectionColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 禁用组件时文本的颜色。 对于 Mobile 主题，它不受支持。 | RichEditableText | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 2.5 该组件的主要交互模式. | UIComponent | ||
justificationRule | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 用于将段落文本两端对齐的规则。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.justificationRule。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
justificationStyle | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 段落两端对齐所用的样式。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.justificationStyle。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
kerning | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 段落两端对齐所用的样式。 Spark 组件默认启用字距调整，但 MX 组件默认禁用字距调整。Spark 组件将 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.kerning。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
| 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.1 运行时版本: Flash10, AIR 1.5 指定组件的所需布局方向. | UIComponent | ||
leadingModel | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定行距模型，它是行距基准和行距方向的组合。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.leadingModel。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件左边到其父容器的内容区域左边之间的水平距离（以像素为单位）. | UIComponent | ||
ligatureLevel | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 控制可以在该文本中使用字体中定义的哪些连字。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.ligatureLevel。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
lineBreak | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 控制容器内的文字换行。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.blockProgression。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
lineHeight | 类型: Object CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 文本的行距控制。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.lineHeight。
对于 Mobile 主题，它不受支持。请参阅 相关 API 元素 | RichEditableText | ||
lineThrough | 类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 若为 true，则应用删除线（一条穿过文本中间的直线）。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.lineThrough。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
listAutoPadding | 类型: Number 格式: length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定当列表相应侧的内边距值为 auto 时，列表开始边缘的自动缩进。
有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.listAutoPadding。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
listStylePosition | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 2.5 它控制列表项目标记相对于列表项目的位置。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.listStylePosition。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
listStyleType | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 2.5 它控制列表中项目的外观。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.listStyleType。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
locale | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 文本的区域设置。控制大小写转换和形状。使用标准区域设置标识符，如 Unicode Technical Standard #35 中所述。例如，"en"、"en_US" 和 "en-US" 均表示英语，"ja" 表示日语。 默认值为 undefined。此属性从祖代继承其值；如果未定义祖代，则从全局区域设置 在使用 Spark 格式化程序和全球化类时，可以将根应用程序的此样式设置为 undefined。了解详细信息 | RichEditableText | ||
paddingBottom | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 底部边界区，以像素为单位。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.paddingBottom。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
paddingLeft | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 左侧边界区，以像素为单位。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.paddingLeft。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
paddingRight | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 右侧边界区，以像素为单位。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.paddingRight。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
paddingTop | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 顶部边界区，以像素为单位。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.paddingRight。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
paragraphEndIndent | 类型: Number 格式: length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 段落结束边缘要缩进的量。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.paragraphEndIndent。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
paragraphSpaceAfter | 类型: Number 格式: length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 段落之后要留出的空格数。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.paragraphSpaceAfter。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
paragraphSpaceBefore | 类型: Number 格式: length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 段落之前要留出的空格数。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.paragraphSpaceBefore。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
paragraphStartIndent | 类型: Number 格式: length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 段落开始边缘要缩进的量。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.paragraphStartIndent。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
renderingMode | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 仅适用于嵌入字体的用于该文本的呈示模式。 有关 Spark 主题，请参阅flashx.textLayout.formats.ITextLayoutFormat.renderingMode 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件右边到其父容器的内容区域右边之间的水平距离（以像素为单位）. | UIComponent | ||
| 类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 1.5 当此组件无效时，显示错误边框或外观 | UIComponent | ||
| 类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10, AIR 1.5 如果此组件无效，当用户将鼠标移到它上方时，将显示错误提示 | UIComponent | ||
tabStops | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定与段落关联的制表位。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.tabStops。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
textAlign | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 容器内文本的对齐方式。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.textAlign。 对于 Mobile 主题，如果使用 StyleableTextField，请参阅 spark.components.supportClasses.StyleableTextField Style textAlign；如果使用 StyleableStageText，则参阅 spark.components.supportClasses.StyleableStageText Style textAlign。 相关 API 元素 | RichEditableText | ||
textAlignLast | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 两端对齐文本中段落最后一行与容器的对齐方式。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.textAlignLast。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
textAlpha | 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 文本的 Alpha（透明度）值。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.textAlpha。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
textDecoration | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 确定文本是否加下划线。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.textDecoration。 对于 Mobile 主题，如果使用 StyleableTextField，请参阅 spark.components.supportClasses.StyleableTextField Style textDecoration；如果使用 StyleableStageText，则不支持此项。 相关 API 元素 | RichEditableText | ||
textIndent | 类型: Number 格式: Length CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 文本第一行偏离容器左侧的距离。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.textIndent。 对于 Mobile 主题，如果使用 StyleableTextField，请参阅 spark.components.supportClasses.StyleableTextField Style textIndent；如果使用 StyleableStageText，则不支持此项。 相关 API 元素 | RichEditableText | ||
textJustify | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定文本两端对齐的选项。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.textJustify。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
textRotation | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 确定要旋转此文本的度数。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.textRotation。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件顶边到其父容器的内容区域顶边之间的垂直距离（以像素为单位）. | UIComponent | ||
trackingLeft | 类型: Object CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 要应用于每个字符左侧的间距量（手动字距调整）。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.trackingLeft。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
trackingRight | 类型: Object CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 要应用于每个字符右侧的间距量（手动字距调整）。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.trackingRight。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
typographicCase | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 用于此文本的印刷大小写的类型。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.typographicCase。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
unfocusedTextSelectionColor | 类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 组件已启用但没有焦点时文本的颜色。 对于 Mobile 主题，它不受支持。 | RichEditableText | ||
verticalAlign | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 垂直对齐或两端对齐。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.verticalAlign。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
| 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的垂直距离（以像素为单位）. | UIComponent | ||
whiteSpaceCollapse | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 将文本导入到 TextFlow 中时压缩或保留空白。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.whiteSpaceCollapse。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
wordSpacing | 类型: Object CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10.5, AIR 2.0 指定两端对齐要用的字间距。 有关 Spark 主题，请参阅 flashx.textLayout.formats.ITextLayoutFormat.wordSpacing。 对于 Mobile 主题，它不受支持。 相关 API 元素 | RichEditableText | ||
| 样式 | 说明 | 由以下参数定义 | ||
|---|---|---|---|---|
leading | 类型: Number 格式: Length CSS 继承: 是 主题: mobile 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10.1, AIR 2.0 文本行之间附加的垂直空间。
对于 Spark 主题，它不受支持。请参阅 对于 Mobile 主题，如果使用 StyleableTextField，请参阅 spark.components.supportClasses.StyleableStageText Style fontWeight；如果使用 StyleableStageText，则不支持此项。 相关 API 元素 | RichEditableText | ||
letterSpacing | 类型: Number CSS 继承: 是 主题: mobile 语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10.1, AIR 2.0 各字符之间显示的附加像素数。
对于 Spark 主题，它不受支持。请参阅 对于 Mobile 主题，如果使用 StyleableTextField，请参阅 spark.components.supportClasses.StyleableTextField.letterSpacing；如果使用 StyleableStageText，则不支持此项。 相关 API 元素 | RichEditableText | ||
clipAndEnableScrolling | 属性 |
content | 属性 |
content:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
该属性旨在编译时用于 MXML；要在运行时获得或设置富文本内容，请改用 textFlow 属性。
content 属性是 RichEditableText 的默认属性，因此可以编写 MXML 成如下形式
<s:RichEditableText>Hello <s:span fontWeight="bold"/>World</s:span></s:RichEditableText>
且可以将指定为内容的 String 和 SpanElement 用于创建 TextFlow。
该属性的类型为 Object，因为可以将其设置为 String、FlowElement 或 String 和 FlowElement 的 Array。在上述示例中，所指定的内容是二元数组，其中，第一个元素是字符串“Hello”，第二个元素是含有粗体文本“World”的 SpanElement。
无论指定内容的方式为何，内容都会转换为 TextFlow，且当获得该属性时，即获得生成的 TextFlow。
Adobe 建议运行时使用 textFlow 属性获得或设置富文本内容，因为它是 TextFlow（而不是 Object）的强类型。在 Text Layout Framework 中，TextFlow 是富文本内容的规范表示。
实现
public function get content():Object public function set content(value:Object):voidcontentHeight | 属性 |
contentHeight:Number [只读] | 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
文本高度。
由于 Text Layout Framework 将 TextLine 虚拟化以获得更佳性能，因此如果组件无法显示所有文本，则此初始高度将为估计值。如果滚动到文本末尾，所有 TextLine 将合成，且 contentHeight 是准确的。
要在内容中垂直滚动，请在 0 和 contentHeight - height 之间更改 verticalScrollPosition。
此属性可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。
实现
public function get contentHeight():NumbercontentWidth | 属性 |
contentWidth:Number [只读] | 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
文本的宽度。
由于 Text Layout Framework 将 TextLine 虚拟化以获得更佳性能，因此如果组件无法显示所有文本，则此初始宽度将为估计值。如果滚动到文本末尾，所有 TextLine 将合成，且 contentWidth 是准确的。
要在文本中水平滚动，请在 0 和 contentWidth - width 之间更改 horizontalScrollPosition。
此属性可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。
实现
public function get contentWidth():NumberdisplayAsPassword | 属性 |
displayAsPassword:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
指定文本字段是否是密码文本字段。如果此属性的值为 true，则文本字段被视为密码文本字段，并使用星号而不是实际字符来隐藏输入的字符。如果为 false，则不会将文本字段视为密码文本字段。启用密码模式时，“剪切”和“复制”命令及其对应的键盘快捷键将不起作用。此安全机制可防止不良用户使用快捷键在无人看管的计算机上破译密码。
实现
public function get displayAsPassword():Boolean public function set displayAsPassword(value:Boolean):voideditable | 属性 |
editable:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
指示用户是否可以编辑此控件中的文本的标志。
如果为 true，当鼠标光标位于该控件的边界上时将变为 Ｉ 形。如果为 false，鼠标光标将保持为箭头。
如果该属性为 true，则 selectable 属性将被忽略。
默认值为 true。
实现
public function get editable():Boolean public function set editable(value:Boolean):void相关 API 元素
enableIME | 属性 |
heightInLines | 属性 |
heightInLines:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
控件的默认高度（以行为单位测量）。
控件的格式样式（例如 fontSize 和 lineHeight）用于计算行高像素值。
例如，如果需要 RichEditableText 的高度足够显示 5 行文本，则将该属性设置为 5。
如果该属性为 NaN（默认值），则组件的默认高度由要显示的文本确定。
如果指定显式高度、百分比高度或 top 和 bottom 约束，该属性将被忽略。
如果已指定 typicalText 属性，则该属性也将被忽略。
RichEditableText 的 measure() 方法使用 widthInChars 和 heightInLines 来确定 measuredWidth 和 measuredHeight。这些与 HTML TextArea 的 cols 和 rows 相似。
由于 widthInChars 和 heightInLines 默认为 NaN，因此默认情况下 RichTextEditable“自动调整大小”：不包含任何文本启动时非常小，随着文本的输入，其宽度不断增大直到 maxWidth，按 Enter 键开始新行时其高度增加。
默认值为 NaN。
实现
public function get heightInLines():Number public function set heightInLines(value:Number):void相关 API 元素
horizontalScrollPosition | 属性 |
horizontalScrollPosition:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
文本水平滚动的像素数。
要在文本中水平滚动，请在 0 和 contentWidth - width 之间更改 horizontalScrollPosition。
默认值为 0。
此属性可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。
实现
public function get horizontalScrollPosition():Number public function set horizontalScrollPosition(value:Number):voidimeMode | 属性 |
imeMode:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
指定 IME（输入法编辑器）模式。IME 使用户能够用中文、日文和韩文输入文本。当控件获得焦点时，Flex 设置指定的 IME 模式；当该控件失去焦点时，则将其设置回为先前的值。
flash.system.IMEConversionMode 类定义此属性的有效值的常量。您还可以指定 null 不指定任何 IME 模式。
默认值为 null。
实现
public function get imeMode():String public function set imeMode(value:String):void相关 API 元素
maxChars | 属性 |
multiline | 属性 |
multiline:Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
确定用户是否可以输入多行文本。
如果为 true，则 Enter 键会开始一个新段落。如果为 false，则 Enter 键不会影响该文本但会使 RichEditableText 调度 "enter" 事件。如果将文本粘贴到 multiline 值为 false 的 RichEditableText 中，则将从文本中去除新行。
默认值为 true。
实现
public function get multiline():Boolean public function set multiline(value:Boolean):voidrestrict | 属性 |
restrict:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
表示用户可输入到文本字段中的字符集。如果 restrict 属性的值为 null，则可以输入任何字符。如果 restrict 属性的值为空字符串，则不能输入任何字符。如果 restrict 属性的值为一串字符，则只能在文本字段中输入该字符串中的字符。从左向右扫描该字符串。可以使用连字符 (-) 指定一个范围。只限制用户交互；脚本可将任何文本放入文本字段中。此属性不与属性检查器中的“嵌入字体”选项同步。
如果字符串以尖号 (^) 开头，则先接受所有字符，然后从接受字符集中排除字符串中 ^ 之后的字符。如果字符串不以尖号 (^) 开头，则最初不接受任何字符，然后将字符串中的字符包括在接受字符集中。
下例仅允许在文本字段中输入大写字符、空格和数字：
my_txt.restrict = "A-Z 0-9";
下例包含除小写字母之外的所有字符：
my_txt.restrict = "^a-z";
可以使用反斜杠输入 ^ 或 - 的本义。认可的反斜杠序列为 \-、\^ 或 \\。反斜杠在字符串中必须是一个本义字符，因此在 ActionScript 中指定时必须使用两个反斜杠。例如，下面的代码只包含短划线 (-) 和尖号 (^)：
my_txt.restrict = "\\-\\^";
可在字符串中的任何位置使用 ^，以在包含字符与排除字符之间进行切换。下面的代码只包含除大写字母 Q 之外的大写字母：
my_txt.restrict = "A-Z^Q";
可以使用 \u 转义序列构造 restrict 字符串。下面的代码只包含从 ASCII 32（空格）到 ASCII 126（代字号）之间的字符。
my_txt.restrict = "\u0020-\u007E";
默认值为 null。
实现
public function get restrict():String public function set restrict(value:String):voidselectable | 属性 |
selectionActivePosition | 属性 |
selectionActivePosition:int [只读] | 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
相对于 text 字符串开头的字符位置，用于指定用箭头键扩展选区时该选区的终点。
活动位置可以是选区的起点或终点。
例如，如果拖动选择位置 12 到位置 8 之间的区域，则 selectionAnchorPosition 将为 12，selectionActivePosition 将为 8，按向左箭头后 selectionActivePosition 将变为 7。
值为 -1 时，表示“未设置”。
默认值为 -1。
此属性可用作数据绑定的源。修改此属性后，将调度 selectionChange 事件。
实现
public function get selectionActivePosition():int相关 API 元素
selectionAnchorPosition | 属性 |
selectionAnchorPosition:int [只读] | 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
相对于 text 字符串开头的字符位置，用于指定用箭头键扩展选区时该选区保持固定的终点。
锚点位置可以是选区的起点或终点。
例如，如果拖动选择位置 12 到位置 8 之间的区域，则 selectionAnchorPosition 将为 12，selectionActivePosition 将为 8，按向左箭头后 selectionActivePosition 将变为 7。
值为 -1 时，表示“未设置”。
默认值为 -1。
此属性可用作数据绑定的源。修改此属性后，将调度 selectionChange 事件。
实现
public function get selectionAnchorPosition():int相关 API 元素
selectionHighlighting | 属性 |
selectionHighlighting:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
确定何时加亮选择的文本。
所允许的值由 spark.components.TextSelectionHighlighting 类指定。可能的值有 TextSelectionHighlighting.WHEN_FOCUSED、TextSelectionHighlighting.WHEN_ACTIVE 和 TextSelectionHighlighting.ALWAYS。
WHEN_FOCUSE 只有在组件具有键盘焦点时才显示选择的文本。
WHEN_ACTIVE 在组件的窗口为活动窗口时显示选择的文本（即使组件没有获得键盘焦点，也会如此）。
ALWAYS 显示选择的文本，即使组件没有获得键盘焦点或组件窗口不是活动窗口也会如此。
默认值为 TextSelectionHighlighting.WHEN_FOCUSED。
实现
public function get selectionHighlighting():String public function set selectionHighlighting(value:String):void相关 API 元素
showSystemCursor | 属性 |
text | 属性 |
text:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
此组件所显示的 text 字符串。
设置该属性会影响 textFlow 属性，反之亦然。
如果将 text 设置为 String（例如“Hello World”），并获得 textFlow，则它将是包含单个 ParagraphElement 和单个 SpanElement 的 TextFlow。
如果将 text 设置为 null，它将设置为默认值，即空字符串。
如果文本包含显式换行符 - CR（“\r”）、LF（“\n”）或 CR+LF（“\r\n”）- 则内容将设置为包含多个段落且各段落之间含一个间距的 TextFlow。
如果设置 textFlow 并获得 text，则各段落中的文本将由单个 LF（“\n”）分隔。
设置该属性也会影响用于指定控件的滚动位置和所选文本的属性。它将 horizontalScrollPosition 和 verticalScrollPosition 重置为 0。从 Flex 4.6 开始，selectionAnchorPosition 和 selectionActivePosition 被保留。在此之前，selectionAnchorPosition 和 selectionActivePosition 被设置为 -1 以清除选择。
默认值为 ""。
此属性可用作数据绑定的源。修改此属性后，将调度 change 事件。
实现
public function get text():String public function set text(value:String):void相关 API 元素
textFlow | 属性 |
textFlow:flashx.textLayout.elements:TextFlow| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10, AIR 2.5 |
用于表示该组件显示的富文本的 TextFlow。
TextFlow 是 Text Layout Framework (TLF) 中最重要的类。它是表示富文本内容的 FlowElement 的树的根。
通常情况下，使用 TextFlowUtil.importFromString() 和 TextFlowUtil.importFromXML() 方法基于 TLF 标记创建 TextFlow。或者，还可以使用 TLF 的 TextConverter 类（可以导入 HTML 的子集），或者对 TextFlow 使用诸如 addChild() 等方法构建 TextFlow。
设置该属性会影响 text 属性，反之亦然。
如果设置 textFlow 并获得 text，则各段落中的文本将由单个 LF（“\n”）分隔。
如果将 text 设置为 String（例如“Hello World”），并获得 textFlow，则它将是包含单个 ParagraphElement 和单个 SpanElement 的 TextFlow。
如果文本包含显式换行符 - CR（“\r”）、LF（“\n”）或 CR+LF（“\r\n”）- 则内容将设置为包含多个段落且各段落之间含一个间距的 TextFlow。
设置该属性也会影响用于指定控件的滚动位置和所选文本的属性。它将 horizontalScrollPosition 和 verticalScrollPosition 重置为 0，且将 selectionAnchorPosition 和 selectionActivePosition 设置为 -1，以清除选择。
要将 TextFlow 对象变成 TLF 标记，请使用 TextFlowUtil.export() 标记。
单个 TextFlow 无法由 RichEditableText 的多个实例共享。要在第二个实例中显示相同的文本，必须使用以下方法再创建一个 TextFlow：使用 TextFlowUtil.export() 和 TextFlowUtil.importFromXML() 方法，或对 TextFlow 使用 deepCopy() 方法。
实现
public function get textFlow():flashx.textLayout.elements:TextFlow public function set textFlow(value:flashx.textLayout.elements:TextFlow):void相关 API 元素
typicalText | 属性 |
typicalText:String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.2, AIR 2.0 |
用于不实际显示即可确定控件的默认宽度和高度的文本。
如果指定显性宽度、百分比宽度或 left 和 right 约束，该属性将被忽略。
使用此属性将导致 widthInChars 和 heightInLines 属性被忽略。
默认值为 null。
实现
public function get typicalText():String public function set typicalText(value:String):void相关 API 元素
spark.primitives.widthInChars
verticalScrollPosition | 属性 |
verticalScrollPosition:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
文本垂直滚动的像素数。
要在内容中垂直滚动，请在 0 和 contentHeight - height 之间更改 verticalScrollPosition。
默认值为 0。
此属性可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。
实现
public function get verticalScrollPosition():Number public function set verticalScrollPosition(value:Number):voidwidthInChars | 属性 |
widthInChars:Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
控件的默认宽度（使用 em 单位测量）。
em 是一种印刷测量单位，相当于一个点大小。em 并非必须完全精确等于字母“M”的宽度，但是在很多字体中，“M”大约为一个 em 宽。使用控件的 fontSize 样式计算 em 单位的像素值。
例如，如果需要 RichEditableText 的宽度足够显示约 20 个文本字符，则将该属性设置为 20。
如果该属性为 NaN（默认值），则组件的默认宽度由要显示的文本确定。
如果指定显性宽度、百分比宽度或 left 和 right 约束，该属性将被忽略。
如果已指定 typicalText 属性，则该属性也将被忽略。
RichEditableText 的 measure() 方法使用 widthInChars 和 heightInLines 来确定 measuredWidth 和 measuredHeight。这些与 HTML TextArea 的 cols 和 rows 相似。
由于 widthInChars 和 heightInLines 默认为 NaN，因此默认情况下 RichTextEditable“自动调整大小”：不包含任何文本启动时非常小，随着文本的输入，其宽度不断增大直到 maxWidth，按 Enter 键开始新行时其高度增加。
默认值为 NaN。
实现
public function get widthInChars():Number public function set widthInChars(value:Number):void相关 API 元素
RichEditableText | () | 构造函数 |
public function RichEditableText()| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
构造函数。
appendText | () | 方法 |
getFormatOfRange | () | 方法 |
public function getFormatOfRange(requestedFormats:Vector.<String> = null, anchorPosition:int = -1, activePosition:int = -1):flashx.textLayout.formats:TextLayoutFormat| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回 TextLayoutFormat 对象，用于为指定范围的字符指定计算格式。
如果格式在整个范围上设置不一致，则其值将为 undefined。
可以为包含所需格式名称的 String 指定 Vector；如果不指定，将计算所有格式。
如果不指定范围，则将使用选定范围。
参数
requestedFormats:Vector.<String> (default = null)null（用于请求所有格式）。
| |
anchorPosition:int (default = -1) | |
activePosition:int (default = -1) |
flashx.textLayout.formats:TextLayoutFormat — TextLayoutFormat 对象。
|
getHorizontalScrollPositionDelta | () | 方法 |
public function getHorizontalScrollPositionDelta(navigationUnit:uint):Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回要添加到视域的当前 horizontalScrollPosition 的数量，以按请求的滚动单位进行滚动。
参数
navigationUnit:uint — 要滚动的数量。该值必须是以下 spark.core.NavigationUnit 常量之一：
LEFT 或 RIGHT。要滚动到第一列或最后一列，请使用 HOME 或 END。
|
Number — 要添加到 horizontalScrollPosition 的像素数目。
|
getVerticalScrollPositionDelta | () | 方法 |
public function getVerticalScrollPositionDelta(navigationUnit:uint):Number| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回要添加到视域的当前 verticalScrollPosition 的数量，以按请求的滚动单位进行滚动。
参数
navigationUnit:uint — 要滚动的数量。该单元值必须是以下 spark.core.NavigationUnit 常量之一：
UP 或 DOWN。要滚动到第一行或最后一行，请使用 HOME 或 END。
|
Number — 要添加到 verticalScrollPosition 的像素数目。
|
insertText | () | 方法 |
scrollToRange | () | 方法 |
selectAll | () | 方法 |
public function selectAll():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
选择所有文本。这不包括最终的段落终止符。
selectRange | () | 方法 |
setFormatOfRange | () | 方法 |
public function setFormatOfRange(format:flashx.textLayout.formats:TextLayoutFormat, anchorPosition:int = -1, activePosition:int = -1):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将指定的格式应用于指定范围中的每个元素，以与所给定的格式相对应。将字符格式应用于指定范围中的文本（如果指定的范围为单个点，则不进行任何更改）。将段落格式应用于至少部分在该范围内的任何段落（如果范围为单个点，则应用于单个段落）。将容器格式应用于容器。
支持的格式是 TextLayoutFormat 中的那些格式。不应用 undefined 值。如果不指定范围，则将使用选定范围。
下面的示例设置所选项目的 fontSize 和 color：
var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
textLayoutFormat.fontSize = 12;
textLayoutFormat.color = 0xFF0000;
myRET.setFormatOfRange(textLayoutFormat);
如果您使用 getFormatOfRange() 的结果来指定 format，请注意，TextLayoutFormat 中的每个格式都具有一个计算值，该计算值将应用于与给定格式相对应的每个元素。
如果您希望指定一个要应用于所有文本的格式，最好对组件本身使用 setStyle(format, value)。
下面的示例设置所有文本的 fontSize 和 color：
myRET.setStyle("fontSize", 12);
myRET.setStyle("color", 0xFF0000);
参数
format:flashx.textLayout.formats:TextLayoutFormat — 要应用到选区的 TextLayoutFormat。
| |
anchorPosition:int (default = -1) | |
activePosition:int (default = -1) |
styleChanged | () | 方法 |
override public function styleChanged(styleProp:String):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
检测对样式属性的更改。设置任何样式属性后，Flex 将调用 styleChanged() 方法，向其传递所设置样式的名称。
此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。创建自定义组件时，可以覆盖 styleChanged() 方法，以检查传递给它的样式名称，并对更改进行相应处理。这允许您覆盖现有样式的默认行为或添加自己的自定义样式属性。
如果您处理样式属性，覆盖 styleChanged() 方法时应调用 invalidateDisplayList() 方法，以使 Flex 在下次更新屏幕时执行组件的 updateDisplayList() 方法。
参数
styleProp:String — 样式属性的名称；如果此组件的所有样式均已更改，则为 null。
|
stylesInitialized | () | 方法 |
override public function stylesInitialized():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。
此方法是一种高级方法，可在创建 UIComponent 的子类时覆盖。Flex 可以保证在首次调用组件的 measure 和 updateDisplayList 方法之前充分初始化组件的样式。对于大多数组件而言，这就足够了。但是，如果您需要早些访问样式值，则可以覆盖 stylesInitialized() 函数，以在首次初始化样式属性后立即访问这些属性。
change | 事件 |
spark.events.TextOperationEvent属性 TextOperationEvent.type =
spark.events.TextOperationEvent.CHANGE| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在用户编辑操作完成后调度。
TextOperationEvent.CHANGE 常量可为 change 事件定义事件对象的 type 属性值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
operation | 描述正在由用户对文本执行的编辑操作的 FlowOperation 对象。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
changing | 事件 |
spark.events.TextOperationEvent属性 TextOperationEvent.type =
spark.events.TextOperationEvent.CHANGING| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在用户编辑操作发生前调度。可以更改该操作，或取消该事件以防止该操作被处理。
TextOperationEvent.CHANGING 常量可为 changing 事件定义事件对象的 type 属性值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | true |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
operation | 描述正在由用户对文本执行的编辑操作的 FlowOperation 对象。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
enter | 事件 |
mx.events.FlexEvent属性 FlexEvent.type =
mx.events.FlexEvent.ENTER| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
如果 multiline 属性为 false，当用户按 Enter 键时调度。
FlexEvent.ENTER 常量可为 enter 事件定义事件对象的 type 属性值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
selectionChange | 事件 |
mx.events.FlexEvent属性 FlexEvent.type =
mx.events.FlexEvent.SELECTION_CHANGE| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
出于任何原因在 selectionAnchorPosition 和/或 selectionActivePosition 属性已更改后调度。
FlexEvent.SELECTION_CHANGE 常量可为 selectionChange 事件定义事件对象的 type 属性值。
事件对象的属性有下列值：
| 属性 | 值 |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | 用于定义处理该事件的事件侦听器的对象。例如，如果您使用 myButton.addEventListener() 注册某个事件侦听器，则 myButton 为 currentTarget 的值。 |
target | 调度该事件的 Object；它不一定是侦听该事件的 Object。使用 currentTarget 属性始终可以访问侦听事件的 Object。 |
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the Spark RichEditableText primitive. -->
<s:Application name="RichEditableTextExample"
xmlns:fx="http://ns.adobe.com/mxml/2009"
xmlns:s="library://ns.adobe.com/flex/spark"
xmlns:mx="library://ns.adobe.com/flex/mx">
<fx:Script>
<![CDATA[
import flashx.textLayout.conversion.TextConverter;
]]>
</fx:Script>
<fx:Declarations>
<fx:XML id="extTxtFlow" source="externalTextFlow.xml" />
</fx:Declarations>
<s:Panel title="RichText textFlow test"
width="90%" height="90%"
horizontalCenter="0" verticalCenter="0">
<s:Scroller width="100%" height="100%">
<s:VGroup paddingLeft="20" paddingRight="20" paddingTop="20" paddingBottom="20">
<s:RichEditableText id="richTxt1" textAlign="justify" percentWidth="100">
<s:textFlow>
<s:TextFlow>
<s:p fontSize="24">Inline TextFlow</s:p>
<s:p>1) Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus aliquet tristique libero, vel mattis massa pellentesque nec. Maecenas non nulla nibh, et egestas ligula. Etiam massa mauris, elementum gravida rhoncus sit amet, blandit eu lacus. Proin nisi felis, accumsan at interdum eu, mattis at velit. Nulla at ipsum risus. Nullam non justo vel lacus vulputate mollis id quis libero.</s:p>
<s:p>2) Cras posuere posuere sem, eu congue orci mattis quis. Morbi vitae est ut purus vestibulum iaculis malesuada quis metus. Donec feugiat sapien quis turpis porttitor vel mattis libero viverra. Sed nisl justo, fringilla eget ultrices ut, venenatis quis magna. Nulla feugiat egestas mattis. Phasellus sed dignissim justo. Etiam malesuada bibendum urna, id dapibus nulla posuere eu.</s:p>
<s:p>3) Curabitur pulvinar tellus venenatis ipsum tempus lobortis. Vestibulum eros velit, bibendum at aliquet ut, placerat sed mauris.</s:p>
</s:TextFlow>
</s:textFlow>
</s:RichEditableText>
<s:RichEditableText id="richTxt2" textAlign="justify" width="100%"
textFlow="{TextConverter.importToFlow(extTxtFlow, TextConverter.TEXT_LAYOUT_FORMAT)}" />
</s:VGroup>
</s:Scroller>
</s:Panel>
</s:Application>
<?xml version="1.0" encoding="UTF-8"?>
<!-- externalTextFlow.xml -->
<TextFlow xmlns="http://ns.adobe.com/textLayout/2008">
<p fontSize="24">External TextFlow</p>
<p>1) Lorem ipsum dolor sit amet, consectetur adipiscing elit. Vivamus aliquet tristique libero, vel mattis massa pellentesque nec. Maecenas non nulla nibh, et egestas ligula. Etiam massa mauris, elementum gravida rhoncus sit amet, blandit eu lacus. Proin nisi felis, accumsan at interdum eu, mattis at velit. Nulla at ipsum risus. Nullam non justo vel lacus vulputate mollis id quis libero.</p>
<p>2) Cras posuere posuere sem, eu congue orci mattis quis. Morbi vitae est ut purus vestibulum iaculis malesuada quis metus. Donec feugiat sapien quis turpis porttitor vel mattis libero viverra. Sed nisl justo, fringilla eget ultrices ut, venenatis quis magna. Nulla feugiat egestas mattis. Phasellus sed dignissim justo. Etiam malesuada bibendum urna, id dapibus nulla posuere eu.</p>
<p>3) Curabitur pulvinar tellus venenatis ipsum tempus lobortis. Vestibulum eros velit, bibendum at aliquet ut, placerat sed mauris.</p>
</TextFlow>
Tue Jun 12 2018, 11:04 AM Z