用于 Adobe® Flash® Platform 的 ActionScript® 3.0 参考
主页  |  隐藏包列表和类列表 |   |   |  新增内容  |  索引  |  附录  |  为什么显示为英语?
过滤条件: 正在从服务器检索数据...
正在从服务器检索数据...
flashx.textLayout.container 

ContainerController  - AS3

flashx.textLayout.container
public class ContainerController
继承ContainerController Inheritance Object
实现 IInteractionEventHandler, ITextLayoutFormat, ISandboxSupport

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

ContainerController 类定义了 TextFlow 对象与容器之间的关系。TextFlow 可以具有一个或多个可容纳文本的矩形区域;文本可在容器之间流动。每个容器都是一个 Sprite,后者是 TextLine 的父 DisplayObject。每个容器都有一个用于管理该容器的 ContainerController;控制器可容纳文本区域的目标宽度和高度,用 TextLine 填充容器并处理滚动。控制器还具有与其关联的格式,从而允许对容器中的文本应用某些格式属性。例如,这将允许 TextFlow 中的某个容器只有一列显示文本,而同一 TextFlow 中的第二个容器则具有两列文本。并非可应用于容器的所有格式属性都会影响文本;只有影响容器级别布局的格式属性才会影响文本。下面的关系图说明了 TextFlow、其 flowComposer 和显示列表之间的关系。

IContainerController

查看示例

相关 API 元素



公共属性
 属性由以下参数定义
  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
 Inheritedconstructor : 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
  
getStyle(styleProp:String):*
返回 styleProp 参数指定的样式值。
ContainerController
 Inherited
表示对象是否已经定义了指定的属性。
Object
  
当客户端管理事件时处理 IMEEvent.IME_START_COMPOSITION 事件。
ContainerController
  
将此容器中所有文本标记为需要进行合成。
ContainerController
  
确定容器是否具有需要合成的文本。
ContainerController
 Inherited
表示 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
 Inherited
表示指定的属性是否存在、是否可枚举。
Object
  
scrollToRange(activePosition:int, anchorPosition:int):void
允许滚动,使文本范围在容器中可见。
ContainerController
  
selectRange(anchorIndex:int, activeIndex:int):void
在实现 ITextSupport 的组件中设置选定文本的范围。
ContainerController
  
设置容器中允许的文本宽度和高度。
ContainerController
 Inherited
设置循环操作动态属性的可用性。
Object
  
setStyle(styleProp:String, newValue:*):void
将 styleProp 参数指定的样式值设置为 newValue 参数指定的值。
ContainerController
  
当客户端管理事件时处理 SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING 事件。
ContainerController
  
当客户端管理事件时处理 TextEvent.TEXT_INPUT 事件。
ContainerController
 Inherited
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
受保护的方法
 方法由以下参数定义
  
添加要在其上绘制背景形状(如背景颜色)的 flash.display.Shape 对象。
ContainerController
  
将 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

属性 
absoluteStart:int  [只读]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

返回容器中第一个字符。如果该容器不是文本流中的第一个容器,则合成文本时(即调用 IFlowComposer 的 compose()updateAllControllers() 方法时)该值会进行更新。



实现
    public function get absoluteStart():int

相关 API 元素

alignmentBaseline

属性 
alignmentBaseline:*

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

TextLayoutFormat:指定主要基线对齐到的基线。例如,如果将 dominantBaseline 设置为 ASCENT,则将 alignmentBaseline 设置为 DESCENT 会将文本的顶部与下缘基线对齐,或在该线下面。基线通常由行中最大的元素决定。

baselines

合法值为 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

属性 
compositionHeight:Number  [只读]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

返回容器内允许的文本垂直范围。该值以像素为单位指定。



实现
    public function get compositionHeight():Number

相关 API 元素

compositionWidth

属性 
compositionWidth:Number  [只读]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

返回容器内允许的文本水平范围。该值以像素为单位指定。



实现
    public function get compositionWidth():Number

相关 API 元素

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

属性 
container:Sprite  [只读]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

返回包含此 ContainerController 实例文本行的容器显示对象。



实现
    public function get container():Sprite

相关 API 元素

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

属性 
coreStyles:Object  [只读]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

返回此 ContainerController 的 coreStyles。请注意 getter 创建核心样式库的一个副本。返回的对象包含由 TextLayoutFormat 定义的并位于 TextLayoutFormat.description 中的格式。返回的对象包含由样式名-值对组成的数组。



实现
    public function get coreStyles():Object

相关 API 元素

digitCase

属性 
digitCase:*

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

