包 | mx.controls |
类 | public class Text |
继承 | Text Label UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Text 控件不支持滚动条。如果需要进行滚动,则应使用不可编辑的 TextArea 控件。
您可以使用 HTML 标记设置 Text 控件中文本的格式,在应用控件的 CSS 样式后将应用这些标签。您还可以在文本的四周放置填充。
默认情况下,Text 控件中的文本是可选的,但通过将 selectable
属性设置为 false
可将 Text 控件中的文本设为不可选。
如果控件宽度小于文本,则文本将 wordwrap。文本在控件中始终为左上角对齐。
通常,通过指定显式宽度并允许 Flex 确定显示所有文本所需的高度来调整 Text 组件的大小。如果指定显式高度,则可能会剪掉某些文本;与 Label 不同,Text 控件不会使用“...”截断其文本。通常,还会对 Text 使用百分比宽度和高度。
如果不指定宽度和高度,Flex 将基于文本中的任何显式换行符来计算它们,行中没有自动换行。例如,如果设置 text
属性,则换行符 "\n"
将生成一个换行符。如果设置 htmlText
属性,则 HTML 标签 <br>
将生成一个换行符。如果 text
或 htmlText
很长但不包含换行符,会得到一个非常宽的 Text 组件;可以设置 maxWidth
以限制允许组件增加到的宽度。
Text 控件没有背景或边框,并且无法获得焦点。
Text 控件具有下列默认的大小特征:
特征 | 说明 |
---|---|
默认大小 | Flex 调整控件大小使其适合文本:宽度要足以适合文本的最长行,高度要足以适合行数。如果未指定像素宽度,则高度将由文本字符串中显式换行符的数目确定。如果文本长度发生更改,控件将调整大小以适合新文本。 |
最小大小 | 0 个像素。 |
ChMaximum sizear03 | 10000 × 10000 个像素 |
The <mx:Text>
tag inherits all of the tag attributes
of its superclass, and adds the following tag attributes:
<mx:Text leading="2" />
另请参见
方法 | 定义方 | ||
---|---|---|---|
Text() 构造函数。 | Text | ||
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | ||
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
指示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 point 点调用 DisplayObjectContainer.getObjectsUnderPoint() 方法时返回的所有显示对象。 | DisplayObjectContainer | ||
排队稍后调用的函数。 | UIComponent | ||
删除此组件实例中的样式属性。 | UIComponent | ||
确定指定显示对象是 DisplayObjectContainer 实例的子项还是该实例本身。 | DisplayObjectContainer | ||
将 Point 对象由内容坐标转换为全局坐标。 | UIComponent | ||
将 Point 对象由内容坐标转换为本地坐标。 | UIComponent | ||
返回标识此容器中的子项的一组属性。 | UIComponent | ||
在 IUIComponent 对象的父项文档对象上创建对此对象的 id 引用。 | UIComponent | ||
在 IUIComponent 对象的父项文档对象上删除对此对象的 id 引用。 | UIComponent | ||
返回与此 UIComponent 的文本样式对应的 UITextFormat 对象。 | UIComponent | ||
将事件调度到事件流中。 | UIComponent | ||
在此组件周围显示或隐藏焦点指示符。 | UIComponent | ||
drawRoundRect(x:Number, y:Number, width:Number, height:Number, cornerRadius:Object = null, color:Object = null, alpha:Object = null, gradientMatrix:Matrix = null, gradientType:String = "linear", gradientRatios:Array = null, hole:Object = null):void 通过编程方式在此外观的 Graphics 对象中绘制一个矩形。 | UIComponent | ||
停止在组件上播放效果实例时,由效果实例调用。 | UIComponent | ||
开始在组件上播放效果实例时,由效果实例调用。 | UIComponent | ||
结束组件上当前播放的所有效果。 | UIComponent | ||
将数据绑定到此 UIComponent 对象。 | UIComponent | ||
打印完成后调用。 | UIComponent | ||
在指定的索引位置提供自动化对象。 | UIComponent | ||
返回一个矩形,该矩形定义相对于 targetCoordinateSpace 对象坐标系的显示对象区域。 | DisplayObject | ||
返回位于指定索引处的子显示对象实例。 | DisplayObjectContainer | ||
返回具有指定名称的子显示对象。 | DisplayObjectContainer | ||
返回 DisplayObject 的 child 实例的索引位置。 | DisplayObjectContainer | ||
查找此 UIComponent 实例的类型选择器。 | UIComponent | ||
返回一个约束布局值,这与获取此组件的约束样式的方式类似。 | UIComponent | ||
确定是使用显式高度还是测量高度的一种简便方法 | UIComponent | ||
确定是使用显式宽度还是测量宽度的一种简便方法 | UIComponent | ||
获取当前具有焦点的对象。 | UIComponent | ||
返回 TextLineMetrics 对象,其中包含控件中文本位置和文本行度量值的相关信息。 | Label | ||
返回对象的数组,这些对象位于指定点下,并且是该 DisplayObjectContainer 实例的子项(或孙子项,依此类推)。 | DisplayObjectContainer | ||
返回一个矩形,该矩形根据 targetCoordinateSpace 参数定义的坐标系定义显示对象的边界,但不包括形状上的任何笔触。 | DisplayObject | ||
返回 dataProvider 中由指定的 Repeater 用来生成此 Repeater 的项目;如果此 Repeater 未重复,则返回 null。 | UIComponent | ||
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | UIComponent | ||
将 Point 对象由全局坐标转换为内容坐标。 | UIComponent | ||
将 point 对象从舞台(全局)坐标转换为显示对象的(本地)坐标。 | DisplayObject | ||
将二维点从舞台(全局)坐标转换为三维显示对象的(本地)坐标。 | DisplayObject | ||
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | ||
指示对象是否已经定义了指定的属性。 | Object | ||
计算显示对象,以确定它是否与 obj 显示对象重叠或相交。 | DisplayObject | ||
计算显示对象,以确定它是否与 x 和 y 参数指定的点重叠或相交。 | DisplayObject | ||
返回一个框 Matrix,在绘制水平渐变时可以将其作为 rot 参数传递给 drawRoundRect() 方法。 | UIComponent | ||
初始化此组件的内部结构。 | UIComponent | ||
初始化用于跟踪此组件的重复实例的各个属性。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 updateDisplayList() 方法。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 commitProperties() 方法。 | UIComponent | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 measure() 方法。 | UIComponent | ||
指示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
将三维显示对象的(本地)坐标的三维点转换为舞台(全局)坐标中的二维点。 | DisplayObject | ||
将 Point 对象由本地坐标转换为内容坐标。 | UIComponent | ||
将 point 对象从显示对象的(本地)坐标转换为舞台(全局)坐标。 | DisplayObject | ||
测量指定的 HTML 文本(该文本中可能包含 <font> 和 <b> 等 HTML 标记),假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | ||
测量指定的文本,假定该文本显示在单行 UITextField(使用由此 UIComponent 的样式确定的 UITextFormat)中。 | UIComponent | ||
将组件移动到其父项内的指定位置。 | UIComponent | ||
将样式更改传播到子项。 | UIComponent | ||
如果 owner 属性链从 child 指向此 UIComponent,则返回 true。 | UIComponent | ||
当在父项中添加或删除 UIComponent 对象时由 Flex 调用。 | UIComponent | ||
准备 IFlexDisplayObject 用于打印。 | UIComponent | ||
指示指定的属性是否存在、是否可枚举。 | Object | ||
为此组件构建或重新构建 CSS 样式缓存;如果 recursive 参数为 true,还会为此组件的所有后代执行同样的操作。 | UIComponent | ||
针对每个效果事件,将 EffectManager 注册为一个事件侦听器。 | UIComponent | ||
从 DisplayObjectContainer 实例的子列表中删除指定的 child DisplayObject 实例。 | DisplayObjectContainer | ||
从 DisplayObjectContainer 的子列表中指定的 index 位置删除子 DisplayObject。 | DisplayObjectContainer | ||
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | ||
重放指定的事件。 | UIComponent | ||
使用提供的 ID 解析子项。 | UIComponent | ||
[静态] 在调用 suspendBackgroundProcessing() 之后继续对使用 callLater() 排队的方法进行背景处理。 | UIComponent | ||
调整对象大小。 | UIComponent | ||
更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | ||
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | ||
设置当前状态。 | UIComponent | ||
设置循环操作动态属性的可用性。 | Object | ||
对此组件实例设置样式属性。 | UIComponent | ||
当 visible 属性发生更改时调用。 | UIComponent | ||
允许用户拖动指定的 Sprite。 | Sprite | ||
结束 startDrag() 方法。 | Sprite | ||
检测对样式属性的更改。 | UIComponent | ||
首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。 | UIComponent | ||
[静态] 阻止对使用 callLater() 排队的方法进行背景处理,直到调用 resumeBackgroundProcessing() 为止。 | UIComponent | ||
交换两个指定子对象的 Z 轴顺序(从前到后顺序)。 | DisplayObjectContainer | ||
在子级列表中两个指定的索引位置,交换子对象的 Z 轴顺序(前后顺序)。 | DisplayObjectContainer | ||
返回一个字符串,用于指示此对象在应用程序的 DisplayObject 层次结构中所处的位置。 | FlexSprite | ||
验证子项的位置和大小,并绘制其它可视内容。 | UIComponent | ||
验证并更新此对象的属性和布局,如果需要的话重绘对象。 | UIComponent | ||
由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。 | UIComponent | ||
如果使用此 ILayoutManagerClient 调用 LayoutManager.invalidateSize() 方法,随后在测量时调用了 validateSize() 方法,则验证组件的度量大小。 | UIComponent | ||
处理分配给此组件的验证程序调度的 valid 和 invalid 事件。 | UIComponent | ||
返回指定对象的原始值。 | Object | ||
返回一个框 Matrix,在绘制垂直渐变时可以将其作为 rot 参数传递给 drawRoundRect()。 | UIComponent | ||
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。 | EventDispatcher |
方法 | 定义方 | ||
---|---|---|---|
调整焦点矩形。 | UIComponent | ||
这是一个内部方法,供 Flex 框架用于支持 Dissolve 效果。 | UIComponent | ||
创建子对象后执行任何最终处理。 | UIComponent | ||
Text | |||
创建组件的子对象。 | UIComponent | ||
根据所用的嵌入字体使用上下文创建新对象。 | UIComponent | ||
使用给定的 moduleFactory 创建对象。 | UIComponent | ||
当 UIComponent 对象获得焦点时调用的事件处理函数。 | UIComponent | ||
当 UIComponent 对象失去焦点时调用的事件处理函数。 | UIComponent | ||
完成对此组件的初始化。 | UIComponent | ||
初始化此组件的辅助功能代码。 | UIComponent | ||
通常由包含 UITextField 对象的组件覆盖,其中 UITextField 对象获取焦点。 | UIComponent | ||
为 keyDown 事件调用的事件处理函数。 | UIComponent | ||
为 keyUp 事件调用的事件处理函数。 | UIComponent | ||
计算组件的默认大小和(可选)默认最小大小。 | UIComponent | ||
构建 UIComponent 时将调用此方法,并且每当 ResourceManager 调度“change”事件用于指示本地化资源已经过某种更改时,都会再次调用此方法。 | UIComponent | ||
绘制对象和/或设置其子项的大小和位置。 | UIComponent |
样式 | 说明 | 定义方 | ||
---|---|---|---|---|
类型: String CSS 继承: no 从内容区域的上边缘到控件的基线位置的垂直距离(以像素为单位)。如果设置此样式,则组件的基线锚定在其内容区域的上边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | |||
类型: String CSS 继承: no 从组件的下边缘到其内容区域的下边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的下边缘锚定在其内容区域的下边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | |||
类型: uint 格式: Color CSS 继承: yes 组件中文本(包括组件标签)的颜色。. | Label | |||
类型: uint 格式: Color CSS 继承: yes 禁用时组件中文本的颜色。. | Label | |||
类型: uint 格式: Color CSS 继承: yes 验证失败时,组件加亮部分的颜色。验证失败时,Flex 还会将组件的 borderColor 样式设置为 errorColor 。. | UIComponent | |||
类型: String CSS 继承: yes 设置内部 TextField 的 antiAliasType 属性。可能值为 "normal" (flash. | Label | |||
类型: String CSS 继承: yes 使用的字体的名称。与在完全 CSS 实现中不同,这里不支持逗号分隔的列表。您可以使用任何字体系列名称。如果您指定通用字体名称,它将转换为相应的设备字体。. | Label | |||
类型: String CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 gridFitType 属性。可能值为 "none" (flash. | Label | |||
类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 sharpness 属性。此属性指定字型边缘的清晰度。可能值为从 -400 到 400 之间的数字。 仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 . | Label | |||
类型: Number 格式: Length CSS 继承: yes 文本的高度,以像素为单位。除 ColorPicker 控件之外,所有控件的默认值都为 10。ColorPicker 控件的默认值为 11。. | Label | |||
类型: String CSS 继承: yes 确定文本是否使用斜体。可识别的值为 "normal" 和 "italic" 。. | Label | |||
类型: Number CSS 继承: yes 设置用于表示 Flex 控件文本的内部 TextField 的 thickness 属性。此属性指定字型边缘的粗细。可能值为从 -200 到 200 之间的数字。 仅当使用嵌入字体并将 此样式对系统字体不起作用。 此样式适用于 TextField 子控件中的所有文本;但不适用于部分字符。 . | Label | |||
类型: String CSS 继承: yes 确定文本是否使用粗体。可识别的值为 normal 和 bold 。Button 控件的默认值为 bold 。所有其它控件的默认值为 normal 。. | Label | |||
类型: String CSS 继承: no 从组件内容区域的中心到组件中心的水平距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整组件容器大小后,这两个中心将保持它们的水平间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | |||
类型: Boolean CSS 继承: yes 一个布尔值,指示是启用 ( true ) 还是禁用 (false ) 字距调整。字距调整会调整某些字符对之间的间隔以提高可读性,并应只在必要时(例如使用大字体标题时)使用。仅嵌入字体支持字距调整。某些字体(如宋体)和等宽字体(如 Courier New)不支持字距调整。. | Label | |||
leading | 类型: Number 格式: Length CSS 继承: yes 文本行之间附加的垂直空间。 默认值为 2。 ComboBox 控件的默认值为 0。 | Text | ||
类型: String CSS 继承: no 从组件内容区域的左边缘到组件左边缘的水平距离(以像素为单位)。如果设置此样式,则组件的左边缘锚定在其内容区域的左边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | |||
类型: Number CSS 继承: yes 各字符之间显示的附加像素数。如果为正值,则会在正常间距的基础上增加字符间距;如果为负值,则减小此间距。. | Label | |||
类型: Number 格式: Length CSS 继承: no 标签底部与文本底部之间的像素数目。. | Label | |||
类型: Number 格式: Length CSS 继承: no 标签的左侧与文本的左侧之间的像素数目。. | Label | |||
类型: Number 格式: Length CSS 继承: no 标签的右侧与文本的右侧之间的像素数目。. | Label | |||
类型: Number 格式: Length CSS 继承: no 标签顶部与文本顶部之间的像素数目。. | Label | |||
类型: String CSS 继承: no 从组件的右边缘到其内容区域的右边缘的水平距离(以像素为单位)。如果设置此样式,则组件的右边缘锚定在其内容区域的右边缘;调整组件容器大小后,这两个边缘将保持它们的间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | |||
类型: String CSS 继承: yes 容器内文本的对齐情况。可能值有: "left" 、"right" 或 "center" 。 大多数组件的默认值为 | Label | |||
类型: String CSS 继承: yes 确定文本是否加下划线。可能值有: "none" 和 "underline" 。. | Label | |||
类型: Number 格式: Length CSS 继承: yes 文本第一行偏离容器左侧的距离(以像素为单位)。. | Label | |||
类型: String CSS 继承: no 从控件内容区域的上边缘到组件上边缘的垂直距离(以像素为单位)。如果设置此样式,则组件的上边缘锚定在其内容区域的上边缘;调整其容器大小后,这两个边缘将保持其间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent | |||
类型: String CSS 继承: no 从组件内容区域的中心到组件中心的垂直距离(以像素为单位)。如果设置此样式,则组件的中心锚定在其内容区域的中心;调整其容器大小后,这两个中心将保持其垂直间距。 此样式仅在 Canvas 容器中的组件上,或在 Panel 或 Application 容器( 默认值为 | UIComponent |
Text | () | 构造函数 |
public function Text()
构造函数。
commitProperties | () | 方法 |
override protected function commitProperties():void
<?xml version="1.0"?> <!-- Simple example to demonstrate the Text control. --> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml"> <mx:Panel title="Text Control Example" height="75%" width="75%" paddingTop="10" paddingLeft="10" paddingRight="10"> <mx:Text width="100%"> <mx:text> This is a multiline, non-editable text component. If you need an editable multiline component, use TextArea. </mx:text> </mx:Text> <mx:Text width="100%"> <mx:htmlText> <![CDATA[This is <font color="#FF0000">HTML text</font> in a <b>Text component</b>. Using the <u>htmlText attribute</u> of the <font color="#008800">Text component</font> you can use basic HTML markup.]]> </mx:htmlText> </mx:Text> </mx:Panel> </mx:Application>