| 包 | flashx.textLayout.elements |
| 类 | public class FlowElement |
| 继承 | FlowElement Object |
| 实现 | ITextLayoutFormat |
| 子类 | FlowGroupElement, FlowLeafElement |
| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
可合成的 FlowElement 树的根始终是一个 TextFlow 对象。树的叶元素始终是 FlowLeafElement 类的子类。在可合成的 TextFlow 中排列的所有叶都具有 ParagraphElement 祖代。
您不能直接创建 FlowElement 对象。调用 new FlowElement() 时会引发错误异常。
相关 API 元素
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| alignmentBaseline : *
TextLayoutFormat:指定主要基线对齐到的基线。 | FlowElement | ||
| backgroundAlpha : *
TextLayoutFormat:背景的 Alpha(透明度)值(如果在层叠期间未定义,则使用默认值)。 | FlowElement | ||
| backgroundColor : *
TextLayoutFormat:文本的背景颜色(如果在层叠期间未定义,则使用默认值)。 | FlowElement | ||
| baselineShift : *
TextLayoutFormat:从 dominantBaseline 值偏移基线的数量。 | FlowElement | ||
| blockProgression : *
TextLayoutFormat:指定线位置的垂直或水平行进。 | FlowElement | ||
| breakOpportunity : *
TextLayoutFormat:控制在将连续文本断开为多行时允许行断开的位置。 | FlowElement | ||
| cffHinting : *
TextLayoutFormat:用于此文本的 CFF 提示的类型。 | FlowElement | ||
| clearFloats : *
TextLayoutFormat:控制文本在浮点周围的环绕方式。 | FlowElement | ||
| color : *
TextLayoutFormat:文本的颜色。 | FlowElement | ||
| columnCount : *
TextLayoutFormat:文本列数(如果在层叠期间未定义,则使用默认值)。 | FlowElement | ||
| columnGap : *
TextLayoutFormat:指定要在列之间留出的装订线空间量(以像素为单位),如果在层叠期间未定义,则使用默认值。 | FlowElement | ||
| columnWidth : *
TextLayoutFormat:列宽(以像素为单位)(如果在层叠期间未定义,则使用默认值)。 | FlowElement | ||
| computedFormat : flashx.textLayout.formats:ITextLayoutFormat [只读]
返回对于该元素有效的计算得出的格式属性。 | FlowElement | ||
![]() | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| coreStyles : Object [只读] 返回此 FlowElement 的 coreStyles。 | FlowElement | ||
| digitCase : *
TextLayoutFormat:用于此文本的数字大小写类型。 | FlowElement | ||
| digitWidth : *
TextLayoutFormat:用于此文本的数字宽度类型。 | FlowElement | ||
| direction : *
TextLayoutFormat:指定文本在文本块中的默认双向嵌入级别。 | FlowElement | ||
| dominantBaseline : *
TextLayoutFormat:指定该元素的哪条基线紧贴到 alignmentBaseline 以确定元素在该行上的垂直位置。 | FlowElement | ||
| firstBaselineOffset : *
TextLayoutFormat:指定容器中第一行的基线位置。 | FlowElement | ||
| fontFamily : *
TextLayoutFormat:要使用的字体的名称或用逗号分隔的字体名称列表。 | FlowElement | ||
| fontLookup : *
TextLayoutFormat:要使用的字体查找。 | FlowElement | ||
| fontSize : *
TextLayoutFormat:文本的大小(以像素为单位)。 | FlowElement | ||
| fontStyle : *
TextLayoutFormat:文本的样式。 | FlowElement | ||
| fontWeight : *
TextLayoutFormat:文本的粗细。 | FlowElement | ||
| format : flashx.textLayout.formats:ITextLayoutFormat TextLayoutFormat 属性直接应用于该元素。 | FlowElement | ||
| id : String
将一个标识名称指定给该元素,以允许通过引用 id 为该元素设置样式。 | FlowElement | ||
| justificationRule : *
TextLayoutFormat:用于将段落中的文本两端对齐的规则。 | FlowElement | ||
| justificationStyle : *
TextLayoutFormat:用于将段落两端对齐的样式。 | FlowElement | ||
| kerning : *
TextLayoutFormat:字距调整可调整某些字符对之间的像素以提高可读性。 | FlowElement | ||
| leadingModel : *
TextLayoutFormat:指定行距模型,它是行距基准和行距方向的组合。 | FlowElement | ||
| ligatureLevel : *
TextLayoutFormat:控制可以在该文本中使用字体中定义的哪些连字。 | FlowElement | ||
| lineBreak : *
TextLayoutFormat:控制容器内的换行(如果在层叠期间未定义,则使用默认值)。 | FlowElement | ||
| lineHeight : *
TextLayoutFormat:文本的行距控制。 | FlowElement | ||
| lineThrough : *
TextLayoutFormat:若为 true,则应用删除线(一条穿过文本中间的直线)。 | FlowElement | ||
| linkActiveFormat : *
TextLayoutFormat:定义用于处于正常状态的链接的格式属性。 | FlowElement | ||
| linkHoverFormat : *
TextLayoutFormat:定义当鼠标在链接边界内(悬停)时用于悬停状态链接的格式属性。 | FlowElement | ||
| linkNormalFormat : *
TextLayoutFormat:定义用于处于正常状态的链接的格式属性。 | FlowElement | ||
| listAutoPadding : *
TextLayoutFormat:指定当列表相应侧的内边距值为 auto 时,列表开始边缘的自动缩进。 | FlowElement | ||
| listMarkerFormat : *
TextLayoutFormat:定义列表标记的格式属性。 | FlowElement | ||
| listStylePosition : *
TextLayoutFormat:合法值为 ListStylePosition.INSIDE、ListStylePosition.OUTSIDE、FormatValue.INHERIT。默认值未定义,指示未设置。如果在层叠期间未定义,则此属性将从一个祖代继承值。 | FlowElement | ||
| 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。默认值未定义,指示未设置。如果在层叠期间未定义,则此属性将从一个祖代继承值。 | FlowElement | ||
| locale : *
TextLayoutFormat:文本的区域设置。 | FlowElement | ||
| paddingBottom : *
TextLayoutFormat:底部边界区(像素数)。 | FlowElement | ||
| paddingLeft : *
TextLayoutFormat:左侧边界区(像素数)。 | FlowElement | ||
| paddingRight : *
TextLayoutFormat:右侧边界区(像素数)。 | FlowElement | ||
| paddingTop : *
TextLayoutFormat:顶部边界区(像素数)。 | FlowElement | ||
| paragraphEndIndent : *
TextLayoutFormat:一个数字,指定段落结束边缘的缩进量(像素数)。 | FlowElement | ||
| paragraphSpaceAfter : *
TextLayoutFormat:一个数字,指定在段落后留出的空白(像素数)。 | FlowElement | ||
| paragraphSpaceBefore : *
TextLayoutFormat:一个数字,指定在段落前留出的空白(像素数)。 | FlowElement | ||
| paragraphStartIndent : *
TextLayoutFormat:一个数字,指定段落开始边缘的缩进量(像素数)。 | FlowElement | ||
| parent : FlowGroupElement [只读] 返回该 FlowElement 对象的父项。 | FlowElement | ||
| parentRelativeEnd : int [只读] 返回该 FlowElement 对象在父项中的相对结束位置。 | FlowElement | ||
| parentRelativeStart : int [只读] 返回该 FlowElement 对象在父项中的相对起始位置。 | FlowElement | ||
| renderingMode : *
TextLayoutFormat:用于此文本的呈现模式。 | FlowElement | ||
| styleName : *
TextLayoutFormat:为元素指定一个标识类,从而可以通过引用 styleName 来设置元素样式。 | FlowElement | ||
| styles : Object [只读] 返回此 FlowElement 的样式。 | FlowElement | ||
| tabStops : *
TextLayoutFormat:指定与段落关联的制表位。 | FlowElement | ||
| textAlign : *
TextLayoutFormat:段落中的行与容器的对齐方式。 | FlowElement | ||
| textAlignLast : *
TextLayoutFormat:两端对齐文本中段落最后一行(或唯一的一行)与容器的对齐方式。 | FlowElement | ||
| textAlpha : *
TextLayoutFormat:文本的 Alpha(透明度)值。 | FlowElement | ||
| textDecoration : *
TextLayoutFormat:文本上的装饰。 | FlowElement | ||
| textIndent : *
TextLayoutFormat:一个数字,指定段落第一行的缩进量(以像素为单位)。 | FlowElement | ||
| textJustify : *
TextLayoutFormat:指定文本两端对齐的选项。 | FlowElement | ||
| textLength : int [只读]
返回该 FlowElement 对象及其子对象拥有的文本总长度。 | FlowElement | ||
| textRotation : *
TextLayoutFormat:确定要旋转此文本的度数。 | FlowElement | ||
| tracking : Object [只写]
设置间隙,且与 trackingRight 属性同义。 | FlowElement | ||
| trackingLeft : *
TextLayoutFormat:像素数(或字体大小的百分比,如 120%),指示应用于每个字符左侧的间隙数(手动字距调整)。 | FlowElement | ||
| trackingRight : *
TextLayoutFormat:像素数(或字体大小的百分比,如 120%)表示要应用到每个字符右边的间距的量(手动字距调整)。 | FlowElement | ||
| typeName : String
每个 FlowElement 都具有 typeName。 | FlowElement | ||
| typographicCase : *
TextLayoutFormat:用于此文本的印刷大小写的类型。 | FlowElement | ||
| userStyles : Object 允许您针对 FlowElement 对象读写用户样式。 | FlowElement | ||
| verticalAlign : *
TextLayoutFormat:垂直对齐或两端对齐(如果在层叠期间未定义,则使用默认值)。 | FlowElement | ||
| whiteSpaceCollapse : *
TextLayoutFormat:将文本导入到 TextFlow 中时压缩或保留空白。 | FlowElement | ||
| wordSpacing : *
TextLayoutFormat:指定在两端对齐期间使用的单词之间的最佳间距、最小间距和最大间距(作为普通间距宽度的乘数)。 | FlowElement | ||
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
基类 - 调用 new FlowElement() 时会引发错误异常。 | FlowElement | ||
从该 FlowElement 对象清除 styleProp 参数指定的样式。 | FlowElement | ||
生成此 FlowElement 对象的深层副本,包括任何子对象,在两个指定的字符位置之间复制内容,并将该副本作为 FlowElement 对象返回。 | FlowElement | ||
将此元素的 userStyles 与其它元素的 userStyles 比较。 | FlowElement | ||
返回该元素在文本流中的起始位置(绝对索引)。 | FlowElement | ||
返回相对于该 FlowElement 对象的指定位置的字符。 | FlowElement | ||
返回相对于该 FlowElement 对象的指定位置的字符代码。 | FlowElement | ||
返回该元素相对于祖代元素的起始位置。 | FlowElement | ||
返回文本流层次结构中的下一个 FlowElement 同级对象。 | FlowElement | ||
返回与该元素关联的 ParagraphElement 对象。 | FlowElement | ||
返回文本流层次结构中的上一个 FlowElement 同级对象。 | FlowElement | ||
返回由 styleProp 参数指定的样式值,该参数指定样式名称,可以包括任何用户样式名称。 | FlowElement | ||
从流元素获取指定的文本范围。 | FlowElement | ||
沿文本流层次结构向上移动,返回该元素的 TextFlow 根对象。 | FlowElement | ||
![]() |
表示对象是否已经定义了指定的属性。 | Object | |
创建实现对象且初始化在 MXML 标签上指定的所有组件属性后针对 MXML 对象进行调用。 | FlowElement | ||
![]() |
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
![]() |
表示指定的属性是否存在、是否可枚举。 | Object | |
![]() |
设置循环操作动态属性的可用性。 | Object | |
将 styleProp 参数指定的样式设置为 newValue 参数指定的值。 | FlowElement | ||
生成此 FlowElement 对象的副本,复制两个指定的字符位置之间的内容。 | FlowElement | ||
在由 relativePosition 参数指定的位置处拆分此 FlowElement 对象,该位置是此元素的文本中的相对位置。 | FlowElement | ||
![]() |
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | |
![]() |
返回指定对象的字符串表示形式。 | Object | |
![]() |
返回指定对象的原始值。 | Object | |
alignmentBaseline | 属性 |
alignmentBaseline:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定主要基线对齐到的基线。例如,如果将 dominantBaseline 设置为 ASCENT,则将 alignmentBaseline 设置为 DESCENT 会将文本的顶部与下缘基线对齐,或在该线下面。基线通常由行中最大的元素决定。

