Line

包	spark.primitives
类	public class Line
继承	Line StrokedElement GraphicElement EventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

Line 类是绘制两点之间的直线的图形元素。

未定义直线的默认笔触；因此，如果未指定笔触，则该直线不可见。

相关 API 元素

公共属性

	属性		由以下参数定义
		alpha : Number 图形元素的透明度级别。	GraphicElement
		alwaysCreateDisplayObject : Boolean 指定此 GraphicElement 是否与其 DisplayObject 相关联，并呈示于 DisplayObject。	GraphicElement
		baseline : Object 从锚点目标到控件的基线位置的垂直距离（以像素为单位）。	GraphicElement
		baselinePosition : Number [只读] 组件第一行文本的基线的 y 坐标。	GraphicElement
		blendMode : String BlendMode 类中的一个值，用于指定要使用的混合模式。	GraphicElement
		bottom : Object 从组件的下边缘到锚点目标的下边缘的垂直距离（以像素为单位）。	GraphicElement
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		depth : Number 确定容器内各项目的呈示顺序。	GraphicElement
		designLayer : DesignLayer 指定与该可视元素关联的可选 DesignLayer 实例。	GraphicElement
		displayObject : DisplayObject [只读] 绘制此 IGraphicElement 所在的共享 DisplayObject。	GraphicElement
		displayObjectSharingMode : String 指示此 IGraphicElement 与其显示对象之间的关联。	GraphicElement
		explicitHeight : Number 指定该组件在组件坐标中显式高度（以像素为单位）的数字。	GraphicElement
		explicitMaxHeight : Number 布局过程中父级要考虑的组件最大建议高度。	GraphicElement
		explicitMaxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。	GraphicElement
		explicitMinHeight : Number 布局过程中父级要考虑的组件最小建议高度。	GraphicElement
		explicitMinWidth : Number 布局过程中父级要考虑的组件最小建议宽度。	GraphicElement
		explicitWidth : Number 指定该组件在组件坐标中显式宽度（以像素为单位）的数字。	GraphicElement
		filters : Array 包含当前与图形元素关联的每个滤镜对象的索引数组。	GraphicElement
		hasLayoutMatrix3D : Boolean [只读] 如果元素具有 3D 矩阵，则为 true。	GraphicElement
		height : Number 图形元素的高度。	GraphicElement
		horizontalCenter : Object 从组件中心到锚点目标的内容区域中心的水平距离（以像素为单位）。	GraphicElement
		id : String 组件的标识。	GraphicElement
		includeInLayout : Boolean 指定此元素是否包含在父代的布局中。	GraphicElement
		is3D : Boolean [只读] 当元素为 3D 时，则为 true。	GraphicElement
		layoutDirection : String 指定元素的所需布局方向：LayoutDirection.LTR（从左到右）、LayoutDirection.RTL（从右到左）或 null（继承）。	GraphicElement
		left : Object 从组件的左边缘到锚点目标的左边缘的水平距离（以像素为单位）。	GraphicElement
		luminosityClip : Boolean 控制发光度遮罩是否剪辑设置了遮罩的内容的属性。	GraphicElement
		luminosityInvert : Boolean 控制计算由发光度遮罩设置遮罩的图形元素的 RGB 颜色值的属性。	GraphicElement
		mask : DisplayObject 调用显示对象被指定的 mask 对象遮罩。	GraphicElement
		maskType : String 定义将遮罩应用到 GraphicElement 的方式。可能的值为 MaskType.CLIP、MaskType.ALPHA 和 MaskType.LUMINOSITY。剪辑遮罩 - 遮罩处于剪辑模式下时，会将剪辑遮罩减少至 1 位。	GraphicElement
		maxHeight : Number 布局过程中父级要考虑的组件最大建议高度。	GraphicElement
		maxWidth : Number 布局过程中父级要考虑的组件最大建议宽度。	GraphicElement
		measuredHeight : Number 组件的默认高度（以像素为单位）。	GraphicElement
		measuredWidth : Number 组件的默认宽度（以像素为单位）。	GraphicElement
		measuredX : Number 相对于元素的原点的默认测量界限左上角。	GraphicElement
		measuredY : Number 相对于元素的原点的默认测量界限左上角。	GraphicElement
		minHeight : Number 布局过程中父级要考虑的组件最小建议高度。	GraphicElement
		minWidth : Number 布局过程中父级要考虑的组件最小建议宽度。	GraphicElement
		owner : DisplayObjectContainer 此 IVisualElement 对象的所有者。	GraphicElement
		parent : DisplayObjectContainer [只读] 此组件的父容器或组件。	GraphicElement
		percentHeight : Number 以组件父代大小百分比的方式指定组件高度。	GraphicElement
		percentWidth : Number 以组件父代大小百分比的方式指定组件宽度。	GraphicElement
		postLayoutTransformOffsets : mx.geom:TransformOffsets 定义能够应用于对象转换且在一定程度上对其父布局不可视的一组调整。	GraphicElement
		right : Object 从组件的右边缘到锚点目标的右边缘的水平距离（以像素为单位）。	GraphicElement
		rotation : Number 指示元素从转换点的旋转（以度为单位）。	GraphicElement
		rotationX : Number 指示 element 实例相对于 3D 父容器距离其原始方向的 x 轴旋转（以度为单位）。	GraphicElement
		rotationY : Number 表示 DisplayObject 实例相对于 3D 父容器距离其原始方向的 y 轴旋转（以度为单位）。	GraphicElement
		rotationZ : Number 指示元素从转换点的旋转（以度为单位）。	GraphicElement
		scaleX : Number 从转换点开始应用的元素的水平缩放比例（百分比）。	GraphicElement
		scaleY : Number 从转换点开始应用的元素的垂直缩放比例（百分比）。	GraphicElement
		scaleZ : Number 从转换点开始应用的元素的 z 缩放比例（百分比）。	GraphicElement
		stroke : IStroke 此元素所用的笔触。	StrokedElement
		top : Object 从组件的上边缘到锚点目标的上边缘的垂直距离（以像素为单位）。	GraphicElement
		transform : flash.geom:Transform 一个对象，具有与显示对象的矩阵、颜色转换和像素范围有关的属性。	GraphicElement
		transformX : Number 元素的 x 位置转换点。	GraphicElement
		transformY : Number 元素的 y 位置转换点。	GraphicElement
		transformZ : Number 元素的 z 位置转换点。	GraphicElement
		verticalCenter : Object 从组件中心到锚点目标的内容区域中心的垂直距离（以像素为单位）。	GraphicElement
		visible : Boolean 控制此可视元素的可见性。	GraphicElement
		width : Number 图形元素的宽度。	GraphicElement
		x : Number 图形元素的 x 位置。	GraphicElement
		xFrom : Number 直线的起始 x 位置。	Line
		xTo : Number 直线的结束 x 位置。	Line
		y : Number 图形元素的 y 位置。	GraphicElement
		yFrom : Number 直线的起始 y 位置。	Line
		yTo : Number 直线的结束 y 位置。	Line
		z : Number 图形元素的 z 位置。	GraphicElement

