mx.graphics
public class LinearGradientStroke
继承LinearGradientStroke Inheritance GradientBase Inheritance EventDispatcher Inheritance Object
实现 IStroke

LinearGradientStroke 类允许您指定渐变填充的笔触。您可以将 LinearGradientStroke 类与 GradientEntry 类配合使用以定义渐变笔触。

另请参见

mx.graphics.Stroke
mx.graphics.GradientEntry
mx.graphics.RadialGradient
flash.display.Graphics


公共属性
 属性定义方
  angle : Number
默认情况下,LinearGradientStroke 定义控件进行从左到右的过渡。
LinearGradientStroke
  caps : String
用于指定线条末端处端点类型的 CapsStyle 类的值。
LinearGradientStroke
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
 Inheritedentries : Array
GradientEntry 对象 Array,用于定义渐变填充的填充模式。
GradientBase
  interpolationMethod : String
InterpolationMethod 类中的一个值,指定要使用的 interpolation 方法。
LinearGradientStroke
  joints : String
JointStyle 类的值,指定用于拐角的连接外观的类型。
LinearGradientStroke
  miterLimit : Number
一个表示将在哪个限制位置切断尖角的数字。
LinearGradientStroke
  pixelHinting : Boolean
用于指定是否提示笔触采用完整像素的布尔值。
LinearGradientStroke
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
  scaleMode : String
LineScaleMode 类中的一个值,指定要使用的缩放模式。
LinearGradientStroke
  spreadMethod : String
SpreadMethod 类中的一个值,指定要使用的 spread 方法。
LinearGradientStroke
  weight : Number
线条粗细(以像素为单位)。
LinearGradientStroke
公共方法
 方法定义方
  
LinearGradientStroke(weight:Number = 0, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = null, joints:String = null, miterLimit:Number = 0)
构造函数。
LinearGradientStroke
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象,以使侦听器能够接收事件通知。
EventDispatcher
  
对指定的 Graphics 对象应用属性。
LinearGradientStroke
 Inherited
将事件调度到事件流中。
EventDispatcher
 Inherited
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。
EventDispatcher
 Inherited
指示对象是否已经定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
 Inherited
指示指定的属性是否存在、是否可枚举。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
从 EventDispatcher 对象中删除侦听器。
EventDispatcher
 Inherited
设置循环操作动态属性的可用性。
Object
 Inherited
返回指定对象的字符串表示形式。
Object
 Inherited
返回指定对象的原始值。
Object
 Inherited
