| 包 | flashx.textLayout.elements |
| 类 | public class SpanElement |
| 继承 | SpanElement  FlowLeafElement FlowElement Object |
| 子类 | SpecialCharacterElement |
| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
如果段落中所有文本共享相同的属性集，则 ParagraphElement 将含有单个 SpanElement 对象。如果段落中的文本具有多种格式，则会含有多个 SpanElement 对象。
默认 MXML 属性mxmlChildren
相关 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 [覆盖] [只读]
对于该元素有效的计算得出的文本格式属性。 | FlowLeafElement | |
| 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 | |
| mxmlChildren : Array
根据跨距标签内的内容设置文本；始终删除现有子项。 | SpanElement | ||
| 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 | |
| text : String
接受该 SpanElement 对象包含的文本字符串。 | SpanElement | ||
| 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 | |
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构造函数 - 创建一个 SpanElement 对象，包含段落中的一串文本。 | SpanElement | ||
| 从该 FlowElement 对象清除 styleProp 参数指定的样式。 | FlowElement | |
|
生成此 FlowElement 对象的深层副本，包括任何子对象，在两个指定的字符位置之间复制内容，并将该副本作为 FlowElement 对象返回。 | FlowElement | |
| 将此元素的 userStyles 与其它元素的 userStyles 比较。 | FlowElement | |
|
返回该元素在文本流中的起始位置（绝对索引）。 | FlowElement | |
|
返回相对于该 FlowElement 对象的指定位置的字符。 | FlowElement | |
| 返回相对于该 FlowElement 对象的指定位置的字符代码。 | FlowElement | |
| 返回跨距的 FontMetrics 对象。 | FlowLeafElement | |
|
返回该元素相对于祖代元素的起始位置。 | FlowElement | |
|
返回下一个 FlowLeafElement 对象。 | FlowLeafElement | |
| 返回文本流层次结构中的下一个 FlowElement 同级对象。 | FlowElement | |
|
返回与该元素关联的 ParagraphElement 对象。 | FlowElement | |
|
返回上一个 FlowLeafElement 对象。 | FlowLeafElement | |
| 返回文本流层次结构中的上一个 FlowElement 同级对象。 | FlowElement | |
| 返回由 styleProp 参数指定的样式值，该参数指定样式名称，可以包括任何用户样式名称。 | FlowElement | |
|
从流元素获取指定的文本范围。 | FlowElement | |
|
沿文本流层次结构向上移动，返回该元素的 TextFlow 根对象。 | FlowElement | |
|
表示对象是否已经定义了指定的属性。 | Object | |
| 创建实现对象且初始化在 MXML 标签上指定的所有组件属性后针对 MXML 对象进行调用。 | FlowElement | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
根据指定起始和结束位置更新文本跨距中的文本。 | SpanElement | ||
|
设置循环操作动态属性的可用性。 | Object | |
| 将 styleProp 参数指定的样式设置为 newValue 参数指定的值。 | FlowElement | |
|
生成此 FlowElement 对象的副本，复制两个指定的字符位置之间的内容。 | FlowElement | |
|
在由 relativePosition 参数指定的位置处拆分此 FlowElement 对象，该位置是此元素的文本中的相对位置。 | FlowElement | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
|
返回指定对象的原始值。 | Object | |
属性详细信息
mxmlChildren | 属性 |
mxmlChildren:Array| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
根据跨距标签内的内容设置文本；始终删除现有子项。此属性旨在用于在 Flex 的 MXML 编译导入过程中。Flash Professional 忽略了此属性。TLF 标记元素以其他 TLF 标记元素作为子元素时，这些子元素被指定给该属性。
实现
public function get mxmlChildren():Array public function set mxmlChildren(value:Array):void引发
TypeError — 如果数组元素不是 SpecialCharacterElement 或 String。
|
text | 属性 |
构造函数详细信息
SpanElement | () | 构造函数 |
public function SpanElement()| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
构造函数 - 创建一个 SpanElement 对象，包含段落中的一串文本。
方法详细信息
replaceText | () | 方法 |
public function replaceText(relativeStartPosition:int, relativeEndPosition:int, textValue:String):void| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
根据指定起始和结束位置更新文本跨距中的文本。要插入文本，请将结束位置与起始位置设置为相同的值。要向跨距中的现有文本追加文本，请将起始位置和结束位置设置为现有文本的长度值。
替换的文本包括起始字符和结束字符之前的字符。
参数
relativeStartPosition:int — 要替换的文本开头的索引位置，相对于跨距的起始位置。跨距中的第一个字符位于位置 0。
| |
relativeEndPosition:int — 要替换的文本末尾字符的索引位置，相对于跨距的起始位置。将该值设置为 relativeStartPos 可进行插入。
| |
textValue:String — 替换文本或要添加的文本，取决于具体情况。
|
引发
RangeError — 指定的 relativeStartPosition 或 relativeEndPosition 超出范围，或由于替换而导致代理对被拆分。
|
示例 ( 如何使用本示例 )
此示例多次调用 replaceText() 以执行下列操作：在文本的开头插入一个字符串；在文本的结尾追加一个字符串；在文本的中间插入一个字符串；使用一个新字符串整个替换文本。
该示例使用另一个跨距 (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 SpanElement_replaceTextExample extends Sprite
{
public function SpanElement_replaceTextExample()
{
// create 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 paragraph:ParagraphElement = new ParagraphElement();
var span:SpanElement = new SpanElement;
var span2:SpanElement = new SpanElement;
// add composer and container controller
var controller:ContainerController = new ContainerController(container, 200, 700 );
textFlow.flowComposer.addController(controller);
textFlow.fontSize = 24; // set font size
// create text string and add it to the span
var str:String = "0123456";
span.text = str;
// insert at the beginning
span.replaceText(0, 0, "abc");
span2.text = span.text + '\n';
// append to the end of the text
span.replaceText(10, 10, "abc");
span2.text += span.text + '\n';
// insert string in the middle of the text
span.replaceText(5, 8, "abc");
span2.text += span.text + '\n';
// replace text with string
span.replaceText(0, 13, "abc");
span2.text += span.text + '\n';
// replace text with string
span.replaceText(0, 3, "That's all she wrote!\n");
span2.text += span.text + '\n';
// display the results
paragraph.addChild(span2);
textFlow.addChild(paragraph);
textFlow.flowComposer.updateAllControllers();
}
}
}
示例 如何使用本示例
SpanElementExample.as
此示例使用具有不同样式的两个 SpanElement 对象显示 Hello World。
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 SpanElementExample extends Sprite
{
public function SpanElementExample()
{
// 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 spanHello:SpanElement = new SpanElement();
var spanWorld:SpanElement = new SpanElement();
// add text and styles to the spans
spanHello.text = "Hello, ";
spanHello.fontSize = 48;
spanWorld.text = "World!";
spanWorld.fontSize = 56;
spanWorld.fontStyle = FontPosture.ITALIC;
spanWorld.color = 0xFFCC00;
// add spans to paragraph, paragraph to text flow
p.addChild(spanHello);
p.addChild(spanWorld);
textFlow.addChild(p);
// update controller to display text
var controller:ContainerController = new ContainerController(container, 400, 200 );
textFlow.flowComposer.addController(controller);
textFlow.flowComposer.updateAllControllers();
}
}
}
Tue Jun 12 2018, 11:04 AM Z