ParagraphElement

包	flashx.textLayout.elements
类	public final class ParagraphElement
继承	ParagraphElement ParagraphFormattedElement FlowGroupElement FlowElement Object

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

ParagraphElement 类表示文本流层次结构中的一个段落。其父项是 ParagraphFormattedElement，其子项可以包括跨距 (SpanElement)、图像 (inLineGraphicElement)、链接 (LinkElement) 和 TCY (Tatechuuyoko - ta-tae-chu-yo-ko) 元素 (TCYElement)。段落文本存储在一个或多个 SpanElement 对象中，这些对象定义共享相同属性的文本范围。TCYElement 对象定义一小串与行垂直的日语文本，类似于垂直行中的一串水平文本。一个 TCYElement 也可以包含多个跨距。

默认 MXML 属性mxmlChildren

查看示例

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		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
		mxmlChildren : Array 为该对象追加一个子对象数组。	FlowGroupElement
		numChildren : int [只读] 返回该 FlowGroupElement 对象具有的 FlowElement 子对象的数目。	FlowGroupElement
		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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		ParagraphElement() 构造函数 - 表示文本流中的一个段落。	ParagraphElement
		addChild(child:FlowElement):FlowElement 追加一个 FlowElement 子对象。	FlowGroupElement
		addChildAt(index:uint, child:FlowElement):FlowElement 在指定索引位置添加一个 FlowElement 子对象。	FlowGroupElement
		clearStyle(styleProp:String):void 从该 FlowElement 对象清除 styleProp 参数指定的样式。	FlowElement
		deepCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement 生成此 FlowElement 对象的深层副本，包括任何子对象，在两个指定的字符位置之间复制内容，并将该副本作为 FlowElement 对象返回。	FlowElement
		equalUserStyles(otherElement:FlowElement):Boolean 将此元素的 userStyles 与其它元素的 userStyles 比较。	FlowElement
		findChildIndexAtPosition(relativePosition:int):int 对于给定的相对文本位置，查找包含该相对位置的第一个 FlowElement 子对象的索引。	FlowGroupElement
		findLeaf(relativePosition:int):FlowLeafElement 对于给定的相对文本位置，查找包含该位置的叶元素。	FlowGroupElement
		findNextAtomBoundary(relativePosition:int):int 从提供的位置向前扫描，以找到文本中下一个原子的位置并返回索引。	ParagraphElement
		findNextWordBoundary(relativePosition:int):int 返回文本中下一个单词边界的索引。	ParagraphElement
		findPreviousAtomBoundary(relativePosition:int):int 从提供的位置向后扫描，以找到文本中上一个原子的位置并返回索引。	ParagraphElement
		findPreviousWordBoundary(relativePosition:int):int 返回文本中上一个单词边界的索引。	ParagraphElement
		getAbsoluteStart():int 返回该元素在文本流中的起始位置（绝对索引）。	FlowElement
		getCharAtPosition(relativePosition:int):String 返回相对于该 FlowElement 对象的指定位置的字符。	FlowElement
		getCharCodeAtPosition(relativePosition:int):int 返回相对于该 FlowElement 对象的指定位置的字符代码。	FlowElement
		getChildAt(index:int):FlowElement 返回位于指定索引的 FlowElement 子对象。	FlowGroupElement
		getChildIndex(child:FlowElement):int 在子对象中搜索指定的 FlowElement 对象，并返回其索引位置。	FlowGroupElement
		getElementRelativeStart(ancestorElement:FlowElement):int 返回该元素相对于祖代元素的起始位置。	FlowElement
		getFirstLeaf():FlowLeafElement 返回该组的第一个 FlowLeafElement 子项。	FlowGroupElement
		getLastLeaf():FlowLeafElement 返回该组的最后一个 FlowLeafElement 子项。	FlowGroupElement
		getNextParagraph():ParagraphElement 返回该段落之后的段落，如果不再有段落则返回 null。	ParagraphElement
		getNextSibling():FlowElement 返回文本流层次结构中的下一个 FlowElement 同级对象。	FlowElement
		getParagraph():ParagraphElement 返回与该元素关联的 ParagraphElement 对象。	FlowElement
		getPreviousParagraph():ParagraphElement 返回该段落之前的段落，如果该段落是 TextFlow 中的第一个段落，则返回 null。	ParagraphElement
		getPreviousSibling():FlowElement 返回文本流层次结构中的上一个 FlowElement 同级对象。	FlowElement
		getStyle(styleProp:String):* 返回由 styleProp 参数指定的样式值，该参数指定样式名称，可以包括任何用户样式名称。	FlowElement
		getText(relativeStart:int = 0, relativeEnd:int = -1, paragraphSeparator:String = " "):String [覆盖]	FlowGroupElement
		getTextFlow():flashx.textLayout.elements:TextFlow 沿文本流层次结构向上移动，返回该元素的 TextFlow 根对象。	FlowElement
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		initialized(document:Object, id:String):void 创建实现对象且初始化在 MXML 标签上指定的所有组件属性后针对 MXML 对象进行调用。	FlowElement
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeChild(child:FlowElement):FlowElement 从组中删除指定的 FlowElement 子对象。	FlowGroupElement
		removeChildAt(index:uint):FlowElement 删除位于指定索引位置的 FlowElement 子对象。	FlowGroupElement
		replaceChildren(beginChildIndex:int, endChildIndex:int, ... rest):void 以指定的新元素替换组中的子元素。	FlowGroupElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setStyle(styleProp:String, newValue:*):void 将 styleProp 参数指定的样式设置为 newValue 参数指定的值。	FlowElement
		shallowCopy(relativeStart:int = 0, relativeEnd:int = -1):FlowElement 生成此 FlowElement 对象的副本，复制两个指定的字符位置之间的内容。	FlowElement
		splitAtIndex(childIndex:int):FlowGroupElement 在 childIndex 参数指定的位置拆分该对象。	FlowGroupElement
		splitAtPosition(relativePosition:int):FlowElement 在由 relativePosition 参数指定的位置处拆分此 FlowElement 对象，该位置是此元素的文本中的相对位置。	FlowElement
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object

