| 包 | flash.display |
| ç±» | public final class GraphicsGradientFill |
| 继承 | GraphicsGradientFill Object |
| 实现 | IGraphicsFill, IGraphicsData |
| è¯è¨€ç‰ˆæœ¬: | ActionScript 3.0 |
| �行时版本: | Flash Player 10, AIR 1.5 |
å°† GraphicsGradientFill 对象与 Graphics.drawGraphicsData() 方法一起使用。绘制 GraphicsGradientFill 对象与调用 Graphics.beginGradientFill() æ–¹æ³•æ˜¯ç‰æ•ˆçš„。
�请��
| 属性 | 定义方 | ||
|---|---|---|---|
| alphas : Array colors 数组ä¸çš„对应颜色的 Alpha 值的数组。 | GraphicsGradientFill | ||
| colors : Array æ¸�å�˜ä¸ä½¿ç”¨çš„ RGB å��å…进制颜色值数组。 | GraphicsGradientFill | ||
![]() | constructor : Object
å¯¹ç±»å¯¹è±¡æˆ–ç»™å®šå¯¹è±¡å®žä¾‹çš„æž„é€ å‡½æ•°çš„å¼•ç”¨ã€‚ | Object | |
| focalPointRatio : Number 一个控制æ¸�å�˜çš„焦点ä½�置的数å—。 | GraphicsGradientFill | ||
| interpolationMethod : String InterpolationMethod ç±»ä¸ç”¨äºŽæŒ‡å®šè¦�使用的值的值。 | GraphicsGradientFill | ||
| matrix : Matrix 一个由 Matrix 类定义的转�矩阵。 | GraphicsGradientFill | ||
![]() | prototype : 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 | ||
![]() |
指示对象是�已�定义了指定的属性。 | Object | |
![]() |
指示 Object 类的实例是å�¦åœ¨æŒ‡å®šä¸ºå�‚数的对象的原型链ä¸ã€‚ | Object | |
![]() |
指示指定的属性是å�¦å˜åœ¨ã€�是å�¦å�¯æžšä¸¾ã€‚ | Object | |
![]() |
设置循环�作动�属性的�用性。 | Object | |
![]() |
返回指定对象的å—符串表示形å¼�。 | Object | |
![]() |
返回指定对象的原始值。 | 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:
| 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
|
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]
|
|
[0, 255]
|
|
[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.REFLECT 用于 spread 方法,则��填充看起�将类似于下图:
如果将 SpreadMethod.REPEAT 用于 spread 方法,则��填充看起�将类似于下图:
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。 |
�请��