检查是否用此 EventDispatcher 对象或其任何始祖为指定事件类型注册了事件侦听器。
EventDispatcher
事件
 事件 摘要 定义方
 Inherited[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。EventDispatcher
 Inherited[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。EventDispatcher
属性详细信息
angle属性
angle:Number  [读写]

默认情况下,LinearGradientStroke 定义控件进行从左到右的过渡。使用 angle 属性可以控制过渡方向。例如,当值为 180.0 时,将会发生从右到左的过渡,而非从左到右的过渡。

默认值为 0.0.



实现
    public function get angle():Number
    public function set angle(value:Number):void
caps属性 
caps:String  [读写]

用于指定线条末端处端点类型的 CapsStyle 类的值。

有效值为 CapsStyle.NONECapsStyle.ROUNDCapsStyle.SQUAREnull 值等效于 CapsStyle.ROUND

默认值为 null.

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



实现
    public function get caps():String
    public function set caps(value:String):void
interpolationMethod属性 
interpolationMethod:String  [读写]

InterpolationMethod 类中的一个值,指定要使用的 interpolation 方法。

有效值为 InterpolationMethod.LINEAR_RGBInterpolationMethod.RGB

默认值为 InterpolationMethod.RGB.



实现
    public function get interpolationMethod():String
    public function set interpolationMethod(value:String):void
joints属性 
joints:String  [读写]

JointStyle 类的值,指定用于拐角的连接外观的类型。

有效值为 JointStyle.BEVELJointStyle.MITERJointStyle.ROUNDnull 值等效于 JoinStyle.ROUND

默认值为 null.

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



实现
    public function get joints():String
    public function set joints(value:String):void
miterLimit属性 
miterLimit:Number  [读写]

一个表示将在哪个限制位置切断尖角的数字。

有效值的范围是 0 到 255(超出该范围的值将舍入为 0 或 255)。

只有在将 jointStyle 设置为 JointStyle.MITER 时,才使用此值。

miterLimit 值表示向外延伸的尖角可以超出角边相交所形成的结合点的长度。此值表示为线条 thickness 的因子。例如,miterLimit 因子为 2.5 且 thickness 为 10 像素时,尖角将在 25 像素处切断。

默认值为 0.

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



实现
    public function get miterLimit():Number
    public function set miterLimit(value:Number):void
pixelHinting属性 
pixelHinting:Boolean  [读写]

用于指定是否提示笔触采用完整像素的布尔值。

它同时影响曲线锚点的位置以及线条笔触大小本身。

pixelHinting 设置为 true 的情况下,Flash Player 和 AIR 将提示线条宽度采用完整像素宽度。在 pixelHinting 设置为 false 的情况下,对于曲线和直线可能会出现脱节。

默认值为 false.

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



实现
    public function get pixelHinting():Boolean
    public function set pixelHinting(value:Boolean):void
scaleMode属性 
scaleMode:String  [读写]

LineScaleMode 类中的一个值,指定要使用的缩放模式。有效值为:

默认值为 LineScaleMode.NORMAL.

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



实现
    public function get scaleMode():String
    public function set scaleMode(value:String):void
spreadMethod属性 
spreadMethod:String  [读写]

SpreadMethod 类中的一个值,指定要使用的 spread 方法。

有效值为 SpreadMethod.PADSpreadMethod.REFLECTSpreadMethod.REPEAT

默认值为 SpreadMethod.PAD.

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



实现
    public function get spreadMethod():String
    public function set spreadMethod(value:String):void
weight属性 
weight:Number  [读写]

线条粗细(以像素为单位)。对于很多图表,默认值都为 1 个像素。

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



实现
    public function get weight():Number
    public function set weight(value:Number):void
构造函数详细信息
LinearGradientStroke()构造函数
public function LinearGradientStroke(weight:Number = 0, pixelHinting:Boolean = false, scaleMode:String = "normal", caps:String = null, joints:String = null, miterLimit:Number = 0)

构造函数。

参数
weight:Number (default = 0) — 指定线条的粗细(以像素为单位)。此参数是可选的,默认值为 0
 
pixelHinting:Boolean (default = false) — 用于指定是否提示笔触采用完整像素的布尔值。它同时影响曲线锚点的位置以及线条笔触大小本身。在 pixelHinting 设置为 true 的情况下,Flash Player 和 AIR 将提示线条宽度采用完整像素宽度。在 pixelHinting 设置为 false 的情况下,对于曲线和直线可能会出现脱节。此参数是可选的,默认值为 false
 
scaleMode:String (default = "normal") — LineScaleMode 类中的一个值,指定要使用的缩放模式。有效值为 LineScaleMode.HORIZONTALLineScaleMode.NONELineScaleMode.NORMALLineScaleMode.VERTICAL。此参数是可选的,默认值为 LineScaleMode.NORMAL
 
caps:String (default = null) — 用于指定线条末端处端点类型的 CapsStyle 类的值。有效值为 CapsStyle.NONECapsStyle.ROUNDCapsStyle.SQUAREnull 值等效于 CapsStyle.ROUND。此参数是可选的,默认值为 null
 
joints:String (default = null) — JointStyle 类的值,指定用于拐角的连接外观的类型。有效值为 JointStyle.BEVELJointStyle.MITERJointStyle.ROUNDnull 值等效于 JoinStyle.ROUND。此参数是可选的,默认值为 null
 
miterLimit:Number (default = 0) — 一个表示将在哪个限制位置切断尖角的数字。有效值的范围是 1 到 255(超出该范围的值将舍入为 1 或 255)。只有在将 jointStyle 属性设置为 miter 时,才使用此值。miterLimit 值表示向外延伸的尖角可以超出角边相交所形成的结合点的长度。此值表示为线条 thickness 的因子。例如,miterLimit 因子为 2.5 且 thickness 为 10 像素时,尖角将在 25 像素处切断。此参数是可选的,默认值为 0
方法详细信息
apply()方法
public function apply(g:Graphics):void

对指定的 Graphics 对象应用属性。

参数

g:Graphics — 要应用 LinearGradientStroke 样式的 Graphics 对象。