User Guide

536 Chapter 2: ActionScript Language Reference

MovieClip.lineStyle()

Availability

Flash Player 6.

Usage

my_mc.lineStyle([thickness:Number[,

rgb:Number[, alpha:Number]]]) : Void

Parameters

thickness

An integer that indicates the thickness of the line in points; valid values are 0 to

255. If a number is not specified, or if the parameter is

undefined, a line is not drawn. If a value

of less than 0 is passed, Flash uses 0. The value 0 indicates hairline thickness; the maximum

thickness is 255. If a value greater than 255 is passed, the Flash interpreter uses 255.

rgb A hex color value (for example, red is 0xFF0000, blue is 0x0000FF, and so on) of the line.

If a value isn’t indicated, Flash uses 0x000000 (black).

alpha An integer that indicates the alpha value of the line’s color; valid values are 0–100. If a

value isn’t indicated, Flash uses 100 (solid). If the value is less than 0, Flash uses 0; if the value is

greater than 100, Flash uses 100.

Returns

Nothing.

Description

Method; specifies a line style that Flash uses for subsequent calls to lineTo() and curveTo()

until you call

lineStyle() with different parameters. You can call lineStyle() in the middle of

drawing a path to specify different styles for different line segments within a path.

Note: Calls to clear() will set the line style back to undefined.

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 draws a triangle with a 5-pixel, solid magenta line with no fill:

this.createEmptyMovieClip("triangle_mc", 1);

triangle_mc.lineStyle(5, 0xff00ff, 100);

triangle_mc.moveTo(200, 200);

triangle_mc.lineTo(300, 300);

triangle_mc.lineTo(100, 300);

triangle_mc.lineTo(200, 200);