构造函数详细信息

()

构造函数

public function ParagraphElement()

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

构造函数 - 表示文本流中的一个段落。

方法详细信息

findNextAtomBoundary

()

方法

public function findNextAtomBoundary(relativePosition:int):int

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

从提供的位置向前扫描，以找到文本中下一个原子的位置并返回索引。术语“atom”既可指图形元素，也可表示字符（包括由字符合并起来的组合），是组成文本行的不可分割的实体。

参数

relativePosition:int — 文本中的起始位置，从 0 开始计算

int — 文本中下一个原子的索引

相关 API 元素

flash.text.engine.TextLine

示例 ( 如何使用本示例 )

此示例从给定偏移处查找段落中的下一个原子边界。

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 ParagraphElement_findNextAtomBoundary  extends Sprite
    {
        public function ParagraphElement_findNextAtomBoundary()
        {
            // create the TextFlow, ParagraphElement and SpanElement objects to hold paragraph
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();    
            var span:SpanElement = new SpanElement();
            // assign text to the span; add span to paragraph and paragraph to TextFlow
            span.text = "Hello brave, new world!";
            paragraph.addChild(span);
            textFlow.addChild(paragraph);
            // assign a controller to the stage and update it to compose and display text
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // find the next atom boundaries from offsets 5 and 10
            var atomBoundary:int = paragraph.findNextAtomBoundary(4);                           
            trace(atomBoundary); // 5 
            atomBoundary = paragraph.findNextAtomBoundary(10);                           
            trace(atomBoundary); // 11  
        }
    }
}

findNextWordBoundary

()

方法

public function findNextWordBoundary(relativePosition:int):int

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

返回文本中下一个单词边界的索引。

从提供的位置向前扫描，以找到文本中以一个单词开始或结束的下一个位置。

参数

relativePosition:int — 文本中的起始位置，从 0 开始计算

int — 文本中下一个单词边界的索引

示例 ( 如何使用本示例 )

