GraphicElement

包	flash.text.engine
类	public final class GraphicElement
继承	GraphicElement ContentElement Object

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5, Flash Lite 4

GraphicElement 类表示 TextBlock 或 GroupElement 对象中的图形元素。将 GraphicElement 对象分配给 TextBlock 对象的 content 属性，以使用 TextBlock.createTextLine() 显示图形或图像。将其分配给 GroupElement 对象以将其与其他图形和文本元素相结合。

查看示例

相关 API 元素

ContentElement
GroupElement
TextBlock

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		elementFormat : ElementFormat 用于元素的 ElementFormat 对象。	ContentElement
		elementHeight : Number 要为行中的图形保留的高度，以像素为单位。	GraphicElement
		elementWidth : Number 要为行中的图形保留的宽度，以像素为单位。	GraphicElement
		eventMirror : EventDispatcher EventDispatcher 对象，该对象将接收调度到基于此内容元素的有效文本行的每个事件的副本。	ContentElement
		graphic : DisplayObject 要用作 GraphicElement 的图形的 DisplayObject。	GraphicElement
		groupElement : GroupElement [只读] 包含此元素的 GroupElement 对象；如果此元素不在一个组中，则为 null。	ContentElement
		rawText : String [只读] 元素中文本的副本，包括任何 U+FDEF 字符。	ContentElement
		text : String [只读] 元素中文本的副本，不包括任何表示字符串中图形元素的 U+FDEF 字符。	ContentElement
		textBlock : flash.text.engine:TextBlock [只读] 此元素所属的 TextBlock。	ContentElement
		textBlockBeginIndex : int [只读] 文本块中此元素的第一个字符的索引。	ContentElement
		textRotation : String 应用于元素的旋转（旋转时将元素作为一个单元）。	ContentElement
		userData : * 为应用程序提供一种将任意数据与元素相关联的方法。	ContentElement

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		GraphicElement(graphic:DisplayObject = null, elementWidth:Number = 15.0, elementHeight:Number = 15.0, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0") 创建新的 GraphicElement 实例。	GraphicElement
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object

公共常量

隐藏继承的公共常量

显示继承的公共常量

	常量		由以下参数定义

属性详细信息

elementHeight

属性

elementHeight:Number

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5, Flash Lite 4

要为行中的图形保留的高度，以像素为单位。调用方负责缩放图形。

默认值为 15.0。

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

elementWidth

属性

elementWidth:Number

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5, Flash Lite 4

要为行中的图形保留的宽度，以像素为单位。调用方负责缩放图形。

默认值为 15.0。

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

graphic

属性

graphic:DisplayObject

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5, Flash Lite 4

要用作 GraphicElement 的图形的 DisplayObject。

默认值为 null。

当 GraphicElement 成为文本行的一部分时，会将该图形添加为行的子项。如果设置图形，则将从行中删除旧图形并添加新图形。

实现
public function get graphic():DisplayObject
public function set graphic(value:DisplayObject):void

构造函数详细信息

()

构造函数

public function GraphicElement(graphic:DisplayObject = null, elementWidth:Number = 15.0, elementHeight:Number = 15.0, elementFormat:ElementFormat = null, eventMirror:EventDispatcher = null, textRotation:String = "rotate0")

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5, Flash Lite 4

创建新的 GraphicElement 实例。

图形的注册点与 elementHeight、elementWidth 和 elementFormat.baselineShift 所定义的区域的左上角对齐。将不会为了与区域大小相匹配而缩放图形。如果 GraphicElement 具有 eventMirror、elementWidth 和 elementHeight 属性，但是没有图形，则可以确定生成的镜像区域的大小和位置。如果使用加载程序，则可能不会在创建文本行和镜像区域时加载图形。

参数

	`graphic:DisplayObject` (default = `null`) — 要填充 GraphicElement 的 DisplayObject。默认值为 `null`。

	`elementWidth:Number` (default = `15.0`) — 为元素保留的区域的宽度，以像素为单位。默认值为 15。

	`elementHeight:Number` (default = `15.0`) — 为元素保留的区域的高度，以像素为单位。默认值为 15。

	`elementFormat:ElementFormat` (default = `null`) — 元素的元素格式。默认值为 `null`。

	`eventMirror:EventDispatcher` (default = `null`) — `EventDispatcher` 对象，该对象将接收调度到基于此内容元素创建的文本行的每个事件的副本。默认值为 `null`。

	`textRotation:String` (default = "`rotate0`") — 作为一个单元应用于元素的旋转。对此属性使用 `flash.text.engine.TextRotation` 常量。默认值为 `flash.text.engine.TextRotation.ROTATE_0`。

相关 API 元素

GroupElement

示例如何使用本示例

GraphicElementExample.as

以下示例将创建一个包含 GraphicElement（红色的框）的 TextBlock 并显示该 TextBlock，同时在该 TextBlock 下面添加包含字幕的另一个 TextBlock。

package {

    import flash.display.Sprite;
    import flash.display.MovieClip;
    import flash.text.engine.TextBlock;
    import flash.text.engine.TextElement;
    import flash.text.engine.GraphicElement;
    import flash.text.engine.TextLine;
    import flash.text.engine.ElementFormat;
    import flash.text.engine.FontDescription;
    
    public class GraphicElementExample extends Sprite {
        
        public function GraphicElementExample():void {
            
            var format:ElementFormat = new ElementFormat();
            format.fontSize = 14;
            var redBox:MovieClip = new MovieClip();
            redBox.graphics.beginFill(0xCC0000, 1.0);
            redBox.graphics.drawRect(0,0, 200, 200);
            redBox.graphics.endFill();   
            var graphicElement:GraphicElement = new GraphicElement(redBox,redBox.width,redBox.height, format);
            var textBlock:TextBlock = new TextBlock();
            textBlock.content = graphicElement;
            var textLine1:TextLine = textBlock.createTextLine(null,redBox.width);
            addChild(textLine1);
            textLine1.x = 15
            textLine1.y = 215
            var str:String = "Your picture here ...";
            var textElement:TextElement = new TextElement(str, format);
            textBlock = new TextBlock();
            textBlock.content = textElement;
            var textLine2 = textBlock.createTextLine(null, 300);
            addChild(textLine2);
            textLine2.x = textLine1.x;
            textLine2.y += textLine1.y + format.fontSize;        
        }
    }    
}

法律声明 | 在线隐私策略

GraphicElement - AS3

包x

语言元素

附录

包 flash.text.engine

elementHeight

elementWidth

graphic

GraphicElement