合法值为 TextBaseline.ROMAN、TextBaseline.ASCENT、TextBaseline.DESCENT、TextBaseline.IDEOGRAPHIC_TOP、TextBaseline.IDEOGRAPHIC_CENTER、TextBaseline.IDEOGRAPHIC_BOTTOM、TextBaseline.USE_DOMINANT_BASELINE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextBaseline.USE_DOMINANT_BASELINE。
实现
public function get alignmentBaseline():* public function set alignmentBaseline(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
backgroundAlpha | 属性 |
backgroundAlpha:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:背景的 Alpha(透明度)值(如果在层叠期间未定义,则使用默认值)。值为 0 表示完全透明,值为 1 表示完全不透明。Alpha 设置为 0 的显示对象是活动对象,即使它们不可见。
合法值为 0 到 1 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性值为 1。
实现
public function get backgroundAlpha():* public function set backgroundAlpha(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
backgroundColor | 属性 |
backgroundColor:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的背景颜色(如果在层叠期间未定义,则使用默认值)。可以是常量值 BackgroundColor.TRANSPARENT,或一个指定三个 8 位 RGB(红、绿、蓝)值的十六进制值,例如 0xFF0000 表示红色,0x00FF00 表示绿色。
合法字符串值为 BackgroundColor.TRANSPARENT、FormatValue.INHERIT 和从 0x0 到 0xffffffff 范围内的非整数。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 BackgroundColor.TRANSPARENT。
实现
public function get backgroundColor():* public function set backgroundColor(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
baselineShift | 属性 |
baselineShift:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:基线距 dominantBaseline 值的偏移量。单位是像素或者 fontSize 的百分比(此时应输入字符串值,例如 140%)。如果是正值,则将水平文本行向上(对于垂直文本行是向右)移动;如果是负值,则将水平文本行向下(对于垂直文本行是向左)移动。
合法值为 BaselineShift.SUPERSCRIPT、BaselineShift.SUBSCRIPT、FormatValue.INHERIT。
合法值为 -1000 到 1000 范围内的数字。
百分比合法值为 -1000 到 1000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0.0。
实现
public function get baselineShift():* public function set baselineShift(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
blockProgression | 属性 |
blockProgression:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定线位置的垂直或水平行进。将行按照从上至下(BlockProgression.TB,用于水平文本行)或从右至左(BlockProgression.RL,用于垂直文本行)的顺序放置。
合法值为 BlockProgression.RL、BlockProgression.TB、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 BlockProgression.TB。
实现
public function get blockProgression():* public function set blockProgression(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
breakOpportunity | 属性 |
breakOpportunity:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:控制在将连续文本断开为多行时允许行断开的位置。设置为 BreakOpportunity.AUTO 以正常断开文本。设置为 BreakOpportunity.NONE 以不断开文本,除非文本会超出测量限度且不存在任何其它位置来断开行。设置为 BreakOpportunity.ANY 以允许该行在任意位置断开,而不是仅仅在单词之间断开。设置为 BreakOpportunity.ALL 以将每个排版群集放置在一个单独的行上(对于路径上的文本很有用)。
合法值为 BreakOpportunity.ALL、BreakOpportunity.ANY、BreakOpportunity.AUTO、BreakOpportunity.NONE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 BreakOpportunity.AUTO。
实现
public function get breakOpportunity():* public function set breakOpportunity(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
cffHinting | 属性 |
cffHinting:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于此文本的 CFF 提示的类型。CFF 提示决定了 Flash 运行时是否强制让粗水平线适合子像素网格。只有当 renderingMode 属性被设置为 RenderingMode.CFF 且嵌入了字体(fontLookup 属性被设置为 FontLookup.EMBEDDED_CFF)时,才会应用此属性。对于小的屏幕尺寸,提示将生成让人易于阅读的清晰文本。
合法值为 CFFHinting.NONE、CFFHinting.HORIZONTAL_STEM、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 CFFHinting.HORIZONTAL_STEM。
实现
public function get cffHinting():* public function set cffHinting(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
clearFloats | 属性 |
clearFloats:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:控制文本在浮点周围的环绕方式。如果值为 none,将使得文本更紧密地环绕在浮点周围。如果值为 left,将导致文本跳过容器中具有左侧浮点的任意部分,而如果值为 right,将导致文本跳过容器中具有右侧浮点的任意部分。如果值为 both,将导致文本跳过所有浮点。
合法值为 ClearFloats.START、ClearFloats.END、ClearFloats.LEFT、ClearFloats.RIGHT、ClearFloats.BOTH、ClearFloats.NONE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 ClearFloats.NONE。
实现
public function get clearFloats():* public function set clearFloats(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
color | 属性 |
color:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的颜色。一个十六进制数字,指定三个 8 位 RGB(红、绿、蓝)值,例如 0xFF0000 表示红色,0x00FF00 表示绿色。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get color():* public function set color(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
columnCount | 属性 |
columnCount:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本列数(如果在层叠期间未定义,则使用默认值)。该列数会覆盖其它列设置。该值是一个整数,如果未指定,则为 FormatValue.AUTO。如果未指定 columnCount,则系统使用 columnWidth 创建容器可容纳的尽可能多的列。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 1 到 50 范围内的整数。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get columnCount():* public function set columnCount(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
columnGap | 属性 |
columnGap:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定要在列之间留出的装订线空间量(以像素为单位),如果在层叠期间未定义,则使用默认值。该值是一个数字。
合法值为 0 到 1000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性值为 20。
实现
public function get columnGap():* public function set columnGap(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
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 元素
computedFormat | 属性 |
computedFormat:flashx.textLayout.formats:ITextLayoutFormat [只读] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回对于该元素有效的计算得出的格式属性。考虑从父元素继承属性。
实现
public function get computedFormat():flashx.textLayout.formats:ITextLayoutFormat相关 API 元素
coreStyles | 属性 |
digitCase | 属性 |
digitCase:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于此文本的数字大小写类型。将该值设置为 DigitCase.OLD_STYLE 时接近支持不同上行字母和下行字母的小写字母形式。各位数字之间等比间隔。此样式只适用于所选的字体,最常用于 supplemental 或 expert 字体。DigitCase.LINING 设置具有 all-cap(全大写)高度,通常为等宽以便在图表中对齐。

合法值为 DigitCase.DEFAULT、DigitCase.LINING、DigitCase.OLD_STYLE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 DigitCase.DEFAULT。
实现
public function get digitCase():* public function set digitCase(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
digitWidth | 属性 |
digitWidth:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于此文本的数字宽度类型。可以是 DigitWidth.PROPORTIONAL,最适用于显示单独出现的数字,或者是 DigitWidth.TABULAR,最适用于显示表、图表和垂直行中的数字。

合法值为 DigitWidth.DEFAULT、DigitWidth.PROPORTIONAL、DigitWidth.TABULAR、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 DigitWidth.DEFAULT。
实现
public function get digitWidth():* public function set digitWidth(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
direction | 属性 |
direction:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定文本在文本块中的默认双向嵌入级别。从左到右的阅读顺序,如在拉丁风格的文本中,或者从右到左的阅读顺序,如阿拉伯语或希伯来语。此属性还影响在容器级别应用时列的方向。与文本一样,列可以为从左到右或从右到左排列。下面给出了一些示例:

合法值为 Direction.LTR、Direction.RTL、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 Direction.LTR。
实现
public function get direction():* public function set direction(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
dominantBaseline | 属性 |
dominantBaseline:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定该元素的哪条基线紧贴到 alignmentBaseline 以确定元素在该行上的垂直位置。值为 TextBaseline.AUTO 会基于父段落的 locale 属性选择主要基线。对于日语和中文,选定的基线值是 TextBaseline.IDEOGRAPHIC_CENTER;对于所有其它语言,选定的基线值是 TextBaseline.ROMAN。这些基线选项由选择的字体和字体大小决定。

合法值为 FormatValue.AUTO、TextBaseline.ROMAN、TextBaseline.ASCENT、TextBaseline.DESCENT、TextBaseline.IDEOGRAPHIC_TOP、TextBaseline.IDEOGRAPHIC_CENTER、TextBaseline.IDEOGRAPHIC_BOTTOM、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 FormatValue.AUTO。
实现
public function get dominantBaseline():* public function set dominantBaseline(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
firstBaselineOffset | 属性 |
firstBaselineOffset:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定容器中第一行的基线位置。该属性引用的基线取决于容器级别的区域设置。对于日语和中文,为 TextBaseline.IDEOGRAPHIC_BOTTOM;对于所有其它语言,为 TextBaseline.ROMAN。从容器顶部边界(如果 blockProgression 是 RL 则为右侧边界)到第一行的基线之间的偏移可以是 BaselineOffset.ASCENT,表示等于行的 ascent(文本顶端或右端到基线的距离),也可以是 BaselineOffset.LINE_HEIGHT,表示等于第一行的高度,或者是任何固定值数字,用于指定绝对距离。BaselineOffset.AUTO 可将行的 ascent 与容器顶部边界对齐。




合法字符串值为 BaselineOffset.AUTO、BaselineOffset.ASCENT、BaselineOffset.LINE_HEIGHT、FormatValue.INHERIT 和从 0 到 1000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 BaselineOffset.AUTO。
实现
public function get firstBaselineOffset():* public function set firstBaselineOffset(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
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:ITextLayoutFormatTextLayoutFormat 属性直接应用于该元素。
每个元素可以应用属性,作为其格式的一部分。应用于该元素的属性会覆盖从父项继承的属性。应用于该元素的属性又会由其子元素继承(如果没有覆盖子元素的这些属性)。如果没有任何属性应用于该元素,则为 null。
实现
public function get format():flashx.textLayout.formats:ITextLayoutFormat public function set format(value:flashx.textLayout.formats:ITextLayoutFormat):void相关 API 元素
id | 属性 |
justificationRule | 属性 |
justificationRule:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于将段落中的文本两端对齐的规则。默认值为 FormatValue.AUTO,它基于段落的 locale 属性将文本两端对齐。对于除了日语和中文之外的所有语言,FormatValue.AUTO 会变成 JustificationRule.SPACE,后者会向空格字符添加额外的空格。对于日语和中文,FormatValue.AUTO 会变成 JustficationRule.EAST_ASIAN。在某种程度上,两端对齐会改变标点的间距。在罗马文本中,逗号和日语句号占一个全字符的宽度,但在东亚文本中,仅占一个字符宽度的一半。另外,在东亚文本中,连续的标点符号之间的间距会变得更紧密,遵守传统东亚排版惯例。同样要注意的是,在下面的示例中,应用到段落的第二行的行距。在东亚版本中,最后两行向左推进。在罗马版本中,第二行和之后的行向左推进。

合法值为 JustificationRule.EAST_ASIAN、JustificationRule.SPACE、FormatValue.AUTO、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 FormatValue.AUTO。
实现
public function get justificationRule():* public function set justificationRule(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
justificationStyle | 属性 |
justificationStyle:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于将段落两端对齐的样式。仅与 JustificationRule.EAST_ASIAN 的 justificationRule 设置一起使用。对于所有区域设置,FormatValue.AUTO 的默认值被解析为 JustificationStyle.PUSH_IN_KINSOKU。JustificationStyle 类定义的常量指定用于处理避头尾 (kinsoku) 字符的选项;避头尾字符是指不能出现在一行首尾的日语字符。如果希望文本布局更宽松,请指定 JustificationStyle.PUSH-OUT-ONLY。如果希望文本布局类似于使用 JustificationRule.SPACE 的 justificationRule 得到的结果,可使用 JustificationStyle.PRIORITIZE-LEAST-ADJUSTMENT。
合法值为 JustificationStyle.PRIORITIZE_LEAST_ADJUSTMENT、JustificationStyle.PUSH_IN_KINSOKU、JustificationStyle.PUSH_OUT_ONLY、FormatValue.AUTO、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 FormatValue.AUTO。
实现
public function get justificationStyle():* public function set justificationStyle(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
kerning | 属性 |
kerning:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:字距调整可调整某些字符对之间的像素以提高可读性。字距调整表的所有字体都支持字距调整。
合法值为 Kerning.ON、Kerning.OFF、Kerning.AUTO、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 Kerning.AUTO。
实现
public function get kerning():* public function set kerning(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
leadingModel | 属性 |
leadingModel:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定行距模型,它是行距基准和行距方向的组合。行距基准是 lineHeight 属性引用的基线。行距方向决定了 lineHeight 属性是引用一行基线与前一行基线之间的距离,还是与后一行基线之间的距离。默认值 FormatValue.AUTO 根据段落的 locale 属性进行解析。对于日语和中文,为 LeadingModel.IDEOGRAPHIC_TOP_DOWN,对于所有其他语言,为 LeadingModel.ROMAN_UP。
行距基准:

行距方向:

合法值为 LeadingModel.ROMAN_UP、LeadingModel.IDEOGRAPHIC_TOP_UP、LeadingModel.IDEOGRAPHIC_CENTER_UP、LeadingModel.IDEOGRAPHIC_TOP_DOWN、LeadingModel.IDEOGRAPHIC_CENTER_DOWN、LeadingModel.APPROXIMATE_TEXT_FIELD、LeadingModel.ASCENT_DESCENT_UP、LeadingModel.BOX、LeadingModel.AUTO、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 LeadingModel.AUTO。
实现
public function get leadingModel():* public function set leadingModel(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
ligatureLevel | 属性 |
ligatureLevel:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:控制可以在该文本中使用字体中定义的哪些连字。对于每个设置显示的连字取决于字体。由两个或两个以上的字母结合在一起形成单个字型时就是连字。连字通常用于替换一些共享公共部分的连续字符,例如字母对“fi”、“fl”或“ae”。在拉丁语字符集和非拉丁语字符集中均可使用连字。LigatureLevel 类的值(MINIMUM、COMMON、UNCOMMON 和 EXOTIC)支持的连字是添加的。每个值支持一个新连字集,而且包含先前类型的那些连字。
注意:使用阿拉伯语或叙利亚语字体时,必须将 ligatureLevel 设置为 MINIMUM 或更高。

合法值为 LigatureLevel.MINIMUM、LigatureLevel.COMMON、LigatureLevel.UNCOMMON、LigatureLevel.EXOTIC、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 LigatureLevel.COMMON。
实现
public function get ligatureLevel():* public function set ligatureLevel(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
lineBreak | 属性 |
lineBreak:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:控制容器内的换行(如果在层叠期间未定义,则使用默认值)。可以将容器中的文本设置为适合容器的宽度 (LineBreak.TO_FIT),也可以设置为只在显式回车或换行符处断开 (LineBreak.EXPLICIT)。
合法值为 LineBreak.EXPLICIT、LineBreak.TO_FIT、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 LineBreak.TO_FIT。
实现
public function get lineBreak():* public function set lineBreak(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
lineHeight | 属性 |
lineHeight:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的行距控制。上一行或下一行(取决于 LeadingModel)的基线与当前行的基线之间的距离,等于应用于该行中任意字符的最大行距。该值可以是数字或百分比。如果指定百分比,请输入字符串值,例如 140%。


合法值为 -720 到 720 范围内的数字。
合法值为 -1000% 到 1000% 范围内的百分比数字。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 120%。
实现
public function get lineHeight():* public function set lineHeight(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
lineThrough | 属性 |
lineThrough:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:如果为 true,则应用删除线(贯穿文本中间绘制的线)。
合法值为 true、false 和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 false。
实现
public function get lineThrough():* public function set lineThrough(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
linkActiveFormat | 属性 |
linkActiveFormat:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:定义用于处于正常状态的链接的格式属性。此值将向下层叠层次结构,并应用于作为后代的所有链接。接受 inherit,一个 ITextLayoutFormat,或将带有键和值的对象数组作为成员转换为 TextLayoutFormat。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 null。
实现
public function get linkActiveFormat():* public function set linkActiveFormat(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
linkHoverFormat | 属性 |
linkHoverFormat:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:定义当鼠标在链接边界内(悬停)时用于悬停状态链接的格式属性。此值将向下层叠层次结构,并应用于作为后代的所有链接。接受 inherit,一个 ITextLayoutFormat,或将带有键和值的对象数组作为成员转换为 TextLayoutFormat。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 null。
实现
public function get linkHoverFormat():* public function set linkHoverFormat(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
linkNormalFormat | 属性 |
linkNormalFormat:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:定义用于处于正常状态的链接的格式属性。此值将向下层叠层次结构,并应用于作为后代的所有链接。接受 inherit,一个 ITextLayoutFormat,或将带有键和值的对象数组作为成员转换为 TextLayoutFormat。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 null。
实现
public function get linkNormalFormat():* public function set linkNormalFormat(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
listAutoPadding | 属性 |
listAutoPadding:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定当列表相应侧的内边距值为 auto 时,列表开始边缘的自动缩进。
合法值为 -1000 到 1000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 40。
实现
public function get listAutoPadding():* public function set listAutoPadding(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
listMarkerFormat | 属性 |
listMarkerFormat:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:定义列表标记的格式属性。此值将向下层叠层次结构,并应用于作为后代的所有链接。接受 inherit,一个 IListMarkerFormat,或将带有键与值的对象数组作为成员转换为 ListMarkerFormat。
合法值包括 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 null。
实现
public function get listMarkerFormat():* public function set listMarkerFormat(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
listStylePosition | 属性 |
listStylePosition:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:
合法值为 ListStylePosition.INSIDE、ListStylePosition.OUTSIDE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 ListStylePosition.OUTSIDE。
实现
public function get listStylePosition():* public function set listStylePosition(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
listStyleType | 属性 |
listStyleType:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:
合法值为 ListStyleType.UPPER_ALPHA、ListStyleType.LOWER_ALPHA、ListStyleType.UPPER_ROMAN、ListStyleType.LOWER_ROMAN、ListStyleType.NONE、ListStyleType.DISC、ListStyleType.CIRCLE、ListStyleType.SQUARE、ListStyleType.BOX、ListStyleType.CHECK、ListStyleType.DIAMOND、ListStyleType.HYPHEN、ListStyleType.ARABIC_INDIC、ListStyleType.BENGALI、ListStyleType.DECIMAL、ListStyleType.DECIMAL_LEADING_ZERO、ListStyleType.DEVANAGARI、ListStyleType.GUJARATI、ListStyleType.GURMUKHI、ListStyleType.KANNADA、ListStyleType.PERSIAN、ListStyleType.THAI、ListStyleType.URDU、ListStyleType.CJK_EARTHLY_BRANCH、ListStyleType.CJK_HEAVENLY_STEM、ListStyleType.HANGUL、ListStyleType.HANGUL_CONSTANT、ListStyleType.HIRAGANA、ListStyleType.HIRAGANA_IROHA、ListStyleType.KATAKANA、ListStyleType.KATAKANA_IROHA、ListStyleType.LOWER_ALPHA、ListStyleType.LOWER_GREEK、ListStyleType.LOWER_LATIN、ListStyleType.UPPER_ALPHA、ListStyleType.UPPER_GREEK、ListStyleType.UPPER_LATIN、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 ListStyleType.DISC。
实现
public function get listStyleType():* public function set listStyleType(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
locale | 属性 |
locale:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的区域设置。控制大小写转换和形状。使用标准区域设置标识符,如 Unicode Technical Standard #35 中所述。例如,en、en_US 和 en-US 均表示英语,ja 表示日语。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 en。
实现
public function get locale():* public function set locale(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
paddingBottom | 属性 |
paddingBottom:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:底部边界区(像素数)。如果默认值为 auto,表示为零,除非列表中的开始边缘内边距为 45。(如果在层叠期间未定义,则使用默认值)。容器底部边缘与文本之间的空间。该值是一个数字或 auto。
对于水平文本,在含有多个列的可滚动容器中,第一列和后续列将填充部分显示为容器底部的空白,但是对于最后一列,如果文本没有完全填充,可能必须进行滚动才能看到填充。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 -8000 到 8000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get paddingBottom():* public function set paddingBottom(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
paddingLeft | 属性 |
paddingLeft:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:左侧边界区(像素数)。如果默认值为 auto,表示为零,除非列表中的开始边缘内边距为 45。(如果在层叠期间未定义,则使用默认值)。容器左边缘与文本之间的空间。该值是一个数字或 auto。
对于垂直文本,在含有多个列的可滚动容器中,第一列和后续列将填充部分显示为容器末尾的空白,但是对于最后一列,如果文本没有完全填充,可能必须进行滚动才能看到填充。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 -8000 到 8000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get paddingLeft():* public function set paddingLeft(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
paddingRight | 属性 |
paddingRight:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:右侧边界区(像素数)。如果默认值为 auto,表示为零,除非列表中的开始边缘内边距为 45。(如果在层叠期间未定义,则使用默认值)。容器右边缘与文本之间的空间。该值是一个数字或 auto。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 -8000 到 8000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get paddingRight():* public function set paddingRight(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
paddingTop | 属性 |
paddingTop:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:顶部边界区(像素数)。如果默认值为 auto,表示为零,除非列表中的开始边缘内边距为 45。(如果在层叠期间未定义,则使用默认值)。容器顶部边缘与文本之间的空间。该值是一个数字或 auto。
合法字符串值为 FormatValue.AUTO、FormatValue.INHERIT 和从 -8000 到 8000 范围内的数字。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 FormatValue.AUTO。
实现
public function get paddingTop():* public function set paddingTop(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
paragraphEndIndent | 属性 |
paragraphEndIndent:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:一个数字,指定段落结束边缘的缩进量(像素数)。是指从左到右文本中的右边缘和从右到左文本中的左边缘。
合法值为 0 到 8000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get paragraphEndIndent():* public function set paragraphEndIndent(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
paragraphSpaceAfter | 属性 |
paragraphSpaceAfter:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:一个数字,指定在段落后留出的空白(像素数)。与 paragraphSpaceBefore 一起使用时会合并。
合法值为 0 到 8000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get paragraphSpaceAfter():* public function set paragraphSpaceAfter(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
paragraphSpaceBefore | 属性 |
paragraphSpaceBefore:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:一个数字,指定在段落前留出的空白(像素数)。与 paragraphSpaceAfter 一起使用时会合并。
合法值为 0 到 8000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get paragraphSpaceBefore():* public function set paragraphSpaceBefore(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
paragraphStartIndent | 属性 |
paragraphStartIndent:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:一个数字,指定段落开始边缘的缩进量(像素数)。是指从左至右文本的左边和从右至左文本的右边。
合法值为 0 到 8000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get paragraphStartIndent():* public function set paragraphStartIndent(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
parent | 属性 |
parent:FlowGroupElement [只读] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回该 FlowElement 对象的父项。每个 FlowElement 最多有一个父项。
实现
public function get parent():FlowGroupElementparentRelativeEnd | 属性 |
parentRelativeStart | 属性 |
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 元素
styleName | 属性 |
styleName:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:将一个标识类指定给该元素,以允许通过引用 styleName 为该元素设置样式。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性值为 null。
实现
public function get styleName():* public function set styleName(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
styles | 属性 |
tabStops | 属性 |
tabStops:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定与段落关联的制表位。Setter 可采用 TabStopFormat 数组、精简的字符串表示形式、undefined 或 FormatValue.INHERIT。精简的字符串表示形式始终转换为 TabStopFormat 的一个数组。
基于字符串的格式是一个制表位列表,其中各个制表位由一个或多个空格分隔。
制表位的形式为:<对齐类型><对齐位置>|<对齐标记>。
对齐类型由一个字符表示,可以是 S、E、C 或 D(或相应小写字母)。S 或 s 表示起始,E 或 e 表示末尾,C 或 c 表示中心,D 或 d 表示小数。对齐类型是可选的,如果未指定,将默认为 S。
对齐位置是一个数字,根据数字的 FXG 规范(小数或科学表示法)指定。对齐位置是必需的。
垂直竖线用于分隔对齐位置和对齐标记,只有当存在对齐标记时才应存在。
如果对齐类型为 D,则对齐标记是可选的,如果是其它对齐类型,则对齐标记不应存在。对齐标记可以是由制表位末尾空白所终止的任何字符序列(对于最后一个制表位,末尾空白可选,默认为对齐标记的末尾)。如果空格由反斜杠进行转义 (\ ),则可以是对齐标记本身的一部分。如果反斜杠由另一个反斜杠进行转义 (\\),则可以是对齐标记本身的一部分。如果对齐类型为 D,且未指定对齐标记,则会使用默认值 null。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 null。
实现
public function get tabStops():* public function set tabStops(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
textAlign | 属性 |
textAlign:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:段落中的行与容器的对齐方式。TextAlign.LEFT 将文本行与容器左边缘对齐。TextAlign.RIGHT 与右边缘对齐。TextAlign.CENTER 等效于将从左至右的文本设置为左对齐,或将从右至左的文本设置为右对齐。TextAlign.JUSTIFY 会展开行,使其充满整个空间。TextAlign.START 等效于将从左至右的文本设置为左对齐,或将从右至左的文本设置为右对齐。TextAlign.END 等效于将从左至右的文本设置为右对齐,或将从右至左的文本设置为左对齐。
合法值为 TextAlign.LEFT、TextAlign.RIGHT、TextAlign.CENTER、TextAlign.JUSTIFY、TextAlign.START、TextAlign.END、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextAlign.START。
实现
public function get textAlign():* public function set textAlign(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
textAlignLast | 属性 |
textAlignLast:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:两端对齐文本中段落最后一行(或唯一的一行)与容器的对齐方式。如果 textAlign 设置为 TextAlign.JUSTIFY,则 textAlignLast 指定最后一行(如果是只含一行的块则为唯一一行)的对齐方式。其值类似于 textAlign。
合法值为 TextAlign.LEFT、TextAlign.RIGHT、TextAlign.CENTER、TextAlign.JUSTIFY、TextAlign.START、TextAlign.END、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextAlign.START。
实现
public function get textAlignLast():* public function set textAlignLast(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
textAlpha | 属性 |
textAlpha:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本的 Alpha(透明度)值。值为 0 表示完全透明,值为 1 表示完全不透明。textAlpha 设置为 0 的显示对象是活动对象,即使它们不可见。
合法值为 0 到 1 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 1。
实现
public function get textAlpha():* public function set textAlpha(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
textDecoration | 属性 |
textDecoration:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:文本上的装饰。用于应用下划线,默认值为 none。
合法值为 TextDecoration.NONE、TextDecoration.UNDERLINE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextDecoration.NONE。
实现
public function get textDecoration():* public function set textDecoration(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
textIndent | 属性 |
textIndent:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:一个数字,指定段落第一行的缩进量(以像素为单位)。如果为负值,则会将行向边缘中推进,可能会推到容器之外。
合法值为 -8000 到 8000 范围内的数字和 FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置了此属性,则其值为 0。
实现
public function get textIndent():* public function set textIndent(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
textJustify | 属性 |
textJustify:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:指定文本两端对齐的选项。默认值为 TextJustify.INTER_WORD,表示向空格符添加额外空格。TextJustify.DISTRIBUTE 会向空格符和各字母之间添加额外空格。仅与 JustificationRule.SPACE 的 justificationRule 值一起使用。
合法值为 TextJustify.INTER_WORD、TextJustify.DISTRIBUTE、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TextJustify.INTER_WORD。
实现
public function get textJustify():* public function set textJustify(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
textLength | 属性 |
textLength:int [只读] | 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回该 FlowElement 对象及其子对象拥有的文本总长度。如果某个元素没有文本,则 textLength 的值通常为零。
ParagraphElement 对象的最后一个跨距具有最后一个 SpanElement 对象的段落终止符。该终止符包括在该 SpanElement 对象及其所有父对象的 textLength 值中。该终止符不包括在此 SpanElement 对象的 text 属性中。
实现
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 元素
tracking | 属性 |
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 — 当设置的值不在此属性的范围内时
|
typeName | 属性 |
typeName:String| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
每个 FlowElement 都具有 typeName。typeName 默认为 textLayoutFormat TextConverter 使用的字符串。此 API 可用于将不同的 typeName 设置为 FlowElement。通常完成后能支持 CSS 中的 type 选择器。
请参阅 TEXT_FIELD_HTML_FORMAT 文档获取使用信息。
实现
public function get typeName():String public function set typeName(value:String):void相关 API 元素
typographicCase | 属性 |
typographicCase:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:用于此文本的印刷大小写的类型。下面给出了一些示例:

合法值为 TLFTypographicCase.DEFAULT、TLFTypographicCase.CAPS_TO_SMALL_CAPS、TLFTypographicCase.UPPERCASE、TLFTypographicCase.LOWERCASE、TLFTypographicCase.LOWERCASE_TO_SMALL_CAPS、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义,则此属性将从一个祖代继承值。如果没有祖代设置此属性,则其值为 TLFTypographicCase.DEFAULT。
实现
public function get typographicCase():* public function set typographicCase(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
userStyles | 属性 |
verticalAlign | 属性 |
verticalAlign:*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
TextLayoutFormat:垂直对齐或两端对齐(如果在层叠期间未定义,则使用默认值)。确定 TextFlow 元素在容器内如何对齐。
合法值为 VerticalAlign.TOP、VerticalAlign.MIDDLE、VerticalAlign.BOTTOM、VerticalAlign.JUSTIFY、FormatValue.INHERIT。
默认值未定义,指示未设置。
如果在层叠期间未定义此属性,则其值为 VerticalAlign.TOP。
实现
public function get verticalAlign():* public function set verticalAlign(value:any):void引发
RangeError — 当设置的值不在此属性的范围内时
|
相关 API 元素
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 — 当设置的值不在此属性的范围内时
|
FlowElement | () | 构造函数 |
public function FlowElement()| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
基类 - 调用 new FlowElement() 时会引发错误异常。
clearStyle | () | 方法 |
public function clearStyle(styleProp:String):void| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
从该 FlowElement 对象清除由 styleProp 参数指定的样式。将值设置为 undefined。
参数
styleProp:String — 要清除的样式的名称。
|
相关 API 元素
示例 ( 如何使用本示例 )
clearStyle() 将某个样式的值设置为 undefined,但仍可以将某个继承值应用到该样式。
package flashx.textLayout.elements.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;
public class FlowElement_clearStyleExample extends Sprite{
public function FlowElement_clearStyleExample()
{
// create a container and a TextFlow object
var container:Sprite = new Sprite();
this.addChild(container);
var textFlow:TextFlow = new TextFlow();
// create a paragraph and set lineThrough style to true
var paragraph:ParagraphElement = new ParagraphElement();
paragraph.setStyle("color", 204);
// create two spans of text
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
var span3:SpanElement = new SpanElement();
span1.text = "After calling clearStyle(), the value of color for span1 is: ";
span2.text = " but the value of span1.getStyle() for color is ";
span3.text = " because getStyle() returns the inherited value that's applied to the style.";
span1.clearStyle("color"); // undefined
span1.text += span1.color;
paragraph.addChild(span1);
paragraph.addChild(span2);
span2.text += span1.getStyle("color"); //204
paragraph.addChild(span3);
textFlow.addChild(paragraph);
// add controller, then update controller to display text
var firstController:ContainerController = new ContainerController(container, 200, 200 );
textFlow.flowComposer.addController(firstController);
textFlow.flowComposer.updateAllControllers();
}
}
}
deepCopy | () | 方法 |
public function deepCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
生成此 FlowElement 对象的深层副本,包括任何子对象,在两个指定的字符位置之间复制内容,并将该副本作为 FlowElement 对象返回。
如果不使用任何参数,则默认情况下 deepCopy() 复制整个元素。
参数
relativeStart:int (default = 0) — 要复制的第一个字符的相对文本位置。第一个位置为 0。
| |
relativeEnd:int (default = -1) — 要复制的最后一个字符的相对文本位置。值为 -1 表示复制到末尾。
|
FlowElement — 由深复制操作创建的对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.elements.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;
public class FlowElement_deepCopyExample extends Sprite{
public function FlowElement_deepCopyExample()
{
// create a container and add it to the stage
var container:Sprite = new Sprite();
this.stage.addChild(container);
// create TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
// add text to the spans and spans to the paragraph
span1.text = "Hello, ";
span2.text = "World!";
p.fontSize = 48;
p.addChild(span1);
p.addChild(span2);
// make a deep copy of paragraph p, starting at relative offset 3; copy to end
var p2:ParagraphElement = p.deepCopy(3, -1) as ParagraphElement;
// add copied paragraph (p2) to textflow; add composer and controller
// and update controller to display text
textFlow.addChild(p2);
var controller:ContainerController = new ContainerController(container, 200, 200 );
textFlow.flowComposer.addController(controller);
textFlow.flowComposer.updateAllControllers(); // 'lo, World!'
}
}
}
equalUserStyles | () | 方法 |
public function equalUserStyles(otherElement:FlowElement):Boolean| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将此元素的 userStyles 与其它元素的 userStyles 比较。
参数
otherElement:FlowElement — 用以比较用户样式的 FlowElement 对象
|
Boolean — 如果用户样式是相等的,则为 true;否则为 false。
|
相关 API 元素
getAbsoluteStart | () | 方法 |
public function getAbsoluteStart():int| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回该元素在文本流中的起始位置(绝对索引)。流中的第一个字符位于位置 0。
返回int — 该元素起始位置相对于 TextFlow 对象起始位置的索引。
|
相关 API 元素
示例 ( 如何使用本示例 )
span2.getAbsoluteStart() 以获取 span2 的起始位置。
package flashx.textLayout.elements.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;
public class FlowElement_getAbsoluteStartExample extends Sprite
{
public function FlowElement_getAbsoluteStartExample()
{
// create a container and add it to the stage
var container:Sprite = new Sprite();
this.stage.addChild(container);
// create TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
// add text to the spans, spans to the paragraph, and paragraph to the text flow
span1.text = "The start of span2 ";
span2.text = "in this paragraph is at index: ";
p.fontSize = 20;
p.addChild(span1);
p.addChild(span2);
textFlow.addChild(p);
// find the starting position of span2 and update controller to display text
span2.text += span2.getAbsoluteStart(); // 19
var controller:ContainerController = new ContainerController(container, 200, 200 );
textFlow.flowComposer.addController(controller);
textFlow.flowComposer.updateAllControllers();
}
}
}
getCharAtPosition | () | 方法 |
public function getCharAtPosition(relativePosition:int):String| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回相对于该 FlowElement 对象的指定位置的字符。第一个字符位于相对位置 0。
参数
relativePosition:int — 该 FlowElement 对象中的字符的相对位置。
|
String — 包含该字符的字符串。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.elements.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;
public class FlowElement_getCharAtPositionExample extends Sprite
{
public function FlowElement_getCharAtPositionExample()
{
// create a container and a controller for it and add it to the stage
var container:Sprite = new Sprite();
var controller:ContainerController = new ContainerController( container, 400, 200 );
this.stage.addChild( container );
//create TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
// add text to the two spans, calling getCharAtPosition() to return the
// character at relative position 27 in the first span
span1.text = "The character at offset 27 in this paragraph is: ";
span2.text = span1.getCharAtPosition(27) + "."; // i
// add spans to paragraph p
p.addChild(span1);
p.addChild(span2);
// add paragraph p to text flow and update controller to display it
textFlow.addChild(p);
textFlow.flowComposer.addController( controller );
textFlow.flowComposer.updateAllControllers();
}
}
}
getCharCodeAtPosition | () | 方法 |
public function getCharCodeAtPosition(relativePosition:int):int| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回相对于该 FlowElement 对象的指定位置的字符代码。第一个字符位于相对位置 0。
参数
relativePosition:int — 该 FlowElement 对象中的字符的相对位置。
|
int — 位于指定位置的字符的 Unicode 值。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.elements.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;
public class FlowElement_getCharCodeAtPositionExample extends Sprite
{
public function FlowElement_getCharCodeAtPositionExample()
{
// create a container and a controller for it and add it to the stage
var container:Sprite = new Sprite();
var controller:ContainerController = new ContainerController( container, 400, 200 );
this.stage.addChild( container );
//create TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
// add text to spans; use getCharCodeAtPosition() to add char code from pos. 16
// of span1
span1.text = "The character code at offset 16 in this paragraph is: ";
span2.text = String(span1.getCharCodeAtPosition(16)) + "."; // 100 (d)
// add spans to paragraph p
p.addChild(span1);
p.addChild(span2);
// add paragraph p to text flow and update controller to display it
textFlow.addChild(p);
textFlow.flowComposer.addController( controller );
textFlow.flowComposer.updateAllControllers();
}
}
}
getElementRelativeStart | () | 方法 |
public function getElementRelativeStart(ancestorElement:FlowElement):int| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回该元素相对于祖代元素的起始位置。假定祖代元素位于父链中。如果祖代元素是父元素,则与 this.parentRelativeStart 相同。如果祖代元素是祖父元素,则与 parentRelativeStart 及 parent.parentRelativeStart 等相同。
参数
ancestorElement:FlowElement — 要查找该元素相对起始位置时对应的基准元素。
|
int — 该元素的偏移。
|
相关 API 元素
示例 ( 如何使用本示例 )
getElementRelativeStart() 来确定段落内链接的相对起始位置。
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.LinkElement;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowElement_getElementRelativeStartExample extends Sprite
{
public function FlowElement_getElementRelativeStartExample()
{
// create a container and a controller for it and add it to the stage
var container:Sprite = new Sprite();
var controller:ContainerController = new ContainerController( container, 400, 200 );
this.stage.addChild( container );
//create TextFlow, ParagraphElement, SpanElement, and LinkElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var link:LinkElement = new LinkElement();
var span2:SpanElement = new SpanElement();
var span3:SpanElement = new SpanElement();
// add text to first two spans
span1.text = "The relative start of the link SpanElement (";
span2.text = ") in this paragraph is at position ";
// create link span, add text and corresponding URL and add to link
var linkSpan:SpanElement = new SpanElement();
linkSpan.text = "Adobe's website";
link.href = "http://www.adobe.com";
link.addChild(linkSpan);
// add first span, link, and second span to paragraph p
p.addChild(span1);
p.addChild(link);
p.addChild(span2);
// call getElementRelativeStart() to get start of linkSpan and add to span 3
span3.text = String(linkSpan.getElementRelativeStart(p)) + "."; // 44.
p.addChild(span3);
// add paragraph p to text flow and update controller to display it
textFlow.addChild(p);
textFlow.flowComposer.addController( controller );
textFlow.flowComposer.updateAllControllers();
}
}
}
getNextSibling | () | 方法 |
public function getNextSibling():FlowElement| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回文本流层次结构中的下一个 FlowElement 同级对象。
返回FlowElement — 下一个同一类型的 FlowElement 对象,如果没有同级对象,则为 null。
|
相关 API 元素
示例 ( 如何使用本示例 )
span2.getNextSibling() 的结果设置为红色。
package flashx.textLayout.elements.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;
public class FlowElement_getNextSiblingExample extends Sprite
{
public function FlowElement_getNextSiblingExample()
{
// create a container and add it to the stage
var container:Sprite = new Sprite();
this.stage.addChild(container);
// create TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
var nextSpanElement:SpanElement = new SpanElement();
// add text, set font size, add spans to paragraph, add paragraph to text flow
span1.text = "Hello, ";
span2.text = "World!";
p.fontSize = 48;
p.addChild(span1);
p.addChild(span2);
textFlow.addChild(p);
// get next SpanElement for span1 and set its color to red; display text
nextSpanElement = SpanElement(span1.getNextSibling());
nextSpanElement.color = 0xCC0000;
textFlow.flowComposer.addController(new ContainerController(this,stage.stageWidth,stage.stageHeight));
textFlow.flowComposer.updateAllControllers();
}
}
}
getParagraph | () | 方法 |
public function getParagraph():ParagraphElement| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回与该元素关联的 ParagraphElement 对象。它查找文本流层次结构,并返回第一个 ParagraphElement 对象。
返回ParagraphElement — 与该 FlowElement 对象关联的 ParagraphElement 对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
getParagraph() 返回 LinkElement 对象的 ParagraphElement。
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.LinkElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowElement_getParagraphExample extends Sprite
{
public function FlowElement_getParagraphExample()
{
// create a container and a controller for it and add to the stage
var container:Sprite = new Sprite();
var controller:ContainerController = new ContainerController( container, 400, 200 );
this.stage.addChild( container );
//create TextFlow, ParagraphElement, SpanElement, and LinkElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var link:LinkElement = new LinkElement();
var span2:SpanElement = new SpanElement();
// add text to first span
span1.text = "Text that includes a link to ";
// create link span, add text and corresponding URL and add to link
var linkSpan:SpanElement = new SpanElement();
linkSpan.text = "Adobe's website";
link.href = "http://www.adobe.com";
link.addChild(linkSpan);
// add text to second span and add spans and link to paragraph p
span2.text = ". Notice that paragraph p2 is identical to paragraph p.";
p.addChild(span1);
p.addChild(link);
p.addChild(span2);
// call getParagraph() to retrieve paragaph for LinkElement
var p2:ParagraphElement = link.getParagraph();
// add paragraph p2 to the text flow and display it
textFlow.addChild(p2);
textFlow.flowComposer.addController( controller );
textFlow.flowComposer.updateAllControllers();
}
}
}
getPreviousSibling | () | 方法 |
public function getPreviousSibling():FlowElement| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回文本流层次结构中的上一个 FlowElement 同级对象。
返回FlowElement — 上一个同一类型的 FlowElement 对象,如果没有上一个同级对象,则为 null。
|
相关 API 元素
示例 ( 如何使用本示例 )
span2.getPreviousSibling() 的结果设置为红色。
package flashx.textLayout.elements.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;
public class FlowElement_getPreviousSiblingExample extends Sprite
{
public function FlowElement_getPreviousSiblingExample()
{
// create a container and add it to the stage
var container:Sprite = new Sprite();
this.stage.addChild(container);
// create TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
var prevSpanElement:SpanElement = new SpanElement();
// add text, set font size, add spans to paragraph, add paragraph to text flow
span1.text = "Hello, ";
span2.text = "World!";
p.fontSize = 48;
p.addChild(span1);
p.addChild(span2);
textFlow.addChild(p);
// get previous SpanElement for span2 and set its color to red; display text
prevSpanElement = SpanElement(span2.getPreviousSibling());
prevSpanElement.color = 0xCC0000;
textFlow.flowComposer.addController(new ContainerController(this,400,200));
textFlow.flowComposer.updateAllControllers();
}
}
}
getStyle | () | 方法 |
public function getStyle(styleProp:String):*| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
返回由 styleProp 参数指定的样式值,该参数指定样式名称,可以包括任何用户样式名称。访问现有跨距、段落、文本流或容器样式。如果对于某个特定元素,样式的值为 undefined,则搜索父级树。
参数
styleProp:String — 要检索其值的样式的名称。
|
* — 指定的样式的值。类型随正在访问的样式类型而异。如果未设置样式,则返回 undefined。
|
相关 API 元素
示例 ( 如何使用本示例 )
getStyle() 来确定是否将 lineThrough 样式应用到某个跨距。
package flashx.textLayout.elements.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;
public class FlowElement_getStyleExample extends Sprite
{
public function FlowElement_getStyleExample()
{
// create a container and a TextFlow object
var container:Sprite = new Sprite();
this.stage.addChild(container);
var textFlow:TextFlow = new TextFlow();
// create a paragraph and set lineThrough style to true
var paragraph:ParagraphElement = new ParagraphElement();
paragraph.setStyle("lineThrough", true);
// create two spans of text
var p1Span1:SpanElement = new SpanElement();
var p1Span2:SpanElement = new SpanElement();
p1Span1.text = "It was a dark and stormy night. ";
p1Span2.text = "The quick red fox jumped over the lazy brown dog.";
paragraph.addChild(p1Span1);
paragraph.addChild(p1Span2);
// call getStyle() for 1st span to see if lineThrough is on
if(p1Span1.getStyle("lineThrough") == true)
p1Span1.setStyle("lineThrough", false) // if so, turn it off for this span
textFlow.addChild(paragraph);
// add composer and controller, then update controller to display text
var controller:ContainerController = new ContainerController(container, 200, 200 );
textFlow.flowComposer.addController(controller);
textFlow.flowComposer.updateAllControllers();
}
}
}
getText | () | 方法 |
public function getText(relativeStart:int = 0, relativeEnd:int = -1, paragraphSeparator:String = " "):String| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
从流元素获取指定的文本范围。
参数
relativeStart:int (default = 0) — 要检索的文本范围的起始位置(相对于 FlowElement 的起始处)
| |
relativeEnd:int (default = -1) — 要检索的文本范围的结束位置(相对于 FlowElement 的起始处),从 -1 到元素的结尾
| |
paragraphSeparator:String (default = " ") — 放置在段落之间的字符
|
String — 请求的文本。
|
getTextFlow | () | 方法 |
public function getTextFlow():flashx.textLayout.elements:TextFlow| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
沿文本流层次结构向上移动,返回该元素的 TextFlow 根对象。
返回flashx.textLayout.elements:TextFlow — 该 FlowElement 对象的 TextFlow 根对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
getTextFlow() 和 LinkElement 对象返回其根 TextFlow。
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.LinkElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowElement_getTextFlowExample extends Sprite
{
public function FlowElement_getTextFlowExample()
{
// create a container and a controller for it and add to the stage
var container:Sprite = new Sprite();
var controller:ContainerController = new ContainerController(container, 400, 200);
this.stage.addChild( container );
//create TextFlow, ParagraphElement, SpanElement, and LinkElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var link:LinkElement = new LinkElement();
var span2:SpanElement = new SpanElement();
// add text to first span
span1.text = "Text that includes a link to ";
// create link span, add text and corresponding URL and add to link
var linkSpan:SpanElement = new SpanElement();
linkSpan.text = "Adobe's website";
link.href = "http://www.adobe.com";
link.addChild(linkSpan);
// add text to second span, add spans and link to paragraph p, and
// add paragraph p to textFlow
span2.text = ". Notice that textFlow2 is identical to textFlow.";
p.addChild(span1);
p.addChild(link);
p.addChild(span2);
textFlow.addChild(p);
// use getTextFlow() with LinkElement to return its TextFlow; update controller
// and display it
var textFlow2:TextFlow = link.getTextFlow();
textFlow2.flowComposer.addController( controller );
textFlow2.flowComposer.updateAllControllers();
}
}
}
initialized | () | 方法 |
setStyle | () | 方法 |
public function setStyle(styleProp:String, newValue:*):void| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
将 styleProp 参数指定的样式设置为 newValue 参数指定的值。您可以设置跨距、段落、文本流或容器样式,包括任何用户名称/值对。
注意:如果指定自定义样式,Text Layout Framework 可以导入和导出此样式,但是编译的 MXML 不能支持该样式。
参数
styleProp:String — 要设置的样式的名称。
| |
newValue:* — 要为样式设置的值。
|
相关 API 元素
示例 ( 如何使用本示例 )
setStyle() 来设置跨距上的颜色,并将文本流的字体样式设置为斜体。
package flashx.textLayout.elements.examples {
import flash.display.Sprite;
import flash.text.engine.FontPosture;
import flashx.textLayout.container.ContainerController;
import flashx.textLayout.elements.ParagraphElement;
import flashx.textLayout.elements.SpanElement;
import flashx.textLayout.elements.TextFlow;
public class FlowElement_setStyleExample extends Sprite
{
public function FlowElement_setStyleExample()
{
// create a container and a controller for it and add it to the stage
var container:Sprite = new Sprite();
var controller:ContainerController = new ContainerController( container, 400, 200 );
this.stage.addChild( container );
// create TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
// add text to the spans
span1.text = "Hello, ";
span2.text = "World!";
// set the color style for span2 and add spans to paragraph p
span2.setStyle("color", 0xCC0000);
p.addChild(span1);
p.addChild(span2);
// add paragraph to text flow, set fontStyle for the text flow to italic,
// and update controller to display the paragraph
textFlow.addChild(p);
textFlow.setStyle("fontStyle", FontPosture.ITALIC);
textFlow.flowComposer.addController( controller );
textFlow.flowComposer.updateAllControllers();
}
}
}
shallowCopy | () | 方法 |
public function shallowCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
生成此 FlowElement 对象的副本,复制两个指定的字符位置之间的内容。它将该副本作为一个新 FlowElement 对象返回。与 deepCopy() 不同,shallowCopy() 不复制该 FlowElement 对象的任何子对象。
如果不使用任何参数,则默认情况下 shallowCopy() 复制所有内容。
参数
relativeStart:int (default = 0) — 要复制的第一个字符的相对文本位置。第一个位置为 0。
| |
relativeEnd:int (default = -1) — 要复制的最后一个字符的相对文本位置。值为 -1 表示复制到末尾。
|
FlowElement — 由该复制操作创建的对象。
|
相关 API 元素
示例 ( 如何使用本示例 )
package flashx.textLayout.elements.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;
public class FlowElement_shallowCopyExample extends Sprite
{
public function FlowElement_shallowCopyExample()
{
// create a container and add it to the stage
var container:Sprite = new Sprite();
this.stage.addChild(container);
// create TextFlow, ParagraphElement, and SpanElement objects
var textFlow:TextFlow = new TextFlow();
var p:ParagraphElement = new ParagraphElement();
var span1:SpanElement = new SpanElement();
var span2:SpanElement = new SpanElement();
var span3:SpanElement = new SpanElement();
// add text to the spans, spans to the paragraph
span1.text = "paragraph2 has ";
span3.text = " children, so it would display nothing."
p.fontSize = 20;
p.addChild(span1);
p.addChild(span2);
p.addChild(span3);
// create paragraph p2 as a shallow copy of paragraph p
var p2:ParagraphElement = p.shallowCopy(3, -1) as ParagraphElement;
// add the number of children that p2 has to span2 for paragraph p
span2.text += p2.numChildren; // 0
// add paragraph p to textFlow and update controller to display it
textFlow.addChild(p);
var controller:ContainerController = new ContainerController(container, 200, 200 );
textFlow.flowComposer.addController(controller);
textFlow.flowComposer.updateAllControllers();
}
}
}
splitAtPosition | () | 方法 |
public function splitAtPosition(relativePosition:int):FlowElement| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
在由 relativePosition 参数指定的位置处拆分此 FlowElement 对象,该位置是此元素的文本中的相对位置。此方法仅拆分 SpanElement 和 FlowGroupElement 对象。
参数
relativePosition:int — 拆分原始对象的内容的位置,第一个位置为 0。
|
FlowElement — 新对象,它包含原始对象的内容,且在指定的位置处开始。
|
引发
RangeError — 如果 relativePosition 大于 textLength 或小于 0。
|
Tue Jun 12 2018, 11:04 AM Z
隐藏继承的公共属性
显示继承的公共属性