此示例从给定偏移处查找段落中的下一个单词边界。

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 ParagraphElement_findNextWordBoundary  extends Sprite
    {
        public function ParagraphElement_findNextWordBoundary()
        {
            // create the TextFlow, ParagraphElement and SpanElement objects to hold paragraph
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();    
            var span:SpanElement = new SpanElement();
            // assign text to the span; add span to paragraph and paragraph to TextFlow
            span.text = "Hello brave, new world!";
            paragraph.addChild(span);
            textFlow.addChild(paragraph);
            // assign a controller to the stage and update it to compose and display text
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // find the next word boundary from offsets 0 and 12
            var wordBoundary:int = paragraph.findNextWordBoundary(0);                           
            trace(wordBoundary); // 5 
            wordBoundary = paragraph.findNextWordBoundary(12);                           
            trace(wordBoundary); // 13        
        }
    }
}

findPreviousAtomBoundary

()

方法

public function findPreviousAtomBoundary(relativePosition:int):int

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

从提供的位置向后扫描，以找到文本中上一个原子的位置并返回索引。术语“atom”既可指图形元素，也可表示字符（包括由字符合并起来的组合），是组成文本行的不可分割的实体。

参数

relativePosition:int — 文本中的起始位置，从 0 开始计算

int — 文本中上一个簇的索引

相关 API 元素

flash.text.engine.TextLine

示例 ( 如何使用本示例 )

此示例从给定偏移处查找段落中的上一个原子边界。

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 ParagraphElement_findPreviousAtomBoundary  extends Sprite
    {
        public function ParagraphElement_findPreviousAtomBoundary()
        {
            // create the TextFlow, ParagraphElement and SpanElement objects to hold paragraph
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();    
            var span:SpanElement = new SpanElement();
            // assign text to the span; add span to paragraph and paragraph to TextFlow
            span.text = "Hello brave, new world!";
            paragraph.addChild(span);
            textFlow.addChild(paragraph);
            // assign a controller to the stage and update it to compose and display text
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // find the previous atom boundaries from offsets 6 and 13
            var atomBoundary:int = paragraph.findPreviousAtomBoundary(6);                           
            trace(atomBoundary); // 5 
            atomBoundary = paragraph.findPreviousAtomBoundary(13);                           
            trace(atomBoundary); // 12      
        }
    }
}

findPreviousWordBoundary

()

方法

public function findPreviousWordBoundary(relativePosition:int):int

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

返回文本中上一个单词边界的索引。

从提供的位置向后扫描，以找到文本中以一个单词开始或结束的上一个位置。

参数

relativePosition:int — 文本中的起始位置，从 0 开始计算

int — 文本中上一个单词边界的索引

示例 ( 如何使用本示例 )

此示例从给定偏移处查找段落中的上一个单词边界。

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 ParagraphElement_findPreviousWordBoundary  extends Sprite
    {
        public function ParagraphElement_findPreviousWordBoundary()
        {
            // create the TextFlow, ParagraphElement and SpanElement objects to hold paragraph
            var textFlow:TextFlow = new TextFlow();
            var paragraph:ParagraphElement = new ParagraphElement();    
            var span:SpanElement = new SpanElement();
            // assign text to the span; add span to paragraph and paragraph to TextFlow
            span.text = "Hello brave, new world!";
            paragraph.addChild(span);
            textFlow.addChild(paragraph);
            // assign a controller to the stage and update it to compose and display text
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // find the previous word boundary from offsets 0 and 12
            var wordBoundary:int = paragraph.findPreviousWordBoundary(22);                           
            trace(wordBoundary); // 17 
            wordBoundary = paragraph.findPreviousWordBoundary(11);                           
            trace(wordBoundary); // 6  
        }
    }
}

getNextParagraph

()

方法

public function getNextParagraph():ParagraphElement

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

返回该段落之后的段落，如果不再有段落则返回 null。

ParagraphElement — 下一个段落，如果不再有段落则返回 null。

相关 API 元素

getPreviousParagraph()

示例 ( 如何使用本示例 )

此示例从 xml 标记导入三个文本段落，使用 getChildAtIndex(0) 访问第一个段落，并使用 getNextParagraph() 访问第二个段落。