TextLayoutFormat:用于此文本的数字大小写类型。将该值设置为 DigitCase.OLD_STYLE 时接近支持不同上行字母和下行字母的小写字母形式。各位数字之间等比间隔。此样式只适用于所选的字体,最常用于 supplemental 或 expert 字体。DigitCase.LINING 设置具有 all-cap(全大写)高度,通常为等宽以便在图表中对齐。

digitCase

合法值为 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

合法值为 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

合法值为 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。这些基线选项由选择的字体和字体大小决定。

baselines

合法值为 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 与容器顶部边界对齐。

firstBaselineOffset1firstBaselineOffset2firstBaselineOffset3firstBaselineOffset4

合法字符串值为 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

属性 
horizontalScrollPolicy:String

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

指定水平滚动方式,这可以通过指定 ScrollPolicy 类的一个常量来设置:ON、OFF 或 AUTO。



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

相关 API 元素

horizontalScrollPosition

属性 
horizontalScrollPosition:Number

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

指定舞台上当前的水平滚动位置。该值指定了自左端的像素数。



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

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

合法值为 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_ASIANjustificationRule 设置一起使用。对于所有区域设置,FormatValue.AUTO 的默认值被解析为 JustificationStyle.PUSH_IN_KINSOKU。JustificationStyle 类定义的常量指定用于处理避头尾 (kinsoku) 字符的选项;避头尾字符是指不能出现在一行首尾的日语字符。如果希望文本布局更宽松,请指定 JustificationStyle.PUSH-OUT-ONLY。如果希望文本布局类似于使用 JustificationRule.SPACEjustificationRule 得到的结果,可使用 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

行距基准:

leadingBasis1 leadingBasis2 leadingBasis3

行距方向:

leadingDirection1 leadingDirection2 leadingDirection3

合法值为 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 类的值(MINIMUMCOMMONUNCOMMONEXOTIC)支持的连字是添加的。每个值支持一个新连字集,而且包含先前类型的那些连字。

注意:使用阿拉伯语或叙利亚语字体时,必须将 ligatureLevel 设置为 MINIMUM 或更高。

ligatureLevel

合法值为 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%。

lineHeight1lineHeight2

合法值为 -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

属性 
styles:Object  [只读]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

返回此 ContainerController 的样式。请注意,getter 创建样式库的一个副本。返回的对象包含在格式属性中设置的所有样式(包括核心和用户样式)。返回的对象包含由样式名-值对组成的数组。



实现
    public function get styles():Object

相关 API 元素

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 对象。textFlowrootElement 的值可能相同,也可能是根元素的 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.SPACEjustificationRule 值一起使用。

合法值为 TextJustify.INTER_WORD、TextJustify.DISTRIBUTE、FormatValue.INHERIT。

默认值未定义,指示未设置。

如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextJustify.INTER_WORD。



实现
    public function get textJustify():*
    public function set textJustify(value:any):void

引发
RangeError — 当设置的值不在此属性的范围内时

相关 API 元素

textLength

属性 
textLength:int  [只读]

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

返回容器中的字符总数。如果容器是可滚动的,则可以包含当前未显示出来的文本。该值将在合成文本(调用 IFlowComposer 的 compose()updateAllControllers() 方法)时进行更新。



实现
    public function get textLength():int

相关 API 元素

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:用于此文本的印刷大小写的类型。下面给出了一些示例:

typographicCase

合法值为 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

属性 
userStyles:Object

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

允许您针对 ContainerController 对象读写用户样式。请注意,读取此属性将创建在该元素格式中设置的用户样式副本。



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

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

属性 
verticalScrollPolicy:String

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

指定垂直滚动方式,这可以通过指定 ScrollPolicy 类的一个常量来设置:ON、OFF 或 AUTO。



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

相关 API 元素

verticalScrollPosition

属性 
verticalScrollPosition:Number

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

指定舞台上当前的垂直滚动位置。该值指定了距离顶部的像素数。



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

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 具有默认的 compositionWidthcompositionHeight,这样,未指定容器宽度和高度时,容器中会出现一些文本。

参数
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 元素


示例  ( 如何使用本示例 )

此示例扩展 ContainerController 以使用一个自定义 activateHandler() 方法覆盖其 activateHandler() 方法。该示例需要触发 activateHandler() 方法的应用程序。
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

()方法 
public function autoScrollIfNecessary(mouseX:int, mouseY:int):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

在“拖动”选择期间处理滚动事件。

参数

mouseX:int — 鼠标光标在舞台上的水平位置。
 
mouseY:int — 鼠标光标在舞台上的垂直位置。

beginMouseCapture

()方法 
public function beginMouseCapture():void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

