Package | mx.graphics |
Class | public class LinearGradient |
Inheritance | LinearGradient ![]() ![]() ![]() |
Implements | IFill |
entries
Array
to define the colors that make up the gradient fill.
In MXML, you define a LinearGradient by adding a series of GradientEntry objects, as the following example shows:
<mx:fill> <mx:LinearGradient> <mx:entries> <mx:GradientEntry color="0xC5C551" ratio="0.00" alpha="0.5"/> <mx:GradientEntry color="0xFEFE24" ratio="0.33" alpha="0.5"/> <mx:GradientEntry color="0xECEC21" ratio="0.66" alpha="0.5"/> </mx:entries> </mx:LinearGradient> </mx:fill>
You can also define a LinearGradient as a fill for any graphic element in ActionScript, as the following example shows:
<?xml version="1.0"?> <mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" creationComplete="init()"> <mx:Script> import flash.display.Graphics; import flash.geom.Rectangle; import mx.graphics.GradientEntry; import mx.graphics.LinearGradient; private function init():void { var w:Number = 200; var h:Number = 200; var s:Sprite = new Sprite(); // Add the new Sprite to the display list. rawChildren.addChild(s); var g:Graphics = s.graphics; g.lineStyle(1, 0x33CCFF, 1.0); var fill:LinearGradient = new LinearGradient(); var g1:GradientEntry = new GradientEntry(0xFFCC66, 0.00, 0.5); var g2:GradientEntry = new GradientEntry(0x000000, 0.33, 0.5); var g3:GradientEntry = new GradientEntry(0x99FF33, 0.66, 0.5); fill.entries = [ g1, g2, g3 ]; fill.angle = 240; // Draw a box and fill it with the LinearGradient. g.moveTo(0, 0); fill.begin(g, new Rectangle(0, 0, w, h)); g.lineTo(w, 0); g.lineTo(w, h); g.lineTo(0, h); g.lineTo(0, 0); fill.end(g); } </mx:Script> </mx:Application>MXML Syntax
The <mx:LinearGradient>
tag
inherits all the tag attributes of its superclass,
and adds the following tag attributes:
<mx:LinearGradient Properties angle="0" />
See also
Property | Defined By | ||
---|---|---|---|
angle : Number
Controls the transition direction.
| LinearGradient | ||
![]() | constructor : Object
A reference to the class object or constructor function for a given object instance.
| Object | |
![]() | entries : Array
An Array of GradientEntry objects
defining the fill patterns for the gradient fill.
| GradientBase | |
![]() | prototype : Object
[static]
A reference to the prototype object of a class or function object.
| Object |
Method | Defined By | ||
---|---|---|---|
Constructor.
| LinearGradient | ||
![]() |
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener
receives notification of an event.
| EventDispatcher | |
Starts the fill.
| LinearGradient | ||
![]() |
Dispatches an event into the event flow.
| EventDispatcher | |
Ends the fill.
| LinearGradient | ||
![]() |
Checks whether the EventDispatcher object has any listeners registered for a specific type
of event.
| EventDispatcher | |
![]() |
Indicates whether an object has a specified property defined.
| Object | |
![]() |
Indicates whether an instance of the Object class is in the prototype chain of the object specified
as the parameter.
| Object | |
![]() |
Indicates whether the specified property exists and is enumerable.
| Object | |
![]() |
Removes a listener from the EventDispatcher object.
| EventDispatcher | |
![]() |
Sets the availability of a dynamic property for loop operations.
| Object | |
![]() |
Returns the string representation of the specified object.
| Object | |
![]() |
Returns the primitive value of the specified object.
| Object | |
![]() |
Checks whether an event listener is registered with this EventDispatcher object or any of
its ancestors for the specified event type.
| EventDispatcher |
angle | property |
angle:Number
[read-write] Controls the transition direction.
By default, the LinearGradient class defines a transition from left to right across the graphical element.
A value of 180.0 causes the transition to occur from right to left. The default value is 0.0
.
This property can be used as the source for data binding.
public function get angle():Number
public function set angle(value:Number):void
LinearGradient | () | Constructor |
public function LinearGradient()
Constructor.
begin | () | method |
public function begin(target:Graphics, rc:Rectangle):void
Starts the fill.
Parameters
target:Graphics — The target Graphics object that is being filled.
|
|
rc:Rectangle — The Rectangle object that defines the size of the fill
inside the target .
If the dimensions of the Rectangle are larger than the dimensions
of the target , the fill is clipped.
If the dimensions of the Rectangle are smaller than the dimensions
of the target , the fill expands to fill the entire
target .
|
end | () | method |
public function end(target:Graphics):void
Ends the fill.
Parameters
target:Graphics — The Graphics object that is being filled.
|