package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class ParagraphElement_getNextParagraph  extends Sprite
    {
        public function ParagraphElement_getNextParagraph()
        {
            // create TextFlow object
            var textFlow:TextFlow = new TextFlow();        
            // create content for TextFlow using XML markup
            var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
                "<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\">"+
                    "<flow:p>"+
                        "<flow:span>This is the first paragraph.</flow:span>"+    
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>This is the second paragraph.</flow:span>"+    
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>This is the third paragraph.</flow:span>"+ 
                    "</flow:p>"+
                "</flow:TextFlow>";
            // import the xml markup into a TextFlow object and display it on the stage
            textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // get first paragraph
            var p:ParagraphElement = textFlow.getChildAt(0) as ParagraphElement;
            // get next paragraph and display its content
            var nextParagraph:ParagraphElement = p.getNextParagraph();
            trace("nextParagraph.text is: " + nextParagraph.getText());
        }
    }
}

getPreviousParagraph

()

方法

public function getPreviousParagraph():ParagraphElement

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

返回该段落之前的段落，如果该段落是 TextFlow 中的第一个段落，则返回 null。

ParagraphElement

相关 API 元素

getNextParagraph()

示例 ( 如何使用本示例 )

此示例从 xml 标记导入三个文本段落，使用 getChildAtIndex(1) 访问第二个段落，并使用 getPreviousParagraph() 访问第一个段落。

package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.container.ContainerController;
    import flashx.textLayout.elements.ParagraphElement;
    import flashx.textLayout.elements.SpanElement;
    import flashx.textLayout.elements.TextFlow;
    
    public class ParagraphElement_getPreviousParagraph  extends Sprite
    {
        public function ParagraphElement_getPreviousParagraph()
        {
            // create TextFlow object
            var textFlow:TextFlow = new TextFlow();        
            // create content for TextFlow using XML markup
            var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
                "<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\">"+
                    "<flow:p>"+
                        "<flow:span>This is the first paragraph.</flow:span>"+    
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>This is the second paragraph.</flow:span>"+    
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>This is the third paragraph.</flow:span>"+ 
                    "</flow:p>"+
                "</flow:TextFlow>";
            // import the xml markup into a TextFlow object and display it on the stage
            textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
            // get second paragraph (first = 0)
            var p:ParagraphElement = textFlow.getChildAt(1) as ParagraphElement;
            // get  previous paragraph and display its content
            var prevParagraph:ParagraphElement = p.getPreviousParagraph();
            trace("prevParagraph.text is: " + prevParagraph.getText());
        }
    }
}

示例如何使用本示例

ParagraphElementExample.as

