mx.graphics.SolidColor源代码解析

sinkingboat

1.概述
       定义颜色的表示形式，包括颜色值和 alpha 值。

2.常见属性和方法
2.1 属性alpha

Number 类型，默认值为 1.0.
颜色的透明度。可能的值为 0.0（不可见）到 1.0（不透明）。
可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。
实现
    public function get alpha():Number
    public function set alpha(value:Number):void

2.2 属性color

uint类型
表示颜色值。可用作数据绑定的源。修改此属性后，将调度 propertyChange 事件。
实现
    public function get color():uint
    public function set color(value:uint):void

2.3 方法begin()

public function begin(target:Graphics, rc:Rectangle):void
开始填充。
参数
    target:Graphics — 要填充的目标 Graphics 对象。
    rc:Rectangle — 定义 target 内填充大小的 Rectangle 对象。如果 Rectangle 的尺寸大于 target 的尺寸，则将剪裁填充。如果 Rectangle 的尺寸小于 target 的尺寸，则将扩展填充以填充整个 target。

2.4 方法end()
public function end(target:Graphics):void
结束填充。
参数
    target:Graphics — 要填充的 Graphics 对象。


3.源代码

1. package mx.graphics
   
2. {
   
3. 
   
4. import flash.display.Graphics;
   
5. import flash.events.EventDispatcher;
   
6. import flash.geom.Point;
   
7. import flash.geom.Rectangle;
   
8. 
   
9. import mx.events.PropertyChangeEvent;
   
10. 
    
11. [DefaultProperty("color")] //默认属性为color
    
12. 
    
13. /**
    
14.  *表示一个颜色及透明度
    
15.  */
    
16. public class SolidColor extends EventDispatcher implements IFill
    
17. {
    
18.     include "../core/Version.as";
    
19. 
    
20.      /**
    
21.      *构造函数 .
    
22.       */
    
23.     public function SolidColor(color:uint = 0x000000, alpha:Number = 1.0)
    
24.      {
    
25.         super();
    
26. 
    
27.         this.color = color;
    
28.         this.alpha = alpha;
    
29.     }
    
30.     
    
31.     //属性alpha
    
32.     private var _alpha:Number = 1.0;
    
33.     
    
34.     [Bindable("propertyChange")]
    
35.     [Inspectable(category="General", minValue="0.0", maxValue="1.0")]
    
36.     public function get alpha():Number
    
37.     {
    
38.         return _alpha;
    
39.     }
    
40.     
    
41.     public function set alpha(value:Number):void
    
42.     {
    
43.         var oldValue:Number = _alpha;
    
44.         if (value != oldValue)
    
45.         {
    
46.             _alpha = value;
    
47.             dispatchFillChangedEvent("alpha", oldValue, value);
    
48.         }
    
49.     }
    
50.     
    
51. 
    
52.     // 属性 color
    
53.     private var _color:uint = 0x000000;
    
54.     
    
55.     [Bindable("propertyChange")]
    
56.     [Inspectable(category="General", format="Color")]
    
57.     public function get color():uint
    
58.     {
    
59.         return _color;
    
60.     }
    
61.     
    
62.     public function set color(value:uint):void
    
63.     {
    
64.         var oldValue:uint = _color;
    
65.         if (value != oldValue)
    
66.         {
    
67.             _color = value;
    
68.             dispatchFillChangedEvent("color", oldValue, value);
    
69.         }
    
70.     }
    
71.     
    
72.     // 方法
    
73.     /**
    
74.      * @接口mx.graphics.IFill定义的方法
75.      */
    
76.     public function begin(target:Graphics, targetBounds:Rectangle, targetOrigin:Point):void
    
77.     {
    
78.         target.beginFill(color, alpha);
    
79.     }
    
80.     
    
81.     /**
    
82.      * @接口mx.graphics.IFill定义的方法
83.      */
    
84.     public function end(target:Graphics):void
    
85.     {
    
86.         target.endFill();
    
87.     }
    
88.     
    
89.     /**
    
90.      * @private
    
91.      */
    
92.     private function dispatchFillChangedEvent(prop:String, oldValue:*, value:*):void
    
93.     {
    
94.         if (hasEventListener("propertyChange"))
    
95.             dispatchEvent(PropertyChangeEvent.createUpdateEvent(this, prop,
    
96.              oldValue, value));
    
97.     }
    
98. }
    
99. 
    
100. }

参考文献
1.SolidColor类参考.http://livedocs.adobe.com/flex/3_cn/langref/mx/graphics/SolidColor.html#begin%28%29
2.代码参考.http://opensource.adobe.com/svn/opensource/flex/sdk/trunk/frameworks/projects/framework/src/mx/graphics/SolidColor.as