请求客户端开始从安全沙箱外部转发 mouseup 和 mousemove 事件时调用。

clearStyle

()方法 
public function clearStyle(styleProp:String):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

从该 FlowElement 中清除由 styleProp 指定的样式。将值设置为 undefined

参数

styleProp:String

createContextMenu

()方法 
protected function createContextMenu():ContextMenu

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

为 ContainerController 创建上下文菜单。使用 ContextMenu 类的方法可向菜单中添加项。

您可以覆盖此方法,以定义一个自定义上下文菜单。

返回
ContextMenu

相关 API 元素

deactivateHandler

()方法 
public function deactivateHandler(event:Event):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

当客户端管理事件时处理 Event.DEACTIVATE 事件。

参数

event:Event — Event 对象。

相关 API 元素

editHandler

()方法 
public function editHandler(event:Event):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

当客户端管理事件时处理编辑事件(CUT、COPY、PASTE、SELECT_ALL)。

参数

event:Event — 事件对象。

相关 API 元素


示例  ( 如何使用本示例 )

此示例扩展 ContainerController 以使用一个自定义 editHandler() 方法覆盖其 editHandler() 方法。该示例需要触发 editHandler() 方法的应用程序。
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_CHANGEFocusEvent.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 元素


示例  ( 如何使用本示例 )

此示例扩展 ContainerController 以使用一个自定义 focusInHandler() 方法覆盖其 focusInHandler() 方法。该示例需要触发 focusInHandler() 方法的应用程序。
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

()方法 
protected function getFirstTextLineChildIndex():int

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

获取第一个文本行必须出现在其父级内的索引。此方法的默认实现(可能会被覆盖)返回 container 的第一个 flash.text.engine.TextLine 子级(如果存在)的子索引,否则,返回 container 的最后一个子级的子索引。

返回
int — 第一个文本行必须出现在其父代中的索引。

相关 API 元素

getScrollDelta

()方法 
public function getScrollDelta(numLines:int):Number

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

计算要向上或向下滚动指定行数所需的滚动距离。如果行数为负值则会向上滚动,从而显示 TextFlow 顶部的更多行。如果行数为正值则会向下滚动,从而显示底部的下一行。

例如,向上滚动时,该方法使下一行完全可见。如果下一行被部分遮挡,而行数指定为 1,则该行将会完全可见。

参数

numLines:int — 要滚动的行数。

返回
Number — 要滚动的空间增量

getStyle

()方法 
public function getStyle(styleProp:String):*

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

返回 styleProp 参数指定的样式值。

参数

styleProp:String — 所需样式属性的名称。

返回
* — 指定的样式的当前值。

imeStartCompositionHandler

()方法 
public function imeStartCompositionHandler(event:IMEEvent):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

当客户端管理事件时处理 IMEEvent.IME_START_COMPOSITION 事件。

参数

event:IMEEvent — IMEEvent 对象。

相关 API 元素

flash.events.IMEEvent.IME_START_COMPOSITION

invalidateContents

()方法 
public function invalidateContents():void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

将此容器中所有文本标记为需要进行合成。


示例  ( 如何使用本示例 )

此示例检查 invalidateContents() 是否会导致文本流受损。
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 元素


示例  ( 如何使用本示例 )

此示例扩展 ContainerController 以使用一个自定义 keyUpHandler() 方法覆盖其 keyUpHandler() 方法。该示例需要触发 keyUpHandler() 方法的应用程序。
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 元素


示例  ( 如何使用本示例 )

此示例扩展 ContainerController 以使用一个自定义 menuSelectHandler() 方法覆盖其 menuSelectHandler() 方法。该示例需要触发 menuSelectHandler() 方法的应用程序。
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 元素


示例  ( 如何使用本示例 )

此示例扩展 ContainerController 以使用一个自定义 mouseDoubleClickHandler() 方法覆盖其 mouseDoubleClickHandler() 方法。该示例需要触发 mouseDoubleClickHandler() 方法的应用程序。
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

()方法 
public function mouseMoveSomewhere(event:Event):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

用于从安全沙箱外部转发 mouseMove 事件的客户端调用。不需要鼠标移动的坐标。

参数

event:Event

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 元素


示例  ( 如何使用本示例 )

此示例扩展 ContainerController 以使用一个自定义 mouseOverHandler() 方法覆盖其 mouseOverHandler() 方法。该示例需要触发 mouseOverHandler() 方法的应用程序。
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

()方法 
public function mouseUpSomewhere(event:Event):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

客户端调用以从安全沙箱外转发一个 mouseUp 事件。不需要鼠标向上的坐标。

参数

