包 | spark.components |
类 | public class Label |
继承 | Label TextBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
子类 | EscapedLabel |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
text
属性确定。文本格式由元素的 CSS 样式指定,例如 fontFamily
和 fontSize
。
在 Flash Player 中,使用 Flash 文本引擎 (FTE) 的 Label 提供高质量的国际印刷效果。因为 Label 运行速度快且占用内存少,所以它特别适合用于显示多个小型非交互式文本的情况,例如,项呈示器和 Button 外观中的标签。
Spark 体系结构提供三个文本“原型”(Label、RichText 和 RichEditableText)作为其“仅在用户需要时支付”基本原理的一部分。Label 运行速度最快且占用内存最少,但其功能有限:无复杂格式、不可滚动、不可选择、不可编辑且无超链接。RichText 和 RichEditableText 基于 Text Layout Framework (TLF) 库,而不是 FTE。RichText 新增了使用复杂格式程示 HTML 等富文本的功能,但仍然完全是非交互式的。RichEditableText 运行速度最慢且占用内存最多,但可以执行所有功能:支持使用虚拟化 TextLine 进行滚动、选择、编辑、超链接,以及从 URL 加载图像。您应该使用能够满足需求的最快速的文本原型。
Spark Label 控件与 MX Label 控件 mx.controls.Label 类似。最重要的区别在于:
- Spark Label 使用 FTE(即播放器的新文本引擎),而 MX Label 使用 TextField 类。
- 与 MX Label 相比,Spark Label 可提供更佳的印刷效果,且能更好地支持各国语言。
- Spark Label 可以显示多行,但 MX Label 不可以。
- MX Label 可以显示 HTML 的有限子集,但 Spark Label 只能显示统一格式的文本。
- MX Label 可以设置为可选择的,但 Spark Label 不可以。
在 Spark Label 中,将以下三个字符序列识别为显式换行符:CR(“\r”
)、LF(“\n”
)和 CR+LF(“\r\n”
)。
如果没有为 Label 指定任何类型的宽度,则由这些显式换行符确定的最长行确定 Label 的宽度。
如果确实指定了某种类型的宽度,则指定文本将在组件边界的右边缘换行,因为 lineBreak
样式的默认值为 "toFit"
。如果文本扩展到低于组件底部,则将被剪切。
要禁用此自动换行,请将 lineBreak
样式设置为 "explicit"
。这样的话,只有 text
包含显式换行符时才会换行,且将剪切超过右边缘的行尾。
如果文本超出了显示这些文本的空间,Label 可以截断文本。截断文本意味着使用截断指示符(如 "...")替换超额文本。请参阅继承的属性 maxDisplayedLines
和 isTruncated
。
可以使用 lineHeight
样式控制行间距。可以使用 textAlign
、textAlignLast
和 verticalAlign
样式水平和垂直对齐元素范围内的文本。可以使用 paddingLeft
、paddingTop
、paddingRight
和 paddingBottom
样式从元素边缘插入文本。
默认情况下,Label 没有背景,但是可以使用 backgroundColor
和 backgroundAlpha
样式绘制一个背景。不支持边框。如果需要边框或更复杂的背景,请在 Label 后面使用单独的图形元素,例如 Rect。
Label 支持显示从左到右 (LTR) 书写的文本(如法语)、从右到左 (RTL) 书写的文本(如阿拉伯语)以及双向书写的文本(如阿拉伯语段落中的法语语句)。如果文本的主要书写方向为从右到左,可以将 direction
样式设置为“rtl”
。textAlign
样式默认为“start”
,这样,当 direction
为“ltr”
时,文本左对齐;当 direction
为“rtl”
时,文本右对齐。要获得反向对齐,请将 textAlign
设置为“end”
。
Label 在 Flash 文本引擎中使用 TextBlock 类创建一个或多个 TextLine 对象,以采用由其 CSS 样式确定的格式静态显示其 text 字符串。由于性能原因,其 TextLine 不包含有关各个字型的信息;有关更多信息,请参阅 flash.text.engine.TextLineValidity.STATIC。
Label 控件具有下列默认特征:
特征 | 说明 |
---|---|
默认大小 | 如果不包含文本,则为 0 个像素宽 × 12 个像素高;如果包含文本,则大小足以显示该文本 |
最小大小 | 0 个像素 |
最大大小 | 10000 个像素宽 × 10000 个像素高 |
The <s:Label>
tag inherits all of the tag
attributes of its superclass and adds the following tag attributes:
<s:Label Properties fontContext="" Styles alignmentBaseline="baseline" baselineShift="0" cffHinting="0.0" color="0x000000" digitCase="default" digitWidth="default" direction="ltr" dominantBaseline="auto" fontFamily="Arial" fontLookup="embeddedCFF" fontSize="12" fontStyle="normal" fontWeight="normal" justificationRule="auto" justificationStyle="auto" kerning="false" ligatureLevel="common" lineBreak="toFit" lineHeight="120%" lineThrough="false" locale="en" paddingBottom="0" paddingLeft="0" paddingRight="0" paddingTop="0" renderingMode="cff" textAlign="start" textAlignLast="start" textAlpha="1" textDecoration="start" textJustify="interWord" trackingLeft="0" trackingRight="00" typographicCase="default" verticalAlign="top" />
默认 MXML 属性text
相关 API 元素
方法 | 由以下参数定义 | ||
---|---|---|---|
Label()
构造函数。 | Label | ||
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | ||
将一个 DisplayObject 子实例添加到该 DisplayObjectContainer 实例中。 | DisplayObjectContainer | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。 | EventDispatcher | ||
将非可视样式客户端添加到该组件实例。 | UIComponent | ||
表示安全限制是否会导致出现以下情况:在列表中忽略了使用指定 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 | ||
返回元素的布局高度。 | 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 | ||
将 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 | ||
标记组件,以便在稍后屏幕更新期间调用该组件的 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 | ||
调整对象大小。 | UIComponent | ||
更改现有子项在显示对象容器中的位置。 | DisplayObjectContainer | ||
设置一个布局约束值的方式,与设置此组件的约束样式的方式相同。 | UIComponent | ||
设置当前状态。 | UIComponent | ||
设置此组件的焦点。 | UIComponent | ||
设置元素在屏幕上进行绘制时所用的坐标。 | UIComponent | ||
设置元素的布局大小。 | UIComponent | ||
设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。 | UIComponent | ||
设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。 | UIComponent | ||
设置循环操作动态属性的可用性。 | Object | ||
对此组件实例设置样式属性。 | UIComponent | ||
当 visible 属性发生更改时调用。 | UIComponent | ||
允许用户拖动指定的 Sprite。 | Sprite | ||
使用户可以在启用触摸的设备上拖动指定的 Sprite。 | Sprite | ||
对源起于此对象的所有 MovieClip 递归停止时间轴执行。 | DisplayObjectContainer | ||
结束 startDrag() 方法。 | Sprite | ||
结束 startTouchDrag() 方法,用于启用触摸的设备。 | Sprite | ||
检测对样式属性的更改。 | UIComponent | ||
首次初始化组件样式时,Flex 会调用 stylesInitialized() 方法。 | UIComponent | ||
[静态]
阻止对使用 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 |
样式为常见样式,或与特定主题关联。如果为常见样式,则可以用于任何主题。如果样式与特定主题关联,则只有应用程序使用该主题时才能使用该样式。
样式 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
alignmentBaseline | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定主要基线对齐到的基线。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.alignmentBaseline。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
类型: Number CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 由 backgroundColor 样式定义的颜色的 Alpha 级别. | TextBase | |||
类型: uint 格式: Color CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 此组件的整个边界矩形的背景色. | TextBase | |||
类型: 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 元素 | Label | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件底边到其父容器的内容区域底边之间的垂直距离(以像素为单位). | UIComponent | |||
cffHinting | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 用于此文本的 CFF 提示的类型。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.cffHinting。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
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 元素 | Label | ||
digitCase | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 用于此文本的数字大小写类型。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.digitCase。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
digitWidth | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 用于此文本的数字宽度类型。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.digitWidth。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
direction | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定文本的默认双向嵌入级别。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.direction。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
dominantBaseline | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定该元素的哪条基线对齐到 alignmentBaseline 以确定元素在该行上的垂直位置。
有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.dominantBaseline。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
类型: uint 格式: Color CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 验证失败时,组件加亮部分的颜色. | UIComponent | |||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 焦点矩形使用的混合模式. | UIComponent | |||
类型: 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 元素 | Label | ||
fontLookup | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 要使用的字体查找。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.fontLookup。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
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 元素 | Label | ||
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 元素 | Label | ||
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 元素 | Label | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的水平距离(以像素为单位). | UIComponent | |||
类型: 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 元素 | Label | ||
justificationStyle | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 段落两端对齐所用的样式。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.justificationStyle。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
kerning | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 段落两端对齐所用的样式。 Spark 组件默认启用字距调整,但 MX 组件默认禁用字距调整。Spark 组件将 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.kerning。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4.1 运行时版本: Flash10, AIR 1.5 指定组件的所需布局方向. | UIComponent | |||
类型: 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 元素 | Label | ||
lineBreak | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 控制容器内的文字换行。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.blockProgression。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
lineHeight | 类型: Object CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 文本的行距控制。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.lineHeight。
对于 Mobile 主题,它不受支持。请参阅 相关 API 元素 | Label | ||
lineThrough | 类型: Boolean CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 若为 true,则应用删除线(一条穿过文本中间的直线)。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.lineThrough。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
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 。了解详细信息 | Label | ||
paddingBottom | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 底部边界区,以像素为单位。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.paddingBottom。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
paddingLeft | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 左侧边界区,以像素为单位。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.paddingLeft。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
paddingRight | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 右侧边界区,以像素为单位。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.paddingRight。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
paddingTop | 类型: Number 格式: Length CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 顶部边界区,以像素为单位。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.paddingRight。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
renderingMode | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 仅适用于嵌入字体的用于该文本的呈示模式。 有关 Spark 主题,请参阅flashx.textLayout.formats.ITextLayoutFormat.renderingMode 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
类型: 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 | |||
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 元素 | Label | ||
textAlignLast | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 两端对齐文本中段落最后一行与容器的对齐方式。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.textAlignLast。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
textAlpha | 类型: Number CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 文本的 Alpha(透明度)值。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.textAlpha。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
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 元素 | Label | ||
textJustify | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 指定文本两端对齐的选项。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.textJustify。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
类型: 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 元素 | Label | ||
trackingRight | 类型: Object CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 要应用于每个字符右侧的间距量(手动字距调整)。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.trackingRight。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
typographicCase | 类型: String CSS 继承: 是 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 用于此文本的印刷大小写的类型。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.typographicCase。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
verticalAlign | 类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 4 运行时版本: Flash10, AIR 1.5 垂直对齐或两端对齐。 有关 Spark 主题,请参阅 flashx.textLayout.formats.ITextLayoutFormat.verticalAlign。 对于 Mobile 主题,它不受支持。 相关 API 元素 | Label | ||
类型: String CSS 继承: 否 语言版本: ActionScript 3.0 产品版本: Flex 3 运行时版本: Flash9, AIR 1.1 从组件内容区域的中心到组件中心的垂直距离(以像素为单位). | UIComponent |
样式 | 说明 | 由以下参数定义 | ||
---|---|---|---|---|
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 元素 | Label | ||
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 元素 | Label |
Label | () | 构造函数 |
public function Label()
语言版本: | ActionScript 3.0 |
产品版本: | Flex 4 |
运行时版本: | Flash Player 10, AIR 1.5 |
构造函数。
<?xml version="1.0" encoding="utf-8"?> <!-- LabelExample.mxml --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark"> <s:Panel title="Label Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:Group left="10" right="10" top="10" bottom="10"> <s:Label x="0" y="0" height="75" width="75"> <s:text>This is a Label control.</s:text> </s:Label> <s:Group x="100" y="0"> <s:Label height="100" width="75" paddingTop="5" paddingLeft="5" paddingRight="5" paddingBottom="5"> <s:text>This is a Spark Label control with a border drawn by a Rect.</s:text> </s:Label> <s:Rect width="100%" height="100%"> <s:stroke> <s:SolidColorStroke color="red"/> </s:stroke> </s:Rect> </s:Group> </s:Group> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:04 AM Z