受保护的属性

隐藏继承的受保护属性

显示继承的受保护属性

	属性		由以下参数定义
		drawnDisplayObject : DisplayObject [只读] GraphicElement 在其中绘制的实际 DisplayObject。	GraphicElement
		drawX : Number [只读] 应该绘制元素的 x 位置。	GraphicElement
		drawY : Number [只读] 应该绘制元素的 y 位置。	GraphicElement
		hasComplexLayoutMatrix : Boolean [只读] 如果 GraphicElement 具有任何非平移 (x,y) 转换属性，则返回 true。	GraphicElement
		layoutFeatures : AdvancedLayoutFeatures 包含 GraphicElement 实现转换和分层支持的方法的所有实现细节。	GraphicElement
		needsDisplayObject : Boolean [只读] 如果元素需要一个独占 DisplayObject，则为 true。	GraphicElement

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		Line() 构造函数。	Line
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		canShareWithNext(element:IGraphicElement):Boolean 如果此 IGraphicElement 是兼容的且可以与序列中下一个 IGraphicElement 共享显示对象，则返回 true。	GraphicElement
		canShareWithPrevious(element:IGraphicElement):Boolean 如果此 IGraphicElement 是兼容的且可以与序列中上一个 IGraphicElement 共享显示对象，则返回 true。	GraphicElement
		createDisplayObject():DisplayObject 创建一个新 DisplayObject 以用于绘制此 IGraphicElement。	GraphicElement
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 按指定的元素大小，返回元素边界的 x 坐标。	GraphicElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 按指定的元素大小，返回元素边界的 y 坐标。	GraphicElement
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的布局高度。	GraphicElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的布局宽度。	GraphicElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number 返回元素在屏幕上进行绘制时所用的 x 坐标。	GraphicElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number 返回元素在屏幕上进行绘制时所用的 y 坐标。	GraphicElement
		getLayoutMatrix():Matrix 返回用于相对于其同级组件计算组件的布局的转换矩阵。	GraphicElement
		getLayoutMatrix3D():Matrix3D 返回此元素的布局转换 Matrix3D。	GraphicElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的最大高度。	GraphicElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的最大宽度。	GraphicElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的最小高度。	GraphicElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的最小宽度。	GraphicElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number 返回元素的首选高度。	GraphicElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number 返回元素的首选宽度。	GraphicElement
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		initialized(document:Object, id:String):void 如果 GraphicElement 是使用 MXML 标签创建的，则由 MXML 编译器自动调用。	GraphicElement
		invalidateDisplayList():void 调用此方法将导致在呈示显示列表前调用元素的 validateDisplayList() 方法。	GraphicElement
		invalidateLayoutDirection():void 当某元素的 layoutDirection 更改或其父代的 layoutDirection 更改时，该元素必须调用该方法。	GraphicElement
		invalidateProperties():void 调用此方法将导致在呈示显示列表前调用元素的 validateProperties() 方法。	GraphicElement
		invalidateSize():void 调用此方法将导致在呈示显示列表前调用元素的 validateSize() 方法。	GraphicElement
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		localToGlobal(point:Point):Point 将 Point 对象从对象的（局部）坐标转换为舞台（全局）坐标。	GraphicElement
		parentChanged(value:IGraphicElementContainer):void 将 IGraphicElement 添加到主机组件或从主机组件将其删除时由 IGraphicElementContainer 调用。	GraphicElement
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setLayoutBoundsPosition(newBoundsX:Number, newBoundsY:Number, postLayoutTransform:Boolean = true):void 设置元素在屏幕上进行绘制时所用的坐标。	GraphicElement
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void 设置元素的布局大小。	GraphicElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void 设置用于相对于其同级组件计算组件的布局大小和位置的转换 Matrix。	GraphicElement
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void 设置用于计算组件相对于其同级组件的布局大小和位置的转换 Matrix3D。	GraphicElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean 确定此元素是否可以将它自己绘制到该序列的 sharedDisplayObject。	GraphicElement
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void 用于更新转换的旋转、缩放和平移的一种实用程序方法，同时保留某个特定点，该点是在组件自己的坐标空间中指定的，且在父项的坐标空间中是固定的。	GraphicElement
		transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void 一种实用程序方法，用于将以该对象的本地坐标指定的点转换为在该对象父坐标中的相应位置。	GraphicElement
		validateDisplayList():void 由 IGraphicElementContainer 调用以在其 displayObject 属性中重新绘制此元素。	GraphicElement
		validateNow():void 根据需要，通过立即调用 validateProperties()、validateSize() 和 validateDisplayList() 来验证并更新此对象的属性和布局。	GraphicElement
		validateProperties():void 由布局逻辑用于通过调用 commitProperties() 方法来验证组件的属性。	GraphicElement
		validateSize():void 由 IGraphicElementContainer 调用以验证此元素的大小。	GraphicElement
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

