View comments | RSS feed

MovieClip.beginFill()

Availability

Flash Player 6.

Usage

my_mc.beginFill([rgb:Number[, alpha:Number]]) : Void

Parameter

rgb A hex color value (for example, red is 0xFF0000, blue is 0x0000FF, and so on). If this value is not provided or is undefined, a fill is not created.

alpha An integer between 0-100 that specifies the alpha value of the fill. If this value is not provided, 100 (solid) is used. If the value is less than 0, Flash uses 0. If the value is greater than 100, Flash uses 100.

Returns

Nothing.

Description

Method; indicates the beginning of a new drawing path. 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 MovieClip.endFill() is called.

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 example creates a square with red fill on the Stage.

this.createEmptyMovieClip("square_mc", this.getNextHighestDepth());
square_mc.beginFill(0xFF0000);
square_mc.moveTo(10, 10);
square_mc.lineTo(100, 10);
square_mc.lineTo(100, 100);
square_mc.lineTo(10, 100);
square_mc.lineTo(10, 10);
square_mc.endFill();

An example is also in the drawingapi.fla file in the HelpExamples folder. The following list gives typical paths to this folder:

See also

MovieClip.beginGradientFill(), MovieClip.endFill()

Comments


#/cisnky/# said on Aug 11, 2004 at 9:51 AM :
Noticed that if you beginFill on the same item it doesn't replace the current fill. Just lays another layer of the fill on top.
ortho2005 said on Feb 7, 2005 at 9:22 AM :
It's better use
this.moveTo(0, 0);
this.beginFill(0xff0000, 100);
....
...
this.endFill();

than
this.beginFill(0xff0000, 100);
this.moveTo(0, 0);
....
...
this.endFill();

 

RSS feed | Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/flash/mx2004/main_7_2/00001488.html