event:Event

mouseWheelHandler

()方法 
public function mouseWheelHandler(event:MouseEvent):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

当客户端管理事件时处理 MouseEvent.MOUSE_WHEEL 事件。

参数

event:MouseEvent — MouseEvent 对象。

相关 API 元素

removeBackgroundShape

()方法 
protected function removeBackgroundShape(shape:Shape):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

删除要在其上绘制背景形状(如背景颜色)的 flash.display.Shape 对象。此方法的默认实现(可能会被覆盖)会将对象从其父级删除。

参数

shape:Shape — 要删除的 flash.display.Shape 对象

相关 API 元素

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

()方法 
public function scrollToRange(activePosition:int, anchorPosition:int):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

允许滚动,使文本范围在容器中可见。

参数

activePosition:int — 当您扩展选择时随之改变的所选内容的末尾。可以是所选内容的开始或末尾,表示为距文本流起始位置的偏移。
 
anchorPosition:int — 当扩展选择时所选内容的固定末尾。可以是所选内容的起始或末尾。

selectRange

()方法 
public function selectRange(anchorIndex:int, activeIndex:int):void

语言版本: ActionScript 3.0
运行时版本: AIR 1.0, Flash Player 10.0

在实现 ITextSupport 的组件中设置选定文本的范围。如果任一参数超出边界,则不应该更改此选择。要支持内联 IME 的组件必须调用此方法。

参数

anchorIndex:int — 从零开始的字符索引值位于选区的锚点结尾
 
activeIndex:int — 从零开始的字符索引值位于选区的活动端。

setCompositionSize

()方法 
public function setCompositionSize(w:Number, h:Number):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

设置容器中允许的文本宽度和高度。可以以像素为单位来指定宽度和高度,或对于二者都可以使用 NaNNaN 指示测量值。可以用它来查找宽度最大的行和/或所有内容的总高度。当 NaN 指定为宽度时,行将以 TextLine.MAX_LINE_WIDTH 的最大宽度断开。当 NaN 指定为高度时,会假定容器具有无限制的高度。实际的测量值可以使用 getContentBounds 获得。当 TextFlowblockProgression 属性计算结果为 BlockProgression.RL 时,将交换高度和宽度的意义。

参数

w:Number — 适用于容器中文本的宽度(像素数)。NaN 指示未指定宽度。
 
h:Number — 适用于容器中文本的高度(像素数)。NaN 指示未指定高度。

相关 API 元素


示例  ( 如何使用本示例 )

此示例使用 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

()方法 
public function setStyle(styleProp:String, newValue:*):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

styleProp 参数指定的样式值设置为 newValue 参数指定的值。

参数

styleProp:String — 要设置值的样式属性的名称。
 
newValue:* — 要赋给该样式的值。

softKeyboardActivatingHandler

()方法 
public function softKeyboardActivatingHandler(event:Event):void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10.2, AIR 1.5

当客户端管理事件时处理 SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING 事件。

参数

event:Event — SoftKeyboardEvent 对象。

相关 API 元素

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 元素


示例  ( 如何使用本示例 )

此示例扩展 ContainerController 以使用一个自定义 textInputHandler() 方法覆盖其 textInputHandler() 方法。该示例需要触发 textInputHandler() 方法的应用程序。
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

()方法 
tlf_internal function updateGraphics(updateStart:int):void

参数

updateStart:int

updateVisibleRectangle

()方法 
protected function updateVisibleRectangle():void

语言版本: ActionScript 3.0
运行时版本: Flash Player 10, AIR 1.5

如果滚动,将滚动矩形设置为容器矩形,这样会将显示一半的任何行剪裁到可滚动区域。如果不滚动,则清除滚动矩形,不进行裁剪。

ContainerControllerExample1.as

此示例显示作为链接的容器的两个圆中的文本流,这意味着从第一个容器溢出的文本会自动流进第二个容器中。请注意,存在两个容器和控制器,但只存在一个文本流。
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();
        }    
    }
}

ContainerControllerExample2.as

该示例显示两个容器中的两个文本流、标题和正文文本。该示例为正文文本创建列并实现滚动。当舞台的大小发生改变时,resizeHandler() 方法会调整容器的大小并合成文本流。
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();
        }
    }
}




[ X ]为什么显示为英语?
《ActionScript 3.0 参考》中的内容以英语显示

《ActionScript 3.0 参考》中的部分内容未翻译成所有语言。当某个语言元素未翻译时,将显示为英语。例如,ga.controls.HelpBox 类未翻译成任何语言。因此在简体中文版的参考中,ga.controls.HelpBox 类显示为英语。