隐藏继承的受保护方法

显示继承的受保护方法

	方法		由以下参数定义
		beginDraw(g:Graphics):void 为此元素设置绘制。	StrokedElement
		canSkipMeasurement():Boolean [覆盖] 确定是否可以跳过对 measure() 方法的调用。	Line
		commitProperties():void 处理在元素上设置的属性。	GraphicElement
		draw(g:Graphics):void [覆盖] 绘制元素。	Line
		endDraw(g:Graphics):void 完成此元素的绘制。	StrokedElement
		getStrokeExtents(postLayoutTransform:Boolean = true):Rectangle 返回元素界限每一侧上的笔触所占据的像素数。	GraphicElement
		invalidateDisplayObjectSharing():void 通知主机此元素已更改且需要更新其图层的实用程序方法。	GraphicElement
		invalidateParentSizeAndDisplayList():void 此对象影响其布局时（includeInLayout 为 true），使父代大小和显示列表失效的 Helper 方法。	GraphicElement
		measure():void [覆盖] 计算元素的默认大小。	Line
		preferredHeightPreTransform():Number 用于 ILayoutElement 接口的实现，返回显式度量的高度预转换。	GraphicElement
		preferredWidthPreTransform():Number 用于 ILayoutElement 接口的实现，返回测量宽度预转换的显式。	GraphicElement
		transformHeightForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 转换元素的大小。	GraphicElement
		transformWidthForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number 转换元素的大小。	GraphicElement
		updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void [覆盖] 绘制元素和/或调整其内容的大小并定位该内容。	StrokedElement

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	事件		摘要	由以下参数定义
		activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
		deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher

属性详细信息

xFrom

属性

xFrom:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

直线的起始 x 位置。

默认值为 0。

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

xTo

属性

xTo:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

直线的结束 x 位置。

默认值为 0。

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

yFrom

属性

yFrom:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

直线的起始 y 位置。

默认值为 0。

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

yTo

属性

yTo:Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

直线的结束 y 位置。

默认值为 0。

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

构造函数详细信息

()

构造函数

public function Line()

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

方法详细信息

canSkipMeasurement

()

方法

override protected function canSkipMeasurement():Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

确定是否可以跳过对 measure() 方法的调用。

Boolean — 当 measureSizes() 方法可以跳过对 measure() 方法的调用时，返回 true。例如，同时设置 explicitWidth 和 explicitHeight 属性时，它通常为 true。对于路径，当路径的界限未改变时，此为 true。

draw

()

方法

override protected function draw(g:Graphics):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

绘制元素。这是在绘制过程中采取的三个步骤中的第二步。覆盖此方法以实现绘图。已在 beginDraw() 方法中设置笔触（和填充，如果有）。您的覆盖仅应包含对诸如 moveTo()、curveTo() 和 drawRect() 等绘制方法的调用。

参数

g:Graphics — 要绘制的图形元素。

measure

()

方法

override protected function measure():void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

计算元素的默认大小。此方法是一种高级方法，可在创建 GraphicElement 的子类时覆盖。

您无需直接调用此方法。使用 addElement() 方法将元素添加到 IGraphicElementContainer 容器（例如，组）时，以及调用元素的 invalidateSize() 方法时，Flex 会调用 measure() 方法。

默认情况下您会设置元素的显式高度和显式宽度，Flex 不会调用 measure() 方法，即使您显式调用 invalidateSize() 方法也不例外。若要覆盖此行为，请覆盖 skipMeasure() 方法。

