MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference page 501

Returns
Nothing.
Description
Method; indicates the beginning of a new drawing path. If the first parameter is
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
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
This method fails if any of the following conditions exist:
•
The number of items in the
•
The parameter is not
fillType
•
Any of the fields in the object for the
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);
MovieClip.endFill()
,
colors alphas
"linear"
matrix
MovieClip.moveTo()
.
, and parameters are not equal.
ratios
or .
"radial"
parameter are missing or invalid.
MovieClip.beginGradientFill()
or if
undefined,
method), and
501