StrokedElement

包	spark.primitives.supportClasses
类	public class StrokedElement
继承	StrokedElement GraphicElement EventDispatcher Object
子类	FilledElement, Line

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

StrokedElement 类是所有具有笔触的图形元素的基类，这些元素包括 Line、Ellipse、Path 和 Rect。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		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
		y : Number 图形元素的 y 位置。	GraphicElement
		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

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		StrokedElement() 构造函数。	StrokedElement
		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() 方法的调用。	GraphicElement
		commitProperties():void 处理在元素上设置的属性。	GraphicElement
		draw(g:Graphics):void 绘制元素。	StrokedElement
		endDraw(g:Graphics):void 完成此元素的绘制。	StrokedElement
		getStrokeExtents(postLayoutTransform:Boolean = true):Rectangle 返回元素界限每一侧上的笔触所占据的像素数。	GraphicElement
		invalidateDisplayObjectSharing():void 通知主机此元素已更改且需要更新其图层的实用程序方法。	GraphicElement
		invalidateParentSizeAndDisplayList():void 此对象影响其布局时（includeInLayout 为 true），使父代大小和显示列表失效的 Helper 方法。	GraphicElement
		measure():void 计算元素的默认大小。	GraphicElement
		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

属性详细信息

stroke

属性

stroke:IStroke

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

此元素所用的笔触。

此属性可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。

实现
public function get stroke():IStroke
public function set stroke(value:IStroke):void

构造函数详细信息

()

构造函数

public function StrokedElement()

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

方法详细信息

beginDraw

()

方法

protected function beginDraw(g:Graphics):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

为此元素设置绘制。这是在绘制过程中采取的三个步骤中的第一步。在这一步中，会应用笔触属性。

参数

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

draw

()

方法

protected function draw(g:Graphics):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

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

参数

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

endDraw

()

方法

protected function endDraw(g:Graphics):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

完成此元素的绘制。这是在绘制过程中采取的三个步骤中的最后一步。在这一步中，填充已关闭。

参数

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

updateDisplayList

()

方法

override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 10, AIR 1.5

绘制元素和/或调整其内容的大小并定位该内容。此方法是一种高级方法，可在创建 GraphicElement 的子类时覆盖。

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

您可以借助此方法使用针对元素的 displayObject（如 graphics.drawRect()）上的一些方法以编程方式进行绘制。

参数

	`unscaledWidth:Number` — 指定组件在组件坐标中的宽度（以像素为单位），而不考虑该组件的 `scaleX` 属性值。

	`unscaledHeight:Number` — 指定组件在组件坐标中的高度（以像素为单位），而不考虑该组件的 `scaleY` 属性值。

法律声明 | 在线隐私策略

StrokedElement - AS3 Flex

类 x

stroke

StrokedElement

beginDraw

draw

endDraw

updateDisplayList