覆盖此方法时，必须设置 measuredWidth 和 measuredHeight 属性以定义默认大小。您可以选择设置 measuredX 和 measuredY 属性以定义相对于元素的原点的默认测量界限左上角。

measure() 的概念点供元素提供其自己的原始或固有界限作为默认值。因此，measuredWidth 和 measuredHeight 属性应由以下几个因素确定：

组件需要显示的文本量。
组件所显示的 JPEG 图像的大小。

某些情况下，确定默认值的方式并不固定。例如，对于一个简单的 GreenCircle 元素，可能只需在其 measure() 方法中设置 measuredWidth = 100 和 measuredHeight = 100 便可提供合理的默认大小。而在其他情况下（例如 TextArea），相应计算（例如查找合适的宽度和高度，使其刚好适合显示所有文本并拥有黄金矩形的高宽比）所耗费的时间可能会过长。

measure() 的默认实现会将 measuredWidth、measuredHeight、measuredX 和 measuredY 属性的值设置为 0。

示例如何使用本示例

LineExample.mxml

<?xml version="1.0" encoding="utf-8"?>
<!-- examples/LineExample.mxml -->
<s:Application 
    xmlns:fx="http://ns.adobe.com/mxml/2009" 
    xmlns:mx="library://ns.adobe.com/flex/mx" 
    xmlns:s="library://ns.adobe.com/flex/spark">

     <mx:Panel title="Line MXML Graphic Example"
        height="75%" width="75%" layout="horizontal"
        paddingTop="30" paddingBottom="10" paddingLeft="10" paddingRight="10">

        <s:Group x="20" y="20">
            <s:Line xFrom="0" xTo="0" yFrom="0" yTo="100">
                 <!-- Define the border color of the line. -->
                 <s:stroke>
                      <s:SolidColorStroke color="0x000000" weight="1" caps="square"/>
                 </s:stroke>
            </s:Line>
            <s:Line xFrom="6" xTo="6" yFrom="0" yTo="100">
                 <s:stroke>
                      <s:SolidColorStroke color="0x000000" weight="1" caps="square"/>
                 </s:stroke>
            </s:Line>
            <s:Line xFrom="12" xTo="12" yFrom="0" yTo="100">
                 <s:stroke>
                      <s:SolidColorStroke color="0x000000" weight="2" caps="square"/>
                 </s:stroke>
            </s:Line>
            <s:Line xFrom="20" xTo="20" yFrom="0" yTo="100">
                 <s:stroke>
                      <s:SolidColorStroke color="0x000000" weight="3" caps="square"/>
                 </s:stroke>
            </s:Line>
            <s:Line xFrom="30" xTo="30" yFrom="0" yTo="100">
                 <s:stroke>
                      <s:SolidColorStroke color="0x000000" weight="5" caps="square"/>
                 </s:stroke>
            </s:Line>
            <s:Line xFrom="43" xTo="43" yFrom="0" yTo="100">
                 <s:stroke>
                      <s:SolidColorStroke color="0x000000" weight="8" caps="square"/>
                 </s:stroke>
            </s:Line>
            <s:Line xFrom="58" xTo="58" yFrom="0" yTo="100">
                 <s:stroke>
                      <s:SolidColorStroke color="0x000000" weight="13" caps="square"/>
                 </s:stroke>
            </s:Line>
            <s:Line xFrom="84" xTo="84" yFrom="0" yTo="100">
                 <s:stroke>
                      <s:SolidColorStroke color="0x000000" weight="21" caps="square"/>
                 </s:stroke>
            </s:Line>
            <s:Line xFrom="123" xTo="123" yFrom="0" yTo="100">
                 <s:stroke>
                      <s:SolidColorStroke color="0x000000" weight="34" caps="square"/>
                 </s:stroke>
            </s:Line>

        </s:Group>

     </mx:Panel>
</s:Application>

法律声明 | 在线隐私策略

Line - AS3 Flex

类 x

xFrom

xTo

yFrom

yTo

Line

canSkipMeasurement

draw

measure