此示例创建三个文本段落并设置其格式。

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;
    import flashx.textLayout.formats.TextLayoutFormat;

    public class ParagraphElementExample extends Sprite {
        
        // create the TextFlow object
        private var textFlow:TextFlow = new TextFlow();
        
        // Create Strings of text for the paragraphs
        private var para1String:String = "In the first paragraph of a "
        private var para1String2:String = "cheap" 
        private var para1String3:String ="Western novel, a cowboy meets a saloon girl.";
        private var para2String:String = "In the middle of the cheap novel a really bad guy, "+
                        "who is having a relationship with the saloon girl, sees the cowboy help "+
                        "her onto her horse as she smiles at him warmly."
        private var para3String:String = "In the last paragraph of the cheap novel, the cowboy kills "+
                            "the really bad guy in a shootout in the middle of main street and "+ 
                            "then rides into the sunset with the saloon girl on the back of his horse."; 
                  
        public function ParagraphElementExample()
        {
            // create a TextLayoutFormat object to use in formatting the paragraphs
            var textLayoutFormat:TextLayoutFormat = new TextLayoutFormat();
            var paragraph1:ParagraphElement = new ParagraphElement();
            
            // create the ParagraphElement objects
            var paragraph2:ParagraphElement = new ParagraphElement();
            var paragraph3:ParagraphElement = new ParagraphElement();
            
            // create the SpanElement objects to hold the content of the paragraphs
            var p1Span1:SpanElement = new SpanElement();
            var p1Span2:SpanElement = new SpanElement();
            var p1Span3:SpanElement = new SpanElement();
            var p2Span:SpanElement = new SpanElement();
            var p3Span:SpanElement = new SpanElement();
            
            // assign the strings of text for the 1st paragraph to spans
            p1Span1.text = para1String;
            p1Span2.text = para1String2;
            p1Span2.fontStyle = FontPosture.ITALIC;  // italicize 'cheap'
            p1Span3.text = para1String3;
            
            // add spans to first paragraph
            paragraph1.addChild(p1Span1);
            paragraph1.addChild(p1Span2);
            paragraph1.addChild(p1Span3);
            
            // assign the string of text for the 2nd paragraph to a span
            // and add the span to the second paragraph
            p2Span.text = para2String;
            paragraph2.addChild(p2Span);
            
            // assign the string of text for the 3rd paragraph to a span
            // and add the span to the third paragraph
            p3Span.text = para3String;
            paragraph3.addChild(p3Span);
            
            // add the paragraphs to the TextFlow
            textFlow.addChild(paragraph1);
            textFlow.addChild(paragraph2);
            textFlow.addChild(paragraph3);
            
            // set the text formatting properties
            textLayoutFormat.fontSize = 14;
            textLayoutFormat.textIndent = 15;
            textLayoutFormat.paragraphSpaceAfter = 15;
            textLayoutFormat.paddingTop = 4;
            textLayoutFormat.paddingLeft = 4;
            
            // assign the format object to the TextFlow
            textFlow.hostFormat = textLayoutFormat;
            
            // assign a controller to the stage and update it to compose and 
            // display the text
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

ParagraphElementExample2.as

此示例将 xml 标记导入到 TextFlow 对象中。xml 标记定义与前一个示例相同的三个文本段落及其格式。

package flashx.textLayout.elements.examples
{
    import flash.display.Sprite;
    import flashx.textLayout.elements.TextFlow;
    import flashx.textLayout.conversion.TextConverter;
    import flashx.textLayout.container.ContainerController;
    
    public class ParagraphElementExample2 extends Sprite {
        
        // create the TextFlow object
        private var textFlow:TextFlow = new TextFlow();
        
        // xml markup that defines the attributes and contents of a text flow
        private var simpleText:String = "<?xml version=\"1.0\" encoding=\"utf-8\"?>" +
                "<flow:TextFlow xmlns:flow=\"http://ns.adobe.com/textLayout/2008\" verticalScrollPolicy=\"auto\" horizontalScrollPolicy=\"auto\" editingMode=\"readWrite\" fontSize=\"14\" textIndent=\"15\" marginBottom=\"15\" paddingTop=\"4\" paddingLeft=\"4\">"+
                    "<flow:p>"+
                        "<flow:span>In the first paragraph of a </flow:span>"+
                        "<flow:span fontStyle=\"italic\">cheap</flow:span>"+
                        "<flow:span> Western novel, a cowboy meets a saloon girl.</flow:span>"+
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>In the middle of the cheap novel a really bad guy, </flow:span>"+
                        "<flow:span>who is having a relationship with the saloon girl, sees the cowboy help </flow:span>"+
                        "<flow:span>her onto her horse as she smiles at him warmly.</flow:span>"+ 
                    "</flow:p>"+
                    "<flow:p>"+
                        "<flow:span>In the last paragraph of the cheap novel, the cowboy kills the really </flow:span>"+ 
                        "<flow:span> bad guy in a shootout in the middle of main street and then rides into the sunset with </flow:span>"+
                        "<flow:span>the saloon girl on the back of his horse.</flow:span>" + 
                    "</flow:p>"+
                  "</flow:TextFlow>";
                  
        public function ParagraphElementExample2()
        {
            // import the xml markup into a TextFlow object and display it on the stage
            textFlow = TextConverter.importToFlow(simpleText, TextConverter.TEXT_LAYOUT_FORMAT);
            textFlow.flowComposer.addController(new ContainerController(this, 200, 400));
            textFlow.flowComposer.updateAllControllers();
        }
    }
}

法律声明 | 在线隐私策略

ParagraphElement - AS3

包x

语言元素

附录

包 flashx.textLayout.elements