包flash.display
ç±»public final class GraphicsGradientFill
继承GraphicsGradientFill Inheritance Object
实现 IGraphicsFill, IGraphicsData

语言版本: ActionScript 3.0
è¿�行时版本: Flash Player 10, AIR 1.5

定义��填充。

将 GraphicsGradientFill 对象与 Graphics.drawGraphicsData() 方法一起使用。绘制 GraphicsGradientFill 对象与调用 Graphics.beginGradientFill() 方法是等效的。

�请��

flash.display.Graphics.beginGradientFill()
flash.display.Graphics.drawGraphicsData()


公共属性
 å±žæ€§å®šä¹‰æ–¹
  alphas : Array
colors 数组中的对应颜色的 Alpha 值的数组。
GraphicsGradientFill
  colors : Array
��中使用的 RGB �六进制颜色值数组。
GraphicsGradientFill
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  focalPointRatio : Number
一个控制��的焦点�置的数字。
GraphicsGradientFill
  interpolationMethod : String
InterpolationMethod 类中用于指定�使用的值的值。
GraphicsGradientFill
  matrix : Matrix
一个由 Matrix 类定义的转�矩阵。
GraphicsGradientFill
 Inheritedprototype : Object
[��] 对类或函数对象的原型对象的引用。
Object
  ratios : Array
颜色分布比率的数组。
GraphicsGradientFill
  spreadMethod : String
SpreadMethod 类用于指定�使用的扩展方法的值。
GraphicsGradientFill
  type : String
GradientType 类中用于指定�使用的��类型的值。
GraphicsGradientFill
公共方法
 æ–¹æ³•定义方
  
GraphicsGradientFill(type:String = "linear", colors:Array = null, alphas:Array = null, ratios:Array = null, matrix:* = null, spreadMethod:* = pad, interpolationMethod:String = "rgb", focalPointRatio:Number = 0.0)
创建新的 GraphicsGradientFill 对象。
GraphicsGradientFill
 Inherited
指示对象是�已�定义了指定的属性。
Object
 Inherited
指示 Object 类的实例是�在指定为�数的对象的原型链中。
Object
 Inherited
指示指定的属性是�存在�是��枚举。
Object
 Inherited
设置循环�作动�属性的�用性。
Object
 Inherited
返回指定对象的字符串表示形�。
Object
 Inherited
返回指定对象的原始值。
Object
属性详细信�
alphas属性
public var alphas:Array

语言版本: ActionScript 3.0
è¿�行时版本: Flash Player 10, AIR 1.5

colors 数组中的对应颜色的 Alpha 值的数组。有效值为 0 到 1。如果值�于 0,则使用 0。如果值大于 1,则使用 1。

colors属性 
public var colors:Array

语言版本: ActionScript 3.0
è¿�行时版本: Flash Player 10, AIR 1.5

��中使用的 RGB �六进制颜色值数组。例如,红色为 0xFF0000,�色为 0x0000FF 等等。�以至多指定 15 �颜色。对于��颜色,请在 alphas 和 ratios 属性中指定对应值。

focalPointRatio属性 
public var focalPointRatio:Number

语言版本: ActionScript 3.0
è¿�行时版本: Flash Player 10, AIR 1.5

一个控制��的焦点�置的数字。 值 0 将焦点设置在中心。值 1 表示焦点�于��圆的一�边界上;值 -1 表示焦点�于��圆的�一�边界上。�于 -1 或大于 1 的值将分别�入为 -1 或 1。例如,下例显示了设置为 0.75 的 focalPointRatio:

focalPointRatio 设置为 0.75 时的放射状��

interpolationMethod属性 
interpolationMethod:String  [读写]

语言版本: ActionScript 3.0
è¿�行时版本: Flash Player 10, AIR 1.5

InterpolationMethod 类中用于指定�使用的值的值。有效值为:InterpolationMethod.LINEAR_RGB 或 InterpolationMethod.RGB

例如,下例显示了两�颜色之间的简�线性��(spreadMethod �数设置为 SpreadMethod.REFLECT)。��的�值方法会更改外观,如下所示:

以 InterpolationMethod.LINEAR_RGB 线性�� 以 InterpolationMethod.RGB 线性��
InterpolationMethod.LINEAR_RGB InterpolationMethod.RGB



实现
    public function get interpolationMethod():String
    public function set interpolationMethod(value:String):void

�请��

matrix属性 
public var matrix:Matrix

语言版本: ActionScript 3.0
è¿�行时版本: Flash Player 10, AIR 1.5

一个由 Matrix 类定义的转�矩阵。flash.geom.Matrix 类包括一个 createGradientBox() 方法,�通过该方法设置与 beginGradientFill() 方法一起使用的矩阵。

�请��

ratios属性 
public var ratios:Array

语言版本: ActionScript 3.0
è¿�行时版本: Flash Player 10, AIR 1.5

颜色分布比率的数组。有效值为 0 到 255。该值定义 100% 采样的颜色所在�置的宽度百分比。值 0 表示��框中的左侧�置,值 255 表示��框中的�侧�置。

注�:此值表示��框中的�置,而�是最终��的�标空间。最终���能会比��框更宽或更窄。为 colors 属性中的�个值指定一个对应值。

例如,对于包括�和绿两�颜色的线性��,以下示例显示了��中的颜色基于�� ratios 数组值的�比:

ratios ��
[0, 127] ratios 为 0 和 127 时�色到绿色的线性��
[0, 255] ratios 为 0 和 255 时�色到绿色的线性��
[127, 255] ratios 为 127 和 255 时�色到绿色的线性��

数组中的值必须�续增加;例如,[0, 63, 127, 190, 255]。

spreadMethod属性 
spreadMethod:String  [读写]

语言版本: ActionScript 3.0
è¿�行时版本: Flash Player 10, AIR 1.5

SpreadMethod 类中用于指定�使用的扩展方法的值。有效值为:SpreadMethod.PAD�SpreadMethod.REFLECT 或 SpreadMethod.REPEAT。

例如,下例显示了两�颜色之间的简�线性��:

import flash.geom.*
     import flash.display.*
     var fillType:String = GradientType.LINEAR;
     var colors:Array = [0xFF0000, 0x0000FF];
     var alphas:Array = [1, 1];
     var ratios:Array = [0x00, 0xFF];
     var matr:Matrix = new Matrix();
     matr.createGradientBox(20, 20, 0, 0, 0);
     var spreadMethod:String = SpreadMethod.PAD;
     this.graphics.beginGradientFill(fillType, colors, alphas, ratios, matr, spreadMethod);       
     this.graphics.drawRect(0,0,100,100);

此示例将 SpreadMethod.PAD 用于 spread 方法,并且��填充看起�将类似于下图:

以 SpreadMethod.PAD 线性��

如果将 SpreadMethod.REFLECT 用于 spread 方法,则��填充看起�将类似于下图:

以 SpreadMethod.REFLECT 线性��

如果将 SpreadMethod.REPEAT 用于 spread 方法,则��填充看起�将类似于下图:

以 SpreadMethod.REPEAT 线性��



实现
    public function get spreadMethod():String
    public function set spreadMethod(value:String):void

�请��

type属性 
type:String  [读写]

语言版本: ActionScript 3.0
è¿�行时版本: Flash Player 10, AIR 1.5

GradientType 类中用于指定�使用的��类型的值。值为 GradientType.LINEAR 或 GradientType.RADIAL。



实现
    public function get type():String
    public function set type(value:String):void

�请��

构造函数详细信�
GraphicsGradientFill()构造函数
public function GraphicsGradientFill(type:String = "linear", colors:Array = null, alphas:Array = null, ratios:Array = null, matrix:* = null, spreadMethod:* = pad, interpolationMethod:String = "rgb", focalPointRatio:Number = 0.0)

语言版本: ActionScript 3.0
è¿�行时版本: Flash Player 10, AIR 1.5

创建新的 GraphicsGradientFill 对象。

�数
type:String (default = "linear") — 用于指定è¦�使用哪ç§�æ¸�å�˜ç±»åž‹çš„ GradientType 类的值:GradientType.LINEAR 或 GradientType.RADIAL。
 
colors:Array (default = null) — æ¸�å�˜ä¸­ä½¿ç”¨çš„ RGB å��六进制颜色值的数组(例如,红色为 0xFF0000,è“�色为 0x0000FF,等等)。å�¯ä»¥è‡³å¤šæŒ‡å®š 15 ç§�颜色。对于æ¯�ç§�颜色,请在 alphas å’Œ ratios å�‚数中指定对应值。
 
alphas:Array (default = null) — colors 数组中对应颜色的 alpha 值数组;有效值为 0 到 1。如果值å°�于 0,则使用 0。如果值大于 1,则使用 1。
 
ratios:Array (default = null) — 颜色分布比率的数组;有效值为 0 到 255。该值定义 100% 采样的颜色所在ä½�置的宽度百分比。值 0 表示æ¸�å�˜æ¡†ä¸­çš„左侧ä½�置,255 表示æ¸�å�˜æ¡†ä¸­çš„å�³ä¾§ä½�置。
 
matrix:* (default = null) — 一个由 flash.geom.Matrix 类定义的转æ�¢çŸ©é˜µã€‚ flash.geom.Matrix 类包括 createGradientBox() 方法,通过该方法å�¯ä»¥æ–¹ä¾¿åœ°è®¾ç½®çŸ©é˜µï¼Œä»¥ä¾¿ä¸Ž beginGradientFill() 方法一起使用。
 
spreadMethod:* (default = pad) — 用于指定è¦�使用哪ç§� spread 方法的 SpreadMethod 类的值:SpreadMethod.PADã€�SpreadMethod.REFLECT 或 SpreadMethod.REPEAT。
 
interpolationMethod:String (default = "rgb") — 用于指定è¦�使用哪个值的 InterpolationMethod 类的值:InterpolationMethod.LINEAR_RGB 或 InterpolationMethod.RGB
 
focalPointRatio:Number (default = 0.0) — 一个控制æ¸�å�˜çš„焦点ä½�置的数字。 值 0 将焦点设置在中心。值 1 将焦点设置在æ¸�å�˜åœ†çš„一æ�¡è¾¹ç•Œä¸Šã€‚值 -1 将焦点设置在æ¸�å�˜åœ†çš„å�¦ä¸€æ�¡è¾¹ç•Œä¸Šã€‚å°�于 -1 或大于 1 的值将分别èˆ�入为 -1 或 1。

�请��