包 | flashx.textLayout.container |
类 | public class ContainerController |
继承 | ContainerController Object |
实现 | IInteractionEventHandler, ITextLayoutFormat, ISandboxSupport |
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
相关 API 元素
flashx.textLayout.elements.TextFlow
flash.text.engine.TextLine
属性 | 由以下参数定义 | ||
---|---|---|---|
absoluteStart : int [只读]
返回容器中第一个字符。 | ContainerController | ||
alignmentBaseline : *
TextLayoutFormat:指定主要基线对齐到的基线。 | ContainerController | ||
backgroundAlpha : *
TextLayoutFormat:背景的 Alpha(透明度)值(如果在层叠期间未定义,则使用默认值)。 | ContainerController | ||
backgroundColor : *
TextLayoutFormat:文本的背景颜色(如果在层叠期间未定义,则使用默认值)。 | ContainerController | ||
baselineShift : *
TextLayoutFormat:从 dominantBaseline 值偏移基线的数量。 | ContainerController | ||
blockProgression : *
TextLayoutFormat:指定线位置的垂直或水平行进。 | ContainerController | ||
breakOpportunity : *
TextLayoutFormat:控制在将连续文本断开为多行时允许行断开的位置。 | ContainerController | ||
cffHinting : *
TextLayoutFormat:用于此文本的 CFF 提示的类型。 | ContainerController | ||
clearFloats : *
TextLayoutFormat:控制文本在浮点周围的环绕方式。 | ContainerController | ||
color : *
TextLayoutFormat:文本的颜色。 | ContainerController | ||
columnCount : *
TextLayoutFormat:文本列数(如果在层叠期间未定义,则使用默认值)。 | ContainerController | ||
columnGap : *
TextLayoutFormat:指定要在列之间留出的装订线空间量(以像素为单位),如果在层叠期间未定义,则使用默认值。 | ContainerController | ||
columnState : ColumnState [只读]
返回 ColumnState 对象,描述了容器中列的数目和特性。 | ContainerController | ||
columnWidth : *
TextLayoutFormat:列宽(以像素为单位)(如果在层叠期间未定义,则使用默认值)。 | ContainerController | ||
compositionHeight : Number [只读]
返回容器内允许的文本垂直范围。 | ContainerController | ||
compositionWidth : Number [只读]
返回容器内允许的文本水平范围。 | ContainerController | ||
computedFormat : flashx.textLayout.formats:ITextLayoutFormat [只读]
返回具有应用于此容器的属性的一个 ITextLayoutFormat 实例,包括从其根元素继承的属性。 | ContainerController | ||
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
container : Sprite [只读]
返回包含此 ContainerController 实例文本行的容器显示对象。 | ContainerController | ||
containerControllerInitialFormat : flashx.textLayout.formats:ITextLayoutFormat [静态] | ContainerController | ||
coreStyles : Object [只读] 返回此 ContainerController 的 coreStyles。 | ContainerController | ||
digitCase : *
TextLayoutFormat:用于此文本的数字大小写类型。 | ContainerController | ||
digitWidth : *
TextLayoutFormat:用于此文本的数字宽度类型。 | ContainerController | ||
direction : *
TextLayoutFormat:指定文本在文本块中的默认双向嵌入级别。 | ContainerController | ||
dominantBaseline : *
TextLayoutFormat:指定该元素的哪条基线紧贴到 alignmentBaseline 以确定元素在该行上的垂直位置。 | ContainerController | ||
firstBaselineOffset : *
TextLayoutFormat:指定容器中第一行的基线位置。 | ContainerController | ||
flowComposer : IFlowComposer [只读]
返回流合成器对象,该对象可将文本合成到由此控制器管理的容器,并加亮该文本。 | ContainerController | ||
fontFamily : *
TextLayoutFormat:要使用的字体的名称或用逗号分隔的字体名称列表。 | ContainerController | ||
fontLookup : *
TextLayoutFormat:要使用的字体查找。 | ContainerController | ||
fontSize : *
TextLayoutFormat:文本的大小(以像素为单位)。 | ContainerController | ||
fontStyle : *
TextLayoutFormat:文本的样式。 | ContainerController | ||
fontWeight : *
TextLayoutFormat:文本的粗细。 | ContainerController | ||
format : flashx.textLayout.formats:ITextLayoutFormat
存储包含此容器属性的 ITextLayoutFormat 对象。 | ContainerController | ||
horizontalScrollPolicy : String
指定水平滚动方式,这可以通过指定 ScrollPolicy 类的一个常量来设置:ON、OFF 或 AUTO。 | ContainerController | ||
horizontalScrollPosition : Number 指定舞台上当前的水平滚动位置。 | ContainerController | ||
interactionManager : ISelectionManager [只读]
与该 TextFlow 对象关联的 InteractionManager。 | ContainerController | ||
justificationRule : *
TextLayoutFormat:用于将段落中的文本两端对齐的规则。 | ContainerController | ||
justificationStyle : *
TextLayoutFormat:用于将段落两端对齐的样式。 | ContainerController | ||
kerning : *
TextLayoutFormat:字距调整可调整某些字符对之间的像素以提高可读性。 | ContainerController | ||
leadingModel : *
TextLayoutFormat:指定行距模型,它是行距基准和行距方向的组合。 | ContainerController | ||
ligatureLevel : *
TextLayoutFormat:控制可以在该文本中使用字体中定义的哪些连字。 | ContainerController | ||
lineBreak : *
TextLayoutFormat:控制容器内的换行(如果在层叠期间未定义,则使用默认值)。 | ContainerController | ||
lineHeight : *
TextLayoutFormat:文本的行距控制。 | ContainerController | ||
lineThrough : *
TextLayoutFormat:若为 true,则应用删除线(一条穿过文本中间的直线)。 | ContainerController | ||
linkActiveFormat : *
TextLayoutFormat:定义用于处于正常状态的链接的格式属性。 | ContainerController | ||
linkHoverFormat : *
TextLayoutFormat:定义当鼠标在链接边界内(悬停)时用于悬停状态链接的格式属性。 | ContainerController | ||
linkNormalFormat : *
TextLayoutFormat:定义用于处于正常状态的链接的格式属性。 | ContainerController | ||
listAutoPadding : *
TextLayoutFormat:指定当列表相应侧的内边距值为 auto 时,列表开始边缘的自动缩进。 | ContainerController | ||
listMarkerFormat : *
TextLayoutFormat:定义列表标记的格式属性。 | ContainerController | ||
listStylePosition : *
TextLayoutFormat:合法值为 ListStylePosition.INSIDE、ListStylePosition.OUTSIDE、FormatValue.INHERIT。默认值未定义,指示未设置。如果在层叠期间未定义,则此属性将从一个祖代继承值。 | ContainerController | ||
listStyleType : *
TextLayoutFormat:合法值为 ListStyleType.UPPER_ALPHA、ListStyleType.LOWER_ALPHA、ListStyleType.UPPER_ROMAN、ListStyleType.LOWER_ROMAN、ListStyleType.NONE、ListStyleType.DISC、ListStyleType.CIRCLE、ListStyleType.SQUARE、ListStyleType.BOX、ListStyleType.CHECK、ListStyleType.DIAMOND、ListStyleType.HYPHEN、ListStyleType.ARABIC_INDIC、ListStyleType.BENGALI、ListStyleType.DECIMAL、ListStyleType.DECIMAL_LEADING_ZERO、ListStyleType.DEVANAGARI、ListStyleType.GUJARATI、ListStyleType.GURMUKHI、ListStyleType.KANNADA、ListStyleType.PERSIAN、ListStyleType.THAI、ListStyleType.URDU、ListStyleType.CJK_EARTHLY_BRANCH、ListStyleType.CJK_HEAVENLY_STEM、ListStyleType.HANGUL、ListStyleType.HANGUL_CONSTANT、ListStyleType.HIRAGANA、ListStyleType.HIRAGANA_IROHA、ListStyleType.KATAKANA、ListStyleType.KATAKANA_IROHA、ListStyleType.LOWER_ALPHA、ListStyleType.LOWER_GREEK、ListStyleType.LOWER_LATIN、ListStyleType.UPPER_ALPHA、ListStyleType.UPPER_GREEK、ListStyleType.UPPER_LATIN、FormatValue.INHERIT。默认值未定义,指示未设置。如果在层叠期间未定义,则此属性将从一个祖代继承值。 | ContainerController | ||
locale : *
TextLayoutFormat:文本的区域设置。 | ContainerController | ||
paddingBottom : *
TextLayoutFormat:底部边界区(像素数)。 | ContainerController | ||
paddingLeft : *
TextLayoutFormat:左侧边界区(像素数)。 | ContainerController | ||
paddingRight : *
TextLayoutFormat:右侧边界区(像素数)。 | ContainerController | ||
paddingTop : *
TextLayoutFormat:顶部边界区(像素数)。 | ContainerController | ||
paragraphEndIndent : *
TextLayoutFormat:一个数字,指定段落结束边缘的缩进量(像素数)。 | ContainerController | ||
paragraphSpaceAfter : *
TextLayoutFormat:一个数字,指定在段落后留出的空白(像素数)。 | ContainerController | ||
paragraphSpaceBefore : *
TextLayoutFormat:一个数字,指定在段落前留出的空白(像素数)。 | ContainerController | ||
paragraphStartIndent : *
TextLayoutFormat:一个数字,指定段落开始边缘的缩进量(像素数)。 | ContainerController | ||
renderingMode : *
TextLayoutFormat:用于此文本的呈现模式。 | ContainerController | ||
rootElement : ContainerFormattedElement [只读]
返回容器中显示的根元素。 | ContainerController | ||
styleName : *
TextLayoutFormat:为元素指定一个标识类,从而可以通过引用 styleName 来设置元素样式。 | ContainerController | ||
styles : Object [只读] 返回此 ContainerController 的样式。 | ContainerController | ||
tabStops : *
TextLayoutFormat:指定与段落关联的制表位。 | ContainerController | ||
textAlign : *
TextLayoutFormat:段落中的行与容器的对齐方式。 | ContainerController | ||
textAlignLast : *
TextLayoutFormat:两端对齐文本中段落最后一行(或唯一的一行)与容器的对齐方式。 | ContainerController | ||
textAlpha : *
TextLayoutFormat:文本的 Alpha(透明度)值。 | ContainerController | ||
textDecoration : *
TextLayoutFormat:文本上的装饰。 | ContainerController | ||
textFlow : flashx.textLayout.elements:TextFlow [只读]
返回其内容出现在容器中的 TextFlow 对象。 | ContainerController | ||
textIndent : *
TextLayoutFormat:一个数字,指定段落第一行的缩进量(以像素为单位)。 | ContainerController | ||
textJustify : *
TextLayoutFormat:指定文本两端对齐的选项。 | ContainerController | ||
textLength : int [只读] 返回容器中的字符总数。 | ContainerController | ||
textRotation : *
TextLayoutFormat:确定要旋转此文本的度数。 | ContainerController | ||
trackingLeft : *
TextLayoutFormat:像素数(或字体大小的百分比,如 120%),指示应用于每个字符左侧的间隙数(手动字距调整)。 | ContainerController | ||
trackingRight : *
TextLayoutFormat:像素数(或字体大小的百分比,如 120%)表示要应用到每个字符右边的间距的量(手动字距调整)。 | ContainerController | ||
typographicCase : *
TextLayoutFormat:用于此文本的印刷大小写的类型。 | ContainerController | ||
userStyles : Object 允许您针对 ContainerController 对象读写用户样式。 | ContainerController | ||
verticalAlign : *
TextLayoutFormat:垂直对齐或两端对齐(如果在层叠期间未定义,则使用默认值)。 | ContainerController | ||
verticalScrollPolicy : String 指定垂直滚动方式,这可以通过指定 ScrollPolicy 类的一个常量来设置:ON、OFF 或 AUTO。 | ContainerController | ||
verticalScrollPosition : Number 指定舞台上当前的垂直滚动位置。 | ContainerController | ||
whiteSpaceCollapse : *
TextLayoutFormat:将文本导入到 TextFlow 中时压缩或保留空白。 | ContainerController | ||
wordSpacing : *
TextLayoutFormat:指定在两端对齐期间使用的单词之间的最佳间距、最小间距和最大间距(作为普通间距宽度的乘数)。 | ContainerController |
方法 | 由以下参数定义 | ||
---|---|---|---|
ContainerController(container:Sprite, compositionWidth:Number = 100, compositionHeight:Number = 100)
构造函数 - 创建一个 ContainerController 实例。 | ContainerController | ||
当客户端管理事件时处理 Event.ACTIVATE 事件。 | ContainerController | ||
在“拖动”选择期间处理滚动事件。 | ContainerController | ||
请求客户端开始从安全沙箱外部转发 mouseup 和 mousemove 事件时调用。 | ContainerController | ||
从该 FlowElement 中清除由 styleProp 指定的样式。 | ContainerController | ||
当客户端管理事件时处理 Event.DEACTIVATE 事件。 | ContainerController | ||
当客户端管理事件时处理编辑事件(CUT、COPY、PASTE、SELECT_ALL)。 | ContainerController | ||
通知客户端不再需要从安全沙箱外部转发 mouseup 和 mousemove 事件时调用。 | ContainerController | ||
当客户端管理事件时处理 FocusEvent.KEY_FOCUS_CHANGE 和 FocusEvent.MOUSE_FOCUS_CHANGE 事件。 | ContainerController | ||
当客户端管理事件时处理 FocusEvent.FOCUS_IN 事件。 | ContainerController | ||
当客户端管理事件时处理 FocusEvent.FOCUS_OUT 事件。 | ContainerController | ||
返回文本所占用的区域,该区域由上一个合成或更新操作反映。 | ContainerController | ||
计算要向上或向下滚动指定行数所需的滚动距离。 | ContainerController | ||
返回 styleProp 参数指定的样式值。 | ContainerController | ||
表示对象是否已经定义了指定的属性。 | Object | ||
当客户端管理事件时处理 IMEEvent.IME_START_COMPOSITION 事件。 | ContainerController | ||
将此容器中所有文本标记为需要进行合成。 | ContainerController | ||
确定容器是否具有需要合成的文本。 | ContainerController | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
当客户端管理事件时处理 KeyboardEvent.KEY_DOWN 事件。 | ContainerController | ||
当客户端管理事件时处理 FocusEvent.KEY_FOCUS_CHANGE 事件。 | ContainerController | ||
当客户端管理事件时处理 Keyboard.KEY_UP 事件。 | ContainerController | ||
当客户端管理事件时处理 ContextMenuEvent.MENU_SELECT 事件。 | ContainerController | ||
当客户端管理事件时处理 MouseEvent.DOUBLE_CLICK 事件。 | ContainerController | ||
当客户端管理事件时处理 MouseEvent.MOUSE_DOWN 事件。 | ContainerController | ||
当客户端管理事件时处理 MouseEvent.MOUSE_MOVE 事件。 | ContainerController | ||
用于从安全沙箱外部转发 mouseMove 事件的客户端调用。 | ContainerController | ||
当客户端管理事件时处理 MouseEvent.MOUSE_OUT 事件。 | ContainerController | ||
当客户端管理事件时处理 MouseEvent.MOUSE_OVER 事件。 | ContainerController | ||
当客户端管理事件时处理 MouseEvent.MOUSE_UP 事件。 | ContainerController | ||
客户端调用以从安全沙箱外转发一个 mouseUp 事件。 | ContainerController | ||
当客户端管理事件时处理 MouseEvent.MOUSE_WHEEL 事件。 | ContainerController | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
允许滚动,使文本范围在容器中可见。 | ContainerController | ||
在实现 ITextSupport 的组件中设置选定文本的范围。 | ContainerController | ||
设置容器中允许的文本宽度和高度。 | ContainerController | ||
设置循环操作动态属性的可用性。 | Object | ||
将 styleProp 参数指定的样式值设置为 newValue 参数指定的值。 | ContainerController | ||
当客户端管理事件时处理 SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING 事件。 | ContainerController | ||
当客户端管理事件时处理 TextEvent.TEXT_INPUT 事件。 | ContainerController | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
返回指定对象的字符串表示形式。 | Object | ||
返回指定对象的原始值。 | Object |
方法 | 由以下参数定义 | ||
---|---|---|---|
添加要在其上绘制背景形状(如背景颜色)的 flash.display.Shape 对象。 | ContainerController | ||
addInlineGraphicElement(parent:DisplayObjectContainer, inlineGraphicElement:DisplayObject, index:int):void
将 flash.display.DisplayObject 对象作为父级的后代添加。 | ContainerController | ||
添加要向其添加选区形状(如块选区加亮、光标等)的 flash.display.DisplayObjectContainer 对象。 | ContainerController | ||
将 flash.text.engine.TextLine 对象作为 container 的后代添加。 | ContainerController | ||
为 ContainerController 创建上下文菜单。 | ContainerController | ||
获取第一个文本行必须出现在其父级内的索引。 | ContainerController | ||
删除要在其上绘制背景形状(如背景颜色)的 flash.display.Shape 对象。 | ContainerController | ||
从 flash.display.DisplayObject 对象的父级删除该对象。 | ContainerController | ||
删除包含选区形状(如块选区加亮、光标等)的 flash.display.DisplayObjectContainer 对象。 | ContainerController | ||
从 flash.text.engine.TextLine 对象的父级删除该对象。 | ContainerController | ||
如果滚动,将滚动矩形设置为容器矩形,这样会将显示一半的任何行剪裁到可滚动区域。 | ContainerController |
_mouseWheelListenerAttached | 属性 |
tlf_internal var _mouseWheelListenerAttached:Boolean = false
absoluteStart | 属性 |
alignmentBaseline | 属性 |
alignmentBaseline:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定主要基线对齐到的基线。例如,如果将 dominantBaseline
设置为 ASCENT,则将 alignmentBaseline
设置为 DESCENT 会将文本的顶部与下缘基线对齐,或在该线下面。基线通常由行中最大的元素决定。
合法值为 TextBaseline.ROMAN、TextBaseline.ASCENT、TextBaseline.DESCENT、TextBaseline.IDEOGRAPHIC_TOP、TextBaseline.IDEOGRAPHIC_CENTER、TextBaseline.IDEOGRAPHIC_BOTTOM、TextBaseline.USE_DOMINANT_BASELINE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextBaseline.USE_DOMINANT_BASELINE。
实现
public function get alignmentBaseline():*
public function set alignmentBaseline(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
backgroundAlpha | 属性 |
backgroundAlpha:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:背景的 Alpha(透明度)值(如果在层叠期间未定义,则使用默认值)。值为 0 表示完全透明,值为 1 表示完全不透明。Alpha 设置为 0 的显示对象是活动对象,即使它们不可见。
合法值为 0 到 1 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性值为 1。
实现
public function get backgroundAlpha():*
public function set backgroundAlpha(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
backgroundColor | 属性 |
backgroundColor:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的背景颜色(如果在层叠期间未定义,则使用默认值)。可以是常量值 BackgroundColor.TRANSPARENT
,或一个指定三个 8 位 RGB(红、绿、蓝)值的十六进制值,例如 0xFF0000 表示红色,0x00FF00 表示绿色。
合法字符串值为 BackgroundColor.TRANSPARENT、FormatValue.INHERIT 和从 0x0 到 0xffffffff 范围内的非整数。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 BackgroundColor.TRANSPARENT。
实现
public function get backgroundColor():*
public function set backgroundColor(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
baselineShift | 属性 |
baselineShift:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:基线距 dominantBaseline
值的偏移量。单位是像素或者 fontSize
的百分比(此时应输入字符串值,例如 140%)。如果是正值,则将水平文本行向上(对于垂直文本行是向右)移动;如果是负值,则将水平文本行向下(对于垂直文本行是向左)移动。
合法值为 BaselineShift.SUPERSCRIPT、BaselineShift.SUBSCRIPT、FormatValue.INHERIT。
合法值为 -1000 到 1000 范围内的数字。
百分比合法值为 -1000 到 1000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0.0。
实现
public function get baselineShift():*
public function set baselineShift(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
blockProgression | 属性 |
blockProgression:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定线位置的垂直或水平行进。将行按照从上至下(BlockProgression.TB
,用于水平文本行)或从右至左(BlockProgression.RL
,用于垂直文本行)的顺序放置。
合法值为 BlockProgression.RL、BlockProgression.TB、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 BlockProgression.TB。
实现
public function get blockProgression():*
public function set blockProgression(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
breakOpportunity | 属性 |
breakOpportunity:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:控制在将连续文本断开为多行时允许行断开的位置。设置为 BreakOpportunity.AUTO
以正常断开文本。设置为 BreakOpportunity.NONE
以不断开文本,除非文本会超出测量限度且不存在任何其它位置来断开行。设置为 BreakOpportunity.ANY
以允许该行在任意位置断开,而不是仅仅在单词之间断开。设置为 BreakOpportunity.ALL
以将每个排版群集放置在一个单独的行上(对于路径上的文本很有用)。
合法值为 BreakOpportunity.ALL、BreakOpportunity.ANY、BreakOpportunity.AUTO、BreakOpportunity.NONE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 BreakOpportunity.AUTO。
实现
public function get breakOpportunity():*
public function set breakOpportunity(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
cffHinting | 属性 |
cffHinting:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于此文本的 CFF 提示的类型。CFF 提示决定了 Flash 运行时是否强制让粗水平线适合子像素网格。只有当 renderingMode
属性被设置为 RenderingMode.CFF
且嵌入了字体(fontLookup
属性被设置为 FontLookup.EMBEDDED_CFF
)时,才会应用此属性。对于小的屏幕尺寸,提示将生成让人易于阅读的清晰文本。
合法值为 CFFHinting.NONE、CFFHinting.HORIZONTAL_STEM、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 CFFHinting.HORIZONTAL_STEM。
实现
public function get cffHinting():*
public function set cffHinting(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
clearFloats | 属性 |
clearFloats:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:控制文本在浮点周围的环绕方式。如果值为 none,将使得文本更紧密地环绕在浮点周围。如果值为 left,将导致文本跳过容器中具有左侧浮点的任意部分,而如果值为 right,将导致文本跳过容器中具有右侧浮点的任意部分。如果值为 both,将导致文本跳过所有浮点。
合法值为 ClearFloats.START、ClearFloats.END、ClearFloats.LEFT、ClearFloats.RIGHT、ClearFloats.BOTH、ClearFloats.NONE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 ClearFloats.NONE。
实现
public function get clearFloats():*
public function set clearFloats(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
color | 属性 |
color:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的颜色。一个十六进制数字,指定三个 8 位 RGB(红、绿、蓝)值,例如 0xFF0000 表示红色,0x00FF00 表示绿色。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get color():*
public function set color(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
columnCount | 属性 |
columnCount:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本列数(如果在层叠期间未定义,则使用默认值)。该列数会覆盖其它列设置。该值是一个整数,如果未指定,则为 FormatValue.AUTO
。如果未指定 columnCount
,则系统使用 columnWidth
创建容器可容纳的尽可能多的列。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 1 到 50 范围内的整数。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get columnCount():*
public function set columnCount(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
columnGap | 属性 |
columnGap:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定要在列之间留出的装订线空间量(以像素为单位),如果在层叠期间未定义,则使用默认值。该值是一个数字。
合法值为 0 到 1000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性值为 20。
实现
public function get columnGap():*
public function set columnGap(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
columnState | 属性 |
columnState:ColumnState
[只读] 语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
返回 ColumnState 对象,描述了容器中列的数目和特性。当重新合成文本(通过执行 IFlowComposer.compose()
或 IFlowComposer.updateAllControllers()
)时会更新这些值。
实现
public function get columnState():ColumnState
相关 API 元素
columnWidth | 属性 |
columnWidth:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:列宽(以像素为单位)(如果在层叠期间未定义,则使用默认值)。如果指定了列宽而没有指定列数,则 TextLayout 将根据容器宽度和 columnGap
设置,尽可能多地创建具有该宽度的列。在最后一个列之后将留出任意空格。该值是一个数字。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 0 到 8000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get columnWidth():*
public function set columnWidth(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
compositionHeight | 属性 |
compositionWidth | 属性 |
computedFormat | 属性 |
computedFormat:flashx.textLayout.formats:ITextLayoutFormat
[只读] 语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
返回具有应用于此容器的属性的一个 ITextLayoutFormat 实例,包括从其根元素继承的属性。
实现
public function get computedFormat():flashx.textLayout.formats:ITextLayoutFormat
相关 API 元素
container | 属性 |
containerControllerInitialFormat | 属性 |
containerControllerInitialFormat:flashx.textLayout.formats:ITextLayoutFormat
实现
public static function get containerControllerInitialFormat():flashx.textLayout.formats:ITextLayoutFormat
public static function set containerControllerInitialFormat(value:flashx.textLayout.formats:ITextLayoutFormat):void
coreStyles | 属性 |
digitCase | 属性 |
digitCase:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于此文本的数字大小写类型。将该值设置为 DigitCase.OLD_STYLE
时接近支持不同上行字母和下行字母的小写字母形式。各位数字之间等比间隔。此样式只适用于所选的字体,最常用于 supplemental 或 expert 字体。DigitCase.LINING
设置具有 all-cap(全大写)高度,通常为等宽以便在图表中对齐。
合法值为 DigitCase.DEFAULT、DigitCase.LINING、DigitCase.OLD_STYLE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 DigitCase.DEFAULT。
实现
public function get digitCase():*
public function set digitCase(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
digitWidth | 属性 |
digitWidth:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于此文本的数字宽度类型。可以是 DigitWidth.PROPORTIONAL
,最适用于显示单独出现的数字,或者是 DigitWidth.TABULAR
,最适用于显示表、图表和垂直行中的数字。
合法值为 DigitWidth.DEFAULT、DigitWidth.PROPORTIONAL、DigitWidth.TABULAR、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 DigitWidth.DEFAULT。
实现
public function get digitWidth():*
public function set digitWidth(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
direction | 属性 |
direction:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定文本在文本块中的默认双向嵌入级别。从左到右的阅读顺序,如在拉丁风格的文本中,或者从右到左的阅读顺序,如阿拉伯语或希伯来语。此属性还影响在容器级别应用时列的方向。与文本一样,列可以为从左到右或从右到左排列。下面给出了一些示例:
合法值为 Direction.LTR、Direction.RTL、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 Direction.LTR。
实现
public function get direction():*
public function set direction(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
dominantBaseline | 属性 |
dominantBaseline:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定该元素的哪条基线紧贴到 alignmentBaseline
以确定元素在该行上的垂直位置。值为 TextBaseline.AUTO
会基于父段落的 locale
属性选择主要基线。对于日语和中文,选定的基线值是 TextBaseline.IDEOGRAPHIC_CENTER
;对于所有其它语言,选定的基线值是 TextBaseline.ROMAN
。这些基线选项由选择的字体和字体大小决定。
合法值为 FormatValue.AUTO、TextBaseline.ROMAN、TextBaseline.ASCENT、TextBaseline.DESCENT、TextBaseline.IDEOGRAPHIC_TOP、TextBaseline.IDEOGRAPHIC_CENTER、TextBaseline.IDEOGRAPHIC_BOTTOM、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 FormatValue.AUTO。
实现
public function get dominantBaseline():*
public function set dominantBaseline(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
firstBaselineOffset | 属性 |
firstBaselineOffset:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定容器中第一行的基线位置。该属性引用的基线取决于容器级别的区域设置。对于日语和中文,为 TextBaseline.IDEOGRAPHIC_BOTTOM
;对于所有其它语言,为 TextBaseline.ROMAN
。从容器顶部边界(如果 blockProgression
是 RL 则为右侧边界)到第一行的基线之间的偏移可以是 BaselineOffset.ASCENT
,表示等于行的 ascent(文本顶端或右端到基线的距离),也可以是 BaselineOffset.LINE_HEIGHT
,表示等于第一行的高度,或者是任何固定值数字,用于指定绝对距离。BaselineOffset.AUTO
可将行的 ascent 与容器顶部边界对齐。
合法字符串值为 BaselineOffset.AUTO、BaselineOffset.ASCENT、BaselineOffset.LINE_HEIGHT、FormatValue.INHERIT 和从 0 到 1000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 BaselineOffset.AUTO。
实现
public function get firstBaselineOffset():*
public function set firstBaselineOffset(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
flowComposer | 属性 |
flowComposer:IFlowComposer
[只读] 语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
返回流合成器对象,该对象可将文本合成到由此控制器管理的容器,并加亮该文本。
实现
public function get flowComposer():IFlowComposer
相关 API 元素
fontFamily | 属性 |
fontFamily:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:要使用的字体的名称或用逗号分隔的字体名称列表。Flash 运行时使用列表中的第一个可用字体呈现该元素。例如,“Arial, Helvetica, _sans”使播放器搜索 Arial;如果没有找到 Arial,则搜索 Helvetica;如果两者都没找到,则搜索 _sans。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 Arial。
实现
public function get fontFamily():*
public function set fontFamily(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
fontLookup | 属性 |
fontLookup:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:要使用的字体查找。指定为 FontLookup.DEVICE
时会使用运行 SWF 文件的系统上安装的字体。设备字体会减小影片大小,但是在不同系统和平台中文本的呈现方式可能不同。指定为 FontLookup.EMBEDDED_CFF
时会使用嵌入到已发布的 SWF 文件中的字体轮廓。嵌入的字体会增大 SWF 文件大小(有时程度很大),但是文本以所选的字体一致显示。
合法值为 FontLookup.DEVICE、FontLookup.EMBEDDED_CFF、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 FontLookup.DEVICE。
实现
public function get fontLookup():*
public function set fontLookup(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
fontSize | 属性 |
fontSize:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的大小(以像素为单位)。
合法值为 1 到 720 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 12。
实现
public function get fontSize():*
public function set fontSize(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
fontStyle | 属性 |
fontStyle:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的样式。可以为 FontPosture.NORMAL
,用于纯文本,或者为 FontPosture.ITALIC
,用于斜体。此属性只应用于设备字体(fontLookup
属性设置为 flash.text.engine.FontLookup.DEVICE 时)。
合法值为 FontPosture.NORMAL、FontPosture.ITALIC、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 FontPosture.NORMAL。
实现
public function get fontStyle():*
public function set fontStyle(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
fontWeight | 属性 |
fontWeight:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的粗细。可以为 FontWeight.NORMAL
,用于纯文本,或者为 FontWeight.BOLD
。只应用于设备字体(fontLookup
属性设置为 flash.text.engine.FontLookup.DEVICE 时)。
合法值为 FontWeight.NORMAL、FontWeight.BOLD、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 FontWeight.NORMAL。
实现
public function get fontWeight():*
public function set fontWeight(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
format | 属性 |
format:flashx.textLayout.formats:ITextLayoutFormat
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
存储包含此容器属性的 ITextLayoutFormat 对象。控制器从所属的 TextFlow 继承容器属性。此属性允许同一个文本流中的不同控制器具有(例如)不同的列设置或填充。
实现
public function get format():flashx.textLayout.formats:ITextLayoutFormat
public function set format(value:flashx.textLayout.formats:ITextLayoutFormat):void
相关 API 元素
horizontalScrollPolicy | 属性 |
horizontalScrollPosition | 属性 |
interactionManager | 属性 |
interactionManager:ISelectionManager
[只读] 语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
与该 TextFlow 对象关联的 InteractionManager。
控制所有文本选择和编辑。如果 TextFlow 不可选择,则 interactionManager 为 null。要使 TextFlow 可编辑,请指定既是 ISelectionManager 又是 IEditManager 的 interactionManager。要使 TextFlow 为只读且可以选择,请指定只是 ISelectionManager 的 interactionManager。
实现
public function get interactionManager():ISelectionManager
相关 API 元素
justificationRule | 属性 |
justificationRule:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于将段落中的文本两端对齐的规则。默认值为 FormatValue.AUTO
,它基于段落的 locale
属性将文本两端对齐。对于除了日语和中文之外的所有语言,FormatValue.AUTO
会变成 JustificationRule.SPACE
,后者会向空格字符添加额外的空格。对于日语和中文,FormatValue.AUTO
会变成 JustficationRule.EAST_ASIAN
。在某种程度上,两端对齐会改变标点的间距。在罗马文本中,逗号和日语句号占一个全字符的宽度,但在东亚文本中,仅占一个字符宽度的一半。另外,在东亚文本中,连续的标点符号之间的间距会变得更紧密,遵守传统东亚排版惯例。同样要注意的是,在下面的示例中,应用到段落的第二行的行距。在东亚版本中,最后两行向左推进。在罗马版本中,第二行和之后的行向左推进。
合法值为 JustificationRule.EAST_ASIAN、JustificationRule.SPACE、FormatValue.AUTO、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 FormatValue.AUTO。
实现
public function get justificationRule():*
public function set justificationRule(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
justificationStyle | 属性 |
justificationStyle:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于将段落两端对齐的样式。仅与 JustificationRule.EAST_ASIAN
的 justificationRule
设置一起使用。对于所有区域设置,FormatValue.AUTO
的默认值被解析为 JustificationStyle.PUSH_IN_KINSOKU
。JustificationStyle 类定义的常量指定用于处理避头尾 (kinsoku) 字符的选项;避头尾字符是指不能出现在一行首尾的日语字符。如果希望文本布局更宽松,请指定 JustificationStyle.PUSH-OUT-ONLY
。如果希望文本布局类似于使用 JustificationRule.SPACE
的 justificationRule
得到的结果,可使用 JustificationStyle.PRIORITIZE-LEAST-ADJUSTMENT
。
合法值为 JustificationStyle.PRIORITIZE_LEAST_ADJUSTMENT、JustificationStyle.PUSH_IN_KINSOKU、JustificationStyle.PUSH_OUT_ONLY、FormatValue.AUTO、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 FormatValue.AUTO。
实现
public function get justificationStyle():*
public function set justificationStyle(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
kerning | 属性 |
kerning:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:字距调整可调整某些字符对之间的像素以提高可读性。字距调整表的所有字体都支持字距调整。
合法值为 Kerning.ON、Kerning.OFF、Kerning.AUTO、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 Kerning.AUTO。
实现
public function get kerning():*
public function set kerning(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
leadingModel | 属性 |
leadingModel:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定行距模型,它是行距基准和行距方向的组合。行距基准是 lineHeight
属性引用的基线。行距方向决定了 lineHeight
属性是引用一行基线与前一行基线之间的距离,还是与后一行基线之间的距离。默认值 FormatValue.AUTO
根据段落的 locale
属性进行解析。对于日语和中文,为 LeadingModel.IDEOGRAPHIC_TOP_DOWN
,对于所有其他语言,为 LeadingModel.ROMAN_UP
。
行距基准:
行距方向:
合法值为 LeadingModel.ROMAN_UP、LeadingModel.IDEOGRAPHIC_TOP_UP、LeadingModel.IDEOGRAPHIC_CENTER_UP、LeadingModel.IDEOGRAPHIC_TOP_DOWN、LeadingModel.IDEOGRAPHIC_CENTER_DOWN、LeadingModel.APPROXIMATE_TEXT_FIELD、LeadingModel.ASCENT_DESCENT_UP、LeadingModel.BOX、LeadingModel.AUTO、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 LeadingModel.AUTO。
实现
public function get leadingModel():*
public function set leadingModel(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
ligatureLevel | 属性 |
ligatureLevel:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:控制可以在该文本中使用字体中定义的哪些连字。对于每个设置显示的连字取决于字体。由两个或两个以上的字母结合在一起形成单个字型时就是连字。连字通常用于替换一些共享公共部分的连续字符,例如字母对“fi”、“fl”或“ae”。在拉丁语字符集和非拉丁语字符集中均可使用连字。LigatureLevel 类的值(MINIMUM
、COMMON
、UNCOMMON
和 EXOTIC
)支持的连字是添加的。每个值支持一个新连字集,而且包含先前类型的那些连字。
注意:使用阿拉伯语或叙利亚语字体时,必须将 ligatureLevel
设置为 MINIMUM 或更高。
合法值为 LigatureLevel.MINIMUM、LigatureLevel.COMMON、LigatureLevel.UNCOMMON、LigatureLevel.EXOTIC、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 LigatureLevel.COMMON。
实现
public function get ligatureLevel():*
public function set ligatureLevel(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
lineBreak | 属性 |
lineBreak:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:控制容器内的换行(如果在层叠期间未定义,则使用默认值)。可以将容器中的文本设置为适合容器的宽度 (LineBreak.TO_FIT
),也可以设置为只在显式回车或换行符处断开 (LineBreak.EXPLICIT
)。
合法值为 LineBreak.EXPLICIT、LineBreak.TO_FIT、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 LineBreak.TO_FIT。
实现
public function get lineBreak():*
public function set lineBreak(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
lineHeight | 属性 |
lineHeight:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的行距控制。上一行或下一行(取决于 LeadingModel
)的基线与当前行的基线之间的距离,等于应用于该行中任意字符的最大行距。该值可以是数字或百分比。如果指定百分比,请输入字符串值,例如 140%。
合法值为 -720 到 720 范围内的数字。
合法值为 -1000% 到 1000% 范围内的百分比数字。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 120%。
实现
public function get lineHeight():*
public function set lineHeight(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
lineThrough | 属性 |
lineThrough:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:如果为 true
,则应用删除线(贯穿文本中间绘制的线)。
合法值为 true、false 和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 false。
实现
public function get lineThrough():*
public function set lineThrough(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
linkActiveFormat | 属性 |
linkActiveFormat:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:定义用于处于正常状态的链接的格式属性。此值将向下层叠层次结构,并应用于作为后代的所有链接。接受 inherit
,一个 ITextLayoutFormat
,或将带有键和值的对象数组作为成员转换为 TextLayoutFormat。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 null。
实现
public function get linkActiveFormat():*
public function set linkActiveFormat(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
linkHoverFormat | 属性 |
linkHoverFormat:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:定义当鼠标在链接边界内(悬停)时用于悬停状态链接的格式属性。此值将向下层叠层次结构,并应用于作为后代的所有链接。接受 inherit
,一个 ITextLayoutFormat
,或将带有键和值的对象数组作为成员转换为 TextLayoutFormat。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 null。
实现
public function get linkHoverFormat():*
public function set linkHoverFormat(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
linkNormalFormat | 属性 |
linkNormalFormat:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:定义用于处于正常状态的链接的格式属性。此值将向下层叠层次结构,并应用于作为后代的所有链接。接受 inherit
,一个 ITextLayoutFormat
,或将带有键和值的对象数组作为成员转换为 TextLayoutFormat。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 null。
实现
public function get linkNormalFormat():*
public function set linkNormalFormat(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
listAutoPadding | 属性 |
listAutoPadding:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定当列表相应侧的内边距值为 auto
时,列表开始边缘的自动缩进。
合法值为 -1000 到 1000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 40。
实现
public function get listAutoPadding():*
public function set listAutoPadding(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
listMarkerFormat | 属性 |
listMarkerFormat:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:定义列表标记的格式属性。此值将向下层叠层次结构,并应用于作为后代的所有链接。接受 inherit
,一个 IListMarkerFormat
,或将带有键与值的对象数组作为成员转换为 ListMarkerFormat。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 null。
实现
public function get listMarkerFormat():*
public function set listMarkerFormat(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
listStylePosition | 属性 |
listStylePosition:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:
合法值为 ListStylePosition.INSIDE、ListStylePosition.OUTSIDE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 ListStylePosition.OUTSIDE。
实现
public function get listStylePosition():*
public function set listStylePosition(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
listStyleType | 属性 |
listStyleType:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:
合法值为 ListStyleType.UPPER_ALPHA、ListStyleType.LOWER_ALPHA、ListStyleType.UPPER_ROMAN、ListStyleType.LOWER_ROMAN、ListStyleType.NONE、ListStyleType.DISC、ListStyleType.CIRCLE、ListStyleType.SQUARE、ListStyleType.BOX、ListStyleType.CHECK、ListStyleType.DIAMOND、ListStyleType.HYPHEN、ListStyleType.ARABIC_INDIC、ListStyleType.BENGALI、ListStyleType.DECIMAL、ListStyleType.DECIMAL_LEADING_ZERO、ListStyleType.DEVANAGARI、ListStyleType.GUJARATI、ListStyleType.GURMUKHI、ListStyleType.KANNADA、ListStyleType.PERSIAN、ListStyleType.THAI、ListStyleType.URDU、ListStyleType.CJK_EARTHLY_BRANCH、ListStyleType.CJK_HEAVENLY_STEM、ListStyleType.HANGUL、ListStyleType.HANGUL_CONSTANT、ListStyleType.HIRAGANA、ListStyleType.HIRAGANA_IROHA、ListStyleType.KATAKANA、ListStyleType.KATAKANA_IROHA、ListStyleType.LOWER_ALPHA、ListStyleType.LOWER_GREEK、ListStyleType.LOWER_LATIN、ListStyleType.UPPER_ALPHA、ListStyleType.UPPER_GREEK、ListStyleType.UPPER_LATIN、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 ListStyleType.DISC。
实现
public function get listStyleType():*
public function set listStyleType(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
locale | 属性 |
locale:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的区域设置。控制大小写转换和形状。使用标准区域设置标识符,如 Unicode Technical Standard #35 中所述。例如,en、en_US 和 en-US 均表示英语,ja 表示日语。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 en。
实现
public function get locale():*
public function set locale(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
paddingBottom | 属性 |
paddingBottom:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:底部边界区(像素数)。如果默认值为 auto,表示为零,除非列表中的开始边缘内边距为 45。(如果在层叠期间未定义,则使用默认值)。容器底部边缘与文本之间的空间。该值是一个数字或 auto。
对于水平文本,在含有多个列的可滚动容器中,第一列和后续列将填充部分显示为容器底部的空白,但是对于最后一列,如果文本没有完全填充,可能必须进行滚动才能看到填充。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 -8000 到 8000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get paddingBottom():*
public function set paddingBottom(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
paddingLeft | 属性 |
paddingLeft:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:左侧边界区(像素数)。如果默认值为 auto,表示为零,除非列表中的开始边缘内边距为 45。(如果在层叠期间未定义,则使用默认值)。容器左边缘与文本之间的空间。该值是一个数字或 auto。
对于垂直文本,在含有多个列的可滚动容器中,第一列和后续列将填充部分显示为容器末尾的空白,但是对于最后一列,如果文本没有完全填充,可能必须进行滚动才能看到填充。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 -8000 到 8000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get paddingLeft():*
public function set paddingLeft(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
paddingRight | 属性 |
paddingRight:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:右侧边界区(像素数)。如果默认值为 auto,表示为零,除非列表中的开始边缘内边距为 45。(如果在层叠期间未定义,则使用默认值)。容器右边缘与文本之间的空间。该值是一个数字或 auto。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 -8000 到 8000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get paddingRight():*
public function set paddingRight(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
paddingTop | 属性 |
paddingTop:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:顶部边界区(像素数)。如果默认值为 auto,表示为零,除非列表中的开始边缘内边距为 45。(如果在层叠期间未定义,则使用默认值)。容器顶部边缘与文本之间的空间。该值是一个数字或 auto。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 -8000 到 8000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get paddingTop():*
public function set paddingTop(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
paragraphEndIndent | 属性 |
paragraphEndIndent:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:一个数字,指定段落结束边缘的缩进量(像素数)。是指从左到右文本中的右边缘和从右到左文本中的左边缘。
合法值为 0 到 8000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get paragraphEndIndent():*
public function set paragraphEndIndent(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
paragraphSpaceAfter | 属性 |
paragraphSpaceAfter:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:一个数字,指定在段落后留出的空白(像素数)。与 paragraphSpaceBefore
一起使用时会合并。
合法值为 0 到 8000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get paragraphSpaceAfter():*
public function set paragraphSpaceAfter(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
paragraphSpaceBefore | 属性 |
paragraphSpaceBefore:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:一个数字,指定在段落前留出的空白(像素数)。与 paragraphSpaceAfter
一起使用时会合并。
合法值为 0 到 8000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get paragraphSpaceBefore():*
public function set paragraphSpaceBefore(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
paragraphStartIndent | 属性 |
paragraphStartIndent:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:一个数字,指定段落开始边缘的缩进量(像素数)。是指从左至右文本的左边和从右至左文本的右边。
合法值为 0 到 8000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get paragraphStartIndent():*
public function set paragraphStartIndent(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
renderingMode | 属性 |
renderingMode:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于此文本的呈现模式。只应用于嵌入字体(fontLookup
属性设置为 FontLookup.EMBEDDED_CFF
时)。
合法值为 RenderingMode.NORMAL、RenderingMode.CFF、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 RenderingMode.CFF。
实现
public function get renderingMode():*
public function set renderingMode(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
rootElement | 属性 |
rootElement:ContainerFormattedElement
[只读] 语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
返回容器中显示的根元素。例如,根元素可能是 DivElement 或 TextFlow 实例。
实现
public function get rootElement():ContainerFormattedElement
相关 API 元素
styleName | 属性 |
styleName:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:将一个标识类指定给该元素,以允许通过引用 styleName
为该元素设置样式。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性值为 null。
实现
public function get styleName():*
public function set styleName(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
styles | 属性 |
tabStops | 属性 |
tabStops:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定与段落关联的制表位。Setter 可采用 TabStopFormat 数组、精简的字符串表示形式、undefined 或 FormatValue.INHERIT
。精简的字符串表示形式始终转换为 TabStopFormat 的一个数组。
基于字符串的格式是一个制表位列表,其中各个制表位由一个或多个空格分隔。
制表位的形式为:<对齐类型><对齐位置>|<对齐标记>。
对齐类型由一个字符表示,可以是 S、E、C 或 D(或相应小写字母)。S 或 s 表示起始,E 或 e 表示末尾,C 或 c 表示中心,D 或 d 表示小数。对齐类型是可选的,如果未指定,将默认为 S。
对齐位置是一个数字,根据数字的 FXG 规范(小数或科学表示法)指定。对齐位置是必需的。
垂直竖线用于分隔对齐位置和对齐标记,只有当存在对齐标记时才应存在。
如果对齐类型为 D,则对齐标记是可选的,如果是其它对齐类型,则对齐标记不应存在。对齐标记可以是由制表位末尾空白所终止的任何字符序列(对于最后一个制表位,末尾空白可选,默认为对齐标记的末尾)。如果空格由反斜杠进行转义 (\ ),则可以是对齐标记本身的一部分。如果反斜杠由另一个反斜杠进行转义 (\\),则可以是对齐标记本身的一部分。如果对齐类型为 D,且未指定对齐标记,则会使用默认值 null。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 null。
实现
public function get tabStops():*
public function set tabStops(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
textAlign | 属性 |
textAlign:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:段落中的行与容器的对齐方式。TextAlign.LEFT
将文本行与容器左边缘对齐。TextAlign.RIGHT
与右边缘对齐。TextAlign.CENTER
等效于将从左至右的文本设置为左对齐,或将从右至左的文本设置为右对齐。TextAlign.JUSTIFY
会展开行,使其充满整个空间。TextAlign.START
等效于将从左至右的文本设置为左对齐,或将从右至左的文本设置为右对齐。TextAlign.END
等效于将从左至右的文本设置为右对齐,或将从右至左的文本设置为左对齐。
合法值为 TextAlign.LEFT、TextAlign.RIGHT、TextAlign.CENTER、TextAlign.JUSTIFY、TextAlign.START、TextAlign.END、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextAlign.START。
实现
public function get textAlign():*
public function set textAlign(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
textAlignLast | 属性 |
textAlignLast:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:两端对齐文本中段落最后一行(或唯一的一行)与容器的对齐方式。如果 textAlign
设置为 TextAlign.JUSTIFY
,则 textAlignLast
指定最后一行(如果是只含一行的块则为唯一一行)的对齐方式。其值类似于 textAlign
。
合法值为 TextAlign.LEFT、TextAlign.RIGHT、TextAlign.CENTER、TextAlign.JUSTIFY、TextAlign.START、TextAlign.END、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextAlign.START。
实现
public function get textAlignLast():*
public function set textAlignLast(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
textAlpha | 属性 |
textAlpha:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的 Alpha(透明度)值。值为 0 表示完全透明,值为 1 表示完全不透明。textAlpha
设置为 0 的显示对象是活动对象,即使它们不可见。
合法值为 0 到 1 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 1。
实现
public function get textAlpha():*
public function set textAlpha(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
textDecoration | 属性 |
textDecoration:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本上的装饰。用于应用下划线,默认值为 none。
合法值为 TextDecoration.NONE、TextDecoration.UNDERLINE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextDecoration.NONE。
实现
public function get textDecoration():*
public function set textDecoration(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
textFlow | 属性 |
textFlow:flashx.textLayout.elements:TextFlow
[只读] 语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
返回其内容出现在容器中的 TextFlow 对象。textFlow
和 rootElement
的值可能相同,也可能是根元素的 TextFlow 对象。例如,如果容器的根元素是 DivElement,则该值为 DivElement 所属的 TextFlow 对象。
实现
public function get textFlow():flashx.textLayout.elements:TextFlow
相关 API 元素
textIndent | 属性 |
textIndent:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:一个数字,指定段落第一行的缩进量(以像素为单位)。如果为负值,则会将行向边缘中推进,可能会推到容器之外。
合法值为 -8000 到 8000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get textIndent():*
public function set textIndent(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
textJustify | 属性 |
textJustify:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定文本两端对齐的选项。默认值为 TextJustify.INTER_WORD
,表示向空格符添加额外空格。TextJustify.DISTRIBUTE
会向空格符和各字母之间添加额外空格。仅与 JustificationRule.SPACE
的 justificationRule
值一起使用。
合法值为 TextJustify.INTER_WORD、TextJustify.DISTRIBUTE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextJustify.INTER_WORD。
实现
public function get textJustify():*
public function set textJustify(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
textLength | 属性 |
textRotation | 属性 |
textRotation:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:确定要旋转此文本的度数。
合法值为 TextRotation.ROTATE_0、TextRotation.ROTATE_180、TextRotation.ROTATE_270、TextRotation.ROTATE_90、TextRotation.AUTO、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextRotation.AUTO。
实现
public function get textRotation():*
public function set textRotation(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
trackingLeft | 属性 |
trackingLeft:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:数字(以像素为单位)(或 fontSize
的百分比,如 120%)表示要应用到每个字符左边的间距的量(手动字距调整)。如果启用字距调整,则会将 trackingLeft
值与字体字距调整表中的值相加。如果禁用字距调整,则使用 trackingLeft
值作为手动字距调整值。同时支持正值和负值。
合法值为 -1000 到 1000 范围内的数字。
合法值为 -1000% 到 1000% 范围内的百分比数字。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get trackingLeft():*
public function set trackingLeft(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
trackingRight | 属性 |
trackingRight:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:数字(以像素为单位)(或 fontSize
的百分比,如 120%)表示要应用到每个字符右边的间距的量(手动字距调整)。如果启用字距调整,则会将 trackingRight
值与字体字距调整表中的值相加。如果禁用字距调整,则使用 trackingRight
值作为手动字距调整值。同时支持正值和负值。
合法值为 -1000 到 1000 范围内的数字。
合法值为 -1000% 到 1000% 范围内的百分比数字。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get trackingRight():*
public function set trackingRight(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
typographicCase | 属性 |
typographicCase:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于此文本的印刷大小写的类型。下面给出了一些示例:
合法值为 TLFTypographicCase.DEFAULT、TLFTypographicCase.CAPS_TO_SMALL_CAPS、TLFTypographicCase.UPPERCASE、TLFTypographicCase.LOWERCASE、TLFTypographicCase.LOWERCASE_TO_SMALL_CAPS、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TLFTypographicCase.DEFAULT。
实现
public function get typographicCase():*
public function set typographicCase(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
userStyles | 属性 |
verticalAlign | 属性 |
verticalAlign:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:垂直对齐或两端对齐(如果在层叠期间未定义,则使用默认值)。确定 TextFlow 元素在容器内如何对齐。
合法值为 VerticalAlign.TOP、VerticalAlign.MIDDLE、VerticalAlign.BOTTOM、VerticalAlign.JUSTIFY、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 VerticalAlign.TOP。
实现
public function get verticalAlign():*
public function set verticalAlign(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
verticalScrollPolicy | 属性 |
verticalScrollPosition | 属性 |
whiteSpaceCollapse | 属性 |
whiteSpaceCollapse:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:将文本导入到 TextFlow 中时压缩或保留空白。WhiteSpaceCollapse.PRESERVE
会保留所有空白字符。如果为 WhiteSpaceCollapse.COLLAPSE
,则会删除导入的文本块中的新行、制表符以及前导或结尾空格。换行标记 () 和 Unicode 行分隔符将会保留。
合法值为 WhiteSpaceCollapse.PRESERVE、WhiteSpaceCollapse.COLLAPSE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果在层叠期间未定义此属性,则其值为 WhiteSpaceCollapse.COLLAPSE。
实现
public function get whiteSpaceCollapse():*
public function set whiteSpaceCollapse(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
wordSpacing | 属性 |
wordSpacing:*
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定在两端对齐期间使用的单词之间的最佳间距、最小间距和最大间距(作为普通间距宽度的乘数)。最佳间距用于表示间距的期望大小,作为字体中定义值的一部分。在使用字母间距对齐行之前,通过分配 textJustify 来确定词间距的宽度时使用最小和最大值。
合法值为 -1000% 到 1000% 范围内的百分比数字。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 100%、50%、150%。
实现
public function get wordSpacing():*
public function set wordSpacing(value:any):void
引发
RangeError — 当设置的值不在此属性的范围内时
|
ContainerController | () | 构造函数 |
public function ContainerController(container:Sprite, compositionWidth:Number = 100, compositionHeight:Number = 100)
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
构造函数 - 创建一个 ContainerController 实例。ContainerController 具有默认的 compositionWidth
和 compositionHeight
,这样,未指定容器宽度和高度时,容器中会出现一些文本。
container:Sprite — 用于管理文本行的 DisplayObjectContainer。
| |
compositionWidth:Number (default = 100 ) — 在容器中合成文本的初始宽度。
| |
compositionHeight:Number (default = 100 ) — 在容器中合成文本的初始高度。
|
activateHandler | () | 方法 |
public function activateHandler(event:Event):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 Event.ACTIVATE
事件。
参数
event:Event — Event 对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.container.examples { import flash.display.Sprite; import flash.events.Event; import flashx.textLayout.container.ContainerController; public class ContainerController_activateHandlerExample extends ContainerController { public function ContainerController_activateHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100) { super(container, compositionWidth, compositionHeight); } override public function activateHandler(event:Event):void { // run the TLF handler for the activate event super.activateHandler(event); // and add your own code for the event trace("You are in activateHandler()"); } } }
addBackgroundShape | () | 方法 |
protected function addBackgroundShape(shape:Shape):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
添加要在其上绘制背景形状(如背景颜色)的 flash.display.Shape
对象。此方法的默认实现(可能会被覆盖)会将该对象添加到 container
中,正好位于第一个 flash.text.engine.TextLine
子级(如果存在)前面,否则,会将该对象添加到最后一个现有子级后面。
参数
shape:Shape — 要添加的 flash.display.Shape 对象
|
相关 API 元素
addInlineGraphicElement | () | 方法 |
protected function addInlineGraphicElement(parent:DisplayObjectContainer, inlineGraphicElement:DisplayObject, index:int):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 2.0 |
添加 flash.display.DisplayObject
对象作为父级的后代。此方法的默认实现(可能会被覆盖)在指定的索引处将对象作为父级
的直接子级添加。此被调用以将 InlineGraphicElements 添加到 TextLine 或 container。
参数
parent:DisplayObjectContainer — 要将 inlineGraphicElement 添加到的 flash.display.DisplayObjectContainer 对象
| |
inlineGraphicElement:DisplayObject — 要添加的 flash.display.DisplayObject 对象
| |
index:int — 其父级中的浮点的插入索引
|
相关 API 元素
addSelectionContainer | () | 方法 |
protected function addSelectionContainer(selectionContainer:DisplayObjectContainer):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
添加要向其添加选区形状(如块选区加亮、光标等)的 flash.display.DisplayObjectContainer
对象。此方法的默认实现(可能会被覆盖)具有以下行为:会将该对象正好添加在 container
的第一个 flash.text.engine.TextLine
子级(如果存在)之前,该对象不透明且具有正常混合模式。所有其它情况下,会将它作为 container
的最后一个子级添加。
参数
selectionContainer:DisplayObjectContainer — 要添加的 flash.display.DisplayObjectContainer 对象
|
相关 API 元素
addTextLine | () | 方法 |
protected function addTextLine(textLine:flash.text.engine:TextLine, index:int):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
添加 flash.text.engine.TextLine
对象作为 container
的后代。此方法的默认实现(可能会被覆盖)在指定的索引处将对象作为 container
的直接子级添加。
参数
textLine:flash.text.engine:TextLine — 要添加的 flash.text.engine.TextLine 对象
| |
index:int — 其父级中的文本行的插入索引
|
相关 API 元素
autoScrollIfNecessary | () | 方法 |
beginMouseCapture | () | 方法 |
public function beginMouseCapture():void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
请求客户端开始从安全沙箱外部转发 mouseup 和 mousemove 事件时调用。
clearStyle | () | 方法 |
createContextMenu | () | 方法 |
protected function createContextMenu():ContextMenu
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
为 ContainerController 创建上下文菜单。使用 ContextMenu 类的方法可向菜单中添加项。
您可以覆盖此方法,以定义一个自定义上下文菜单。
返回ContextMenu |
相关 API 元素
deactivateHandler | () | 方法 |
editHandler | () | 方法 |
public function editHandler(event:Event):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理编辑事件(CUT、COPY、PASTE、SELECT_ALL)。
参数
event:Event — 事件对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.container.examples { import flash.events.Event; import flash.display.Sprite; import flashx.textLayout.container.ContainerController; public class ContainerController_editHandlerExample extends ContainerController { public function ContainerController_editHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100) { super(container, compositionWidth, compositionHeight); } override public function editHandler(event:Event):void { // run the TLF handler for the focus event super.editHandler(event); // and add your own code for the event trace("You are in editHandler()"); } } }
endMouseCapture | () | 方法 |
public function endMouseCapture():void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
通知客户端不再需要从安全沙箱外部转发 mouseup 和 mousemove 事件时调用。
focusChangeHandler | () | 方法 |
public function focusChangeHandler(event:FocusEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 FocusEvent.KEY_FOCUS_CHANGE
和 FocusEvent.MOUSE_FOCUS_CHANGE
事件。
参数
event:FocusEvent — FocusEvent 对象。
|
相关 API 元素
focusInHandler | () | 方法 |
public function focusInHandler(event:FocusEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 FocusEvent.FOCUS_IN
事件。
参数
event:FocusEvent — FocusEvent 对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.container.examples { import flash.events.FocusEvent; import flash.display.Sprite; import flashx.textLayout.container.ContainerController; public class ContainerController_focusInHandlerExample extends ContainerController { public function ContainerController_focusInHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100) { super(container, compositionWidth, compositionHeight); } override public function focusInHandler(event:FocusEvent):void { // run the TLF handler for the focus event super.focusInHandler(event); // and add your own code for the event trace("You are in focusInHandler()"); } } }
focusOutHandler | () | 方法 |
public function focusOutHandler(event:FocusEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 FocusEvent.FOCUS_OUT
事件。
参数
event:FocusEvent — FocusEvent 对象。
|
相关 API 元素
getContentBounds | () | 方法 |
public function getContentBounds():Rectangle
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
返回文本所占用的区域,该区域由上一个合成或更新操作反映。如果容器可以滚动且文本超出了可视区域,则可以估计宽度和高度。
返回Rectangle — 描述文本所占用的区域。
|
相关 API 元素
示例 ( 如何使用本示例 )
getContentBounds()
围绕文本绘制一个边框。package flashx.textLayout.container.examples { import flash.geom.Rectangle; import flash.display.Sprite; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; public class ContainerController_getContentBoundsExample extends Sprite { private const textMarkup:String = "<flow:TextFlow xmlns:flow='http://ns.adobe.com/textLayout/2008' fontSize='08' " + "textIndent='10' paragraphSpaceBefore='6' paddingTop='8' paddingLeft='8' paddingRight='8'>" + "<flow:p paragraphSpaceBefore='inherit'>" + "<flow:span>There are many </flow:span>" + "<flow:span fontStyle='italic'>such</flow:span>" + "<flow:span> lime-kilns in that tract of country, for the purpose of burning the white" + " marble which composes a large part of the substance of the hills. Some of them, built " + "years ago, and long deserted, with weeds growing in the vacant round of the interior, " + "which is open to the sky, and grass and wild-flowers rooting themselves into the chinks" + "of the stones, look already like relics of antiquity, and may yet be overspread with the" + " lichens of centuries to come.</flow:span>" + "</flow:p>" + "</flow:TextFlow>"; public function ContainerController_getContentBoundsExample(textFlow:TextFlow):void { // Body text TextFlow and flow composer var textFlow:TextFlow = new TextFlow(); textFlow = TextConverter.importToFlow(textMarkup, TextConverter.TEXT_LAYOUT_FORMAT); var container:Sprite = new Sprite(); var controller:ContainerController = new ContainerController(container, 120, 200); container.x = 150; container.y = 50; // Add controller to text flow; add container to stage and display text textFlow.flowComposer.addController(controller); addChild(container); textFlow.flowComposer.updateAllControllers(); // draw a border around the text drawBorder(controller); } private function drawBorder(controller:ContainerController):void { // get the rectangle that makes up the bounds of the content var bounds:Rectangle = controller.getContentBounds(); // retrieve the container and draw the border var container:Sprite = controller.container as Sprite; container.graphics.lineStyle(.5); container.graphics.moveTo(bounds.left,bounds.top); container.graphics.lineTo(bounds.right,bounds.top); container.graphics.lineTo(bounds.right,bounds.bottom); container.graphics.lineTo(bounds.left,bounds.bottom); container.graphics.lineTo(bounds.left,bounds.top); container.graphics.drawRect(bounds.left, bounds.top, bounds.width, bounds.height ); } } }
getFirstTextLineChildIndex | () | 方法 |
getScrollDelta | () | 方法 |
getStyle | () | 方法 |
imeStartCompositionHandler | () | 方法 |
invalidateContents | () | 方法 |
public function invalidateContents():void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
将此容器中所有文本标记为需要进行合成。
示例 ( 如何使用本示例 )
package flashx.textLayout.container.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.conversion.TextConverter; public class ContainerController_invalidateContentsExample extends Sprite { public function ContainerController_invalidateContentsExample() { // create container, text flow, composer, paragraph, and span var container:Sprite = new Sprite(); var textFlow:TextFlow = new TextFlow(); var paragraph:ParagraphElement = new ParagraphElement(); var span:SpanElement = new SpanElement; // add container to the stage; create controller and add it to the text flow addChild(container); container.x = 100; container.y = 50; var controller:ContainerController = new ContainerController(container, 200, 200); textFlow.flowComposer.addController(controller); // set font size and add text to the span; add the span to the paragraph textFlow.fontSize = 16; span.text = "Does invalidateContents() cause this text to be damaged?"; paragraph.addChild(span); textFlow.addChild(paragraph); //update controller to display text textFlow.flowComposer.updateAllControllers(); // invalidate the controller contents and check to see if they are damaged controller.invalidateContents(); if(controller.isDamaged()) span.text += "\nYes, it does."; else span.text += "\nNo, it doesn't"; textFlow.flowComposer.updateAllControllers(); } } }
isDamaged | () | 方法 |
public function isDamaged():Boolean
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
确定容器是否具有需要合成的文本。
返回Boolean — 如果容器需要合成,则为 true。
|
示例 ( 如何使用本示例 )
package flashx.textLayout.container.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.conversion.TextConverter; public class ContainerController_isDamagedExample extends Sprite { public function ContainerController_isDamagedExample() { // create container, composer, text flow, paragraph, and span var container:Sprite = new Sprite(); var textFlow:TextFlow = new TextFlow(); var paragraph:ParagraphElement = new ParagraphElement(); var span:SpanElement = new SpanElement; // add container to the stage; create controller and add it to the text flow addChild(container); var controller:ContainerController = new ContainerController(container, 200, 700 ); textFlow.flowComposer.addController(controller); //set font size, add text to the span and the paragraph to the text flow textFlow.fontSize = 24; span.text = "Does this text flow need to be composed?"; paragraph.addChild(span); textFlow.addChild(paragraph); // display the text textFlow.flowComposer.updateAllControllers(); // replace 'this' with 'your' and check to see if text flow is damaged span.replaceText(5, 9, "your"); if(controller.isDamaged()) { span.text += " Yes it does."; } textFlow.flowComposer.updateAllControllers(); } } }
keyDownHandler | () | 方法 |
public function keyDownHandler(event:KeyboardEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 KeyboardEvent.KEY_DOWN
事件。
参数
event:KeyboardEvent — KeyboardEvent 对象。
|
相关 API 元素
keyFocusChangeHandler | () | 方法 |
public function keyFocusChangeHandler(event:FocusEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 FocusEvent.KEY_FOCUS_CHANGE
事件。
参数
event:FocusEvent — FocusEvent 对象。
|
相关 API 元素
keyUpHandler | () | 方法 |
public function keyUpHandler(event:KeyboardEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 Keyboard.KEY_UP
事件。
参数
event:KeyboardEvent — KeyboardEvent 对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.container.examples { import flash.events.KeyboardEvent; import flash.display.Sprite; import flashx.textLayout.container.ContainerController; public class ContainerController_keyUpHandlerExample extends ContainerController { public function ContainerController_keyUpHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100) { super(container, compositionWidth, compositionHeight); } override public function keyUpHandler(event:KeyboardEvent):void { // run the TLF handler for the KEY_UP event super.keyUpHandler(event); // and add your own code for the event trace("You are in keyUpHandler()"); } } }
menuSelectHandler | () | 方法 |
public function menuSelectHandler(event:ContextMenuEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 ContextMenuEvent.MENU_SELECT
事件。
参数
event:ContextMenuEvent — ContextMenuEvent 对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.container.examples { import flash.events.ContextMenuEvent; import flash.display.Sprite; import flashx.textLayout.container.ContainerController; public class ContainerController_menuSelectHandlerExample extends ContainerController { public function ContainerController_menuSelectHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100) { super(container, compositionWidth, compositionHeight); } override public function menuSelectHandler(event:ContextMenuEvent):void { // run the TLF handler for the MENU_SELECT event super.menuSelectHandler(event); // and add your own code for the event trace("You are in menuSelectHandler()"); } } }
mouseDoubleClickHandler | () | 方法 |
public function mouseDoubleClickHandler(event:MouseEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 MouseEvent.DOUBLE_CLICK
事件。
参数
event:MouseEvent — MouseEvent 对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.container.examples { import flash.events.MouseEvent; import flash.display.Sprite; import flashx.textLayout.container.ContainerController; public class ContainerController_mouseDoubleClickHandlerExample extends ContainerController { public function ContainerController_mouseDoubleClickHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100) { super(container, compositionWidth, compositionHeight); } override public function mouseDoubleClickHandler(event:MouseEvent):void { // run the TLF handler for the MOUSE_OVER event super.mouseDoubleClickHandler(event); // and add your own code for the event trace("You are in mouseDoubleClickHandler()"); } } }
mouseDownHandler | () | 方法 |
public function mouseDownHandler(event:MouseEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 MouseEvent.MOUSE_DOWN
事件。
参数
event:MouseEvent — MouseEvent 对象。
|
相关 API 元素
mouseMoveHandler | () | 方法 |
public function mouseMoveHandler(event:MouseEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 MouseEvent.MOUSE_MOVE
事件。
参数
event:MouseEvent — MouseEvent 对象。
|
相关 API 元素
mouseMoveSomewhere | () | 方法 |
mouseOutHandler | () | 方法 |
public function mouseOutHandler(event:MouseEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 MouseEvent.MOUSE_OUT
事件。
参数
event:MouseEvent — MouseEvent 对象。
|
相关 API 元素
mouseOverHandler | () | 方法 |
public function mouseOverHandler(event:MouseEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 MouseEvent.MOUSE_OVER
事件。
参数
event:MouseEvent — MouseEvent 对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.container.examples { import flash.events.MouseEvent; import flash.display.Sprite; import flashx.textLayout.container.ContainerController; public class ContainerController_mouseOverHandlerExample extends ContainerController { public function ContainerController_mouseOverHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100) { super(container, compositionWidth, compositionHeight); } override public function mouseOverHandler(event:MouseEvent):void { // run the TLF handler for the MOUSE_OVER event super.mouseOverHandler(event); // and add your own code for the event trace("You are in mouseOverHandler()"); } } }
mouseUpHandler | () | 方法 |
public function mouseUpHandler(event:MouseEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 MouseEvent.MOUSE_UP
事件。
参数
event:MouseEvent — MouseEvent 对象。
|
相关 API 元素
mouseUpSomewhere | () | 方法 |
mouseWheelHandler | () | 方法 |
public function mouseWheelHandler(event:MouseEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 MouseEvent.MOUSE_WHEEL
事件。
参数
event:MouseEvent — MouseEvent 对象。
|
相关 API 元素
removeBackgroundShape | () | 方法 |
removeInlineGraphicElement | () | 方法 |
protected function removeInlineGraphicElement(parent:DisplayObjectContainer, inlineGraphicElement:DisplayObject):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 2.0 |
从 flash.display.DisplayObject
对象的父级中删除该对象。此方法的默认实现(可能会被覆盖)会从 container
删除该对象(如果该对象是 container 的直接子级)。即使该对象不是父级的后代,也可能会调用此方法。此方法的实现必须确保这种情况下未采取任何操作。
参数
parent:DisplayObjectContainer — 要删除的 flash.display.DisplayObject 对象
| |
inlineGraphicElement:DisplayObject |
相关 API 元素
removeSelectionContainer | () | 方法 |
protected function removeSelectionContainer(selectionContainer:DisplayObjectContainer):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
删除包含选区形状(如块选区加亮、光标等)的 flash.display.DisplayObjectContainer
对象。此方法的默认实现(可能会被覆盖)会将对象从其父级删除(如果存在)。
参数
selectionContainer:DisplayObjectContainer — 要删除的 flash.display.DisplayObjectContainer 对象
|
相关 API 元素
removeTextLine | () | 方法 |
protected function removeTextLine(textLine:flash.text.engine:TextLine):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
从 flash.text.engine.TextLine
对象的父代中删除该对象。此方法的默认实现(可能会被覆盖)会从 container
删除该对象(如果该对象是 container 的直接子级)。即使该对象不是 container
的后代时,也可能会调用此方法。此方法的实现必须确保这种情况下未采取任何操作。
参数
textLine:flash.text.engine:TextLine — 要删除的 flash.text.engine.TextLine 对象
|
相关 API 元素
scrollToRange | () | 方法 |
selectRange | () | 方法 |
setCompositionSize | () | 方法 |
public function setCompositionSize(w:Number, h:Number):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
设置容器中允许的文本宽度和高度。可以以像素为单位来指定宽度和高度,或对于二者都可以使用 NaN
。NaN
指示测量值。可以用它来查找宽度最大的行和/或所有内容的总高度。当 NaN 指定为宽度时,行将以 TextLine.MAX_LINE_WIDTH
的最大宽度断开。当 NaN
指定为高度时,会假定容器具有无限制的高度。实际的测量值可以使用 getContentBounds
获得。当 TextFlow
的 blockProgression
属性计算结果为 BlockProgression.RL
时,将交换高度和宽度的意义。
参数
w:Number — 适用于容器中文本的宽度(像素数)。NaN 指示未指定宽度。
| |
h:Number — 适用于容器中文本的高度(像素数)。NaN 指示未指定高度。
|
相关 API 元素
flashx.textLayout.formats.BlockProgression
getContentBounds()
示例 ( 如何使用本示例 )
setCompositionSize()
设置合成宽度和高度。
package flashx.textLayout.container.examples { import flash.display.Sprite; import flashx.textLayout.container.ContainerController; import flashx.textLayout.elements.ParagraphElement; import flashx.textLayout.elements.SpanElement; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.conversion.TextConverter; public class ContainerController_setCompositionSizeExample extends Sprite { public function ContainerController_setCompositionSizeExample() { // create container, text flow, composer, paragraph, and span var container:Sprite = new Sprite(); var textFlow:TextFlow = new TextFlow(); var paragraph:ParagraphElement = new ParagraphElement(); var span:SpanElement = new SpanElement; // add container to the stage; create controller and add it to the text flow addChild(container); container.x = 100; container.y = 50; var controller:ContainerController = new ContainerController(container); textFlow.flowComposer.addController(controller); // set font size and add text to the span; add the span to the paragraph textFlow.fontSize = 12; controller.setCompositionSize(250, 200); span.text = "This example uses setCompositionSize() to set compositionWidth ("; span.text += controller.compositionWidth; span.text += ") and compositionHeight (" span.text += controller.compositionHeight; span.text += "), rather than setting them with:\nnew ContainerController()"; paragraph.addChild(span); // add paragraph to text flow, and display text textFlow.addChild(paragraph); textFlow.flowComposer.updateAllControllers(); } } }
setStyle | () | 方法 |
softKeyboardActivatingHandler | () | 方法 |
textInputHandler | () | 方法 |
public function textInputHandler(event:flash.events:TextEvent):void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
当客户端管理事件时处理 TextEvent.TEXT_INPUT
事件。
参数
event:flash.events:TextEvent — TextEvent 对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.container.examples { import flash.events.TextEvent; import flash.display.Sprite; import flashx.textLayout.container.ContainerController; public class ContainerController_textInputHandlerExample extends ContainerController { public function ContainerController_textInputHandlerExample(container:Sprite, compositionWidth:Number=100, compositionHeight:Number=100) { super(container, compositionWidth, compositionHeight); } override public function textInputHandler(event:TextEvent):void { // run the TLF handler for the textInput event super.textInputHandler(event); // and add your own code for the event - e.g. only allow alpha characters trace("You are in textInputHandler()"); } } }
updateGraphics | () | 方法 |
updateVisibleRectangle | () | 方法 |
protected function updateVisibleRectangle():void
语言版本: | ActionScript 3.0 |
运行时版本: | Flash Player 10, AIR 1.5 |
如果滚动,将滚动矩形设置为容器矩形,这样会将显示一半的任何行剪裁到可滚动区域。如果不滚动,则清除滚动矩形,不进行裁剪。
package flashx.textLayout.container.examples { import flash.display.Sprite; import flashx.textLayout.compose.StandardFlowComposer; import flashx.textLayout.container.ContainerController; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.elements.TextFlow; public class ContainerControllerExample1 extends Sprite { private const textMarkup:String = "<flow:TextFlow xmlns:flow='http://ns.adobe.com/textLayout/2008' fontSize='8' " + "textIndent='10' paragraphSpaceBefore='6' paddingTop='8' paddingLeft='8' paddingRight='8'>" + "<flow:p paragraphSpaceBefore='inherit'>" + "<flow:span>There are many </flow:span>" + "<flow:span fontStyle='italic'>such</flow:span>" + "<flow:span> lime-kilns in that tract of country, for the purpose of burning the white" + " marble which composes a large part of the substance of the hills. Some of them, built " + "years ago, and long deserted, with weeds growing in the vacant round of the interior, " + "which is open to the sky, and grass and wild-flowers rooting themselves into the chinks" + "of the stones, look already like relics of antiquity, and may yet be overspread with the" + " lichens of centuries to come. Others, where the lime-burner still feeds his daily and " + "nightlong fire, afford points of interest to the wanderer among the hills, who seats " + "himself on a log of wood or a fragment of marble, to hold a chat with the solitary man. " + "It is a lonesome, and, when the character is inclined to thought, may be an intensely " + "thoughtful occupation; as it proved in the case of Ethan Brand, who had mused to such " + "strange purpose, in days gone by, while the fire in this very kiln was burning.</flow:span>" + "</flow:p>" + "<flow:p paragraphSpaceBefore='inherit'>" + "<flow:span>" + "The man who now watched the fire was of a different order, and troubled himself with no " + "thoughts save the very few that were requisite to his business. At frequent intervals, " + "he flung back the clashing weight of the iron door, and, turning his face from the " + "insufferable glare, thrust in huge logs of oak, or stirred the immense brands with a " + "long pole. Within the furnace were seen the curling and riotous flames, and the burning " + "marble, almost molten with the intensity of heat; while without, the reflection of the " + "fire quivered on the dark intricacy of the surrounding forest, and showed in the " + "foreground a bright and ruddy little picture of the hut, the spring beside its door, the " + "athletic and coal-begrimed figure of the lime-burner, and the halffrightened child, " + "shrinking into the protection of his father's shadow. And when again the iron door was " + "closed, then reappeared the tender light of the half-full moon, which vainly strove to" + "trace out the indistinct shapes of the neighboring mountains; and, in the upper sky, " + "there was a flitting congregation of clouds, still faintly tinged with the rosy sunset, " + "though thus far down into the valley the sunshine had vanished long and long ago.</flow:span>" + "</flow:p>" + "</flow:TextFlow>"; public function ContainerControllerExample1() { // create the TextFlow, containers, and container controllers var textFlow:TextFlow; var container:Sprite = new Sprite(); var container2:Sprite = new Sprite(); var controllerOne:ContainerController = new ContainerController(container, 200, 210); var controllerTwo:ContainerController = new ContainerController(container2, 200, 220); // import the text flow from markup using TextConverter and assign a StandardFlowComposer textFlow = TextConverter.importToFlow(textMarkup, TextConverter.TEXT_LAYOUT_FORMAT); textFlow.flowComposer = new StandardFlowComposer(); // draw the container circles, add them to the stage and position them container.graphics.beginFill(0xFFCC00); container.graphics.drawCircle(100, 100, 140); container.graphics.endFill(); container2.graphics.beginFill(0xFF0000); container2.graphics.drawCircle(100, 100, 140); container2.graphics.endFill(); addChild(container); addChild(container2); container.x = 25; container.y = 100; container2.x = 280; container2.y = 100; // add the controllers to the text flow and update them to display the text textFlow.flowComposer.addController(controllerOne); textFlow.flowComposer.addController(controllerTwo); textFlow.flowComposer.updateAllControllers(); } } }
package flashx.textLayout.container.examples { import flash.display.Sprite; import flash.display.StageAlign; import flash.events.Event; import flash.geom.Rectangle; import flashx.textLayout.container.ContainerController; import flashx.textLayout.container.ScrollPolicy; import flashx.textLayout.conversion.TextConverter; import flashx.textLayout.edit.SelectionManager; import flashx.textLayout.elements.TextFlow; import flashx.textLayout.formats.TextLayoutFormat; public class ContainerControllerExample2 extends Sprite { // these variables are accessible to both methods in the class private var headingFlow:TextFlow; private var bodyFlow:TextFlow; private var headController:ContainerController; private var bodyController:ContainerController; private const headingMarkup:String = "<flow:TextFlow xmlns:flow='http://ns.adobe.com/textLayout/2008'>" + "<flow:p textAlign='center'>" + "<flow:span fontFamily='Georgia' fontSize='36'>Ethan Brand</flow:span><flow:br/>" + "<flow:span fontSize='8' fontStyle='italic'>by </flow:span>" + "<flow:span fontSize='12' fontStyle='italic'>Nathaniel Hawthorne</flow:span>" + "</flow:p>" + "</flow:TextFlow>"; private const bodyMarkup:String = "<flow:TextFlow xmlns:flow='http://ns.adobe.com/textLayout/2008' fontSize='8' " + "textIndent='10' paragraphSpaceBefore='6' paddingTop='8' paddingBottom='8' paddingLeft='8' paddingRight='8'>" + "<flow:p paragraphSpaceBefore='inherit' >" + "<flow:span>There are many </flow:span>" + "<flow:span fontStyle='italic'>such</flow:span>" + "<flow:span> lime-kilns in that tract of country, for the purpose of burning the white" + " marble which composes a large part of the substance of the hills. Some of them, built " + "years ago, and long deserted, with weeds growing in the vacant round of the interior, " + "which is open to the sky, and grass and wild-flowers rooting themselves into the chinks " + "of the stones, look already like relics of antiquity, and may yet be overspread with the" + " lichens of centuries to come. Others, where the lime-burner still feeds his daily and " + "nightlong fire, afford points of interest to the wanderer among the hills, who seats " + "himself on a log of wood or a fragment of marble, to hold a chat with the solitary man. " + "It is a lonesome, and, when the character is inclined to thought, may be an intensely " + "thoughtful occupation; as it proved in the case of Ethan Brand, who had mused to such " + "strange purpose, in days gone by, while the fire in this very kiln was burning.</flow:span>" + "</flow:p>" + "<flow:p paragraphSpaceBefore='inherit'>" + "<flow:span>" + "The man who now watched the fire was of a different order, and troubled himself with no " + "thoughts save the very few that were requisite to his business. At frequent intervals, " + "he flung back the clashing weight of the iron door, and, turning his face from the " + "insufferable glare, thrust in huge logs of oak, or stirred the immense brands with a " + "long pole. Within the furnace were seen the curling and riotous flames, and the burning " + "marble, almost molten with the intensity of heat; while without, the reflection of the " + "fire quivered on the dark intricacy of the surrounding forest, and showed in the " + "foreground a bright and ruddy little picture of the hut, the spring beside its door, the " + "athletic and coal-begrimed figure of the lime-burner, and the halffrightened child, " + "shrinking into the protection of his father's shadow. And when again the iron door was " + "closed, then reappeared the tender light of the half-full moon, which vainly strove to " + "trace out the indistinct shapes of the neighboring mountains; and, in the upper sky, " + "there was a flitting congregation of clouds, still faintly tinged with the rosy sunset, " + "though thus far down into the valley the sunshine had vanished long and long ago.</flow:span>" + "</flow:p>" + "</flow:TextFlow>"; public function ContainerControllerExample2() { // align the stage and add a listener (resizeHandler) for RESIZE events stage.align = StageAlign.TOP_LEFT; stage.addEventListener(flash.events.Event.RESIZE, resizeHandler); // create heading text flow, import heading text, and assign composer headingFlow = new TextFlow(); headingFlow = TextConverter.importToFlow(headingMarkup, TextConverter.TEXT_LAYOUT_FORMAT); // create body text flow, import body text, and assign flow composer bodyFlow = new TextFlow(); bodyFlow = TextConverter.importToFlow(bodyMarkup, TextConverter.TEXT_LAYOUT_FORMAT); // create heading container, add controller, position container and add to stage var headContainer:Sprite = new Sprite(); headController = new ContainerController(headContainer, 300, 50); headingFlow.flowComposer.addController(headController); headContainer.x = 120; headContainer.y = 20; addChild(headContainer); // update controller to display heading text headingFlow.flowComposer.updateAllControllers(); // create container for body text and position it var bodyContainer:Sprite = new Sprite(); bodyController = new ContainerController(bodyContainer, 300, 200); bodyContainer.x = 125; bodyContainer.y = 85; // create container format to specify columns var bodyContainerFormat:TextLayoutFormat = new TextLayoutFormat(); bodyContainerFormat.columnWidth = 120; bodyContainerFormat.columnGap = 15; bodyController.format = bodyContainerFormat; // enable scrolling bodyController.verticalScrollPolicy = ScrollPolicy.AUTO; bodyFlow.interactionManager = new SelectionManager(); // add controller, add container to stage, and display body text bodyFlow.flowComposer.addController(bodyController); addChild(bodyContainer); bodyFlow.flowComposer.updateAllControllers(); } private function resizeHandler(event:Event):void { const verticalGap:Number = 25; const stagePadding:Number = 16; var stageWidth:Number = stage.stageWidth - stagePadding; var stageHeight:Number = stage.stageHeight - stagePadding; var headlineWidth:Number = stageWidth; var headlineContainerHeight:Number = stageHeight; // Initial compose to get height of headline after resize headController.setCompositionSize(headlineWidth, headlineContainerHeight); headingFlow.flowComposer.compose(); var rect:Rectangle = headController.getContentBounds(); headlineContainerHeight = rect.height; // Resize and place headline text container // Call setCompositionSize() again with updated headline height headController.setCompositionSize(headlineWidth, headlineContainerHeight ); headController.container.x = stagePadding / 2; headController.container.y = stagePadding / 2; headingFlow.flowComposer.updateAllControllers(); // Resize and place body text container var bodyContainerHeight:Number = (stageHeight - verticalGap - headlineContainerHeight); bodyController.setCompositionSize(stageWidth, bodyContainerHeight ); bodyController.container.x = (stagePadding/2); bodyController.container.y = (stagePadding/2) + headlineContainerHeight + verticalGap; bodyFlow.flowComposer.updateAllControllers(); } } }
Tue Jun 12 2018, 11:04 AM Z