User Guide

MovieClip.beginGradientFill() 501
Returns
Nothing.
Description
Method; indicates the beginning of a new drawing path. If the first parameter is undefined, or if
no parameters are passed, the path has no fill. If an open path exists (that is if the current drawing
position does not equal the previous position specified in a
MovieClip.moveTo() method), and
it has a fill associated with it, that path is closed with a line and then filled. This is similar to what
happens when you call
MovieClip.endFill().
This method fails if any of the following conditions exist:
• The number of items in the colors, alphas, and ratios parameters are not equal.
• The fillType parameter is not "linear" or "radial".
• Any of the fields in the object for the matrix parameter are missing or invalid.
You can extend the methods and event handlers of the MovieClip class by creating a subclass. For
more information, see “Assigning a class to a movie clip symbol” in Using ActionScript in Flash.
Example
The following code uses both methods to draw two stacked rectangles with a red-blue gradient fill
and a 5-pixel solid lime green stroke:
this.createEmptyMovieClip("gradient_mc", 1);
with (gradient_mc) {
colors = [0xFF0000, 0x0000FF];
alphas = [100, 100];
ratios = [0, 0xFF];
lineStyle(5, 0x00ff00);
matrix = {a:500, b:0, c:0, d:0, e:200, f:0, g:350, h:200, i:1};
beginGradientFill("linear", colors, alphas, ratios, matrix);
moveTo(100, 100);
lineTo(100, 300);
lineTo(600, 300);
lineTo(600, 100);
lineTo(100, 100);
endFill();
matrix = {matrixType:"box", x:100, y:310, w:500, h:200, r:(0/180)*Math.PI};
beginGradientFill("linear", colors, alphas, ratios, matrix);
moveTo(100, 310);
lineTo(100, 510);
lineTo(600, 510);
lineTo(600, 310);
lineTo(100, 310);