Tài liệu Flash: ActionScript Language Reference- P6 docx

For more information, see “Assigning a class to a movie clip symbol” in Using ActionScript in Flash... For more information, see “Assigning a class to a movie clip symbol” in Using Actio

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.

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);

An example is also in the drawingapi.fla file in the HelpExamples folder The following list gives

typical paths to this folder:

• Windows: \Program Files\Macromedia\Flash MX 2004\Samples\HelpExamples\

• Macintosh: HD/Applications/Macromedia Flash MX 2004/Samples/HelpExamples/

See also

MovieClip.lineStyle()

instanceName A string that identifies the instance name of the new movie clip.

depth An integer that specifies the depth of the new movie clip

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.

See also

MovieClip.attachMovie()

instanceName A string that identifies the instance name of the new text field.

depth A positive integer that specifies the depth of the new text field

x An integer that specifies the x coordinate of the new text field.

y An integer that specifies the y coordinate of the new text field.

width A positive integer that specifies the width of the new text field

height A positive integer that specifies the height of the new text field

or MovieClip.getNextHighestDepth(), to determine the highest unoccupied depth The text field is positioned at (x, y) with dimensions width by height The x and y parameters are relative

to the container movie clip; these parameters correspond to the _x and _y properties of the text field The width and height parameters correspond to the _width and _height properties of the text field

The default properties of a text field are as follows:

variable = null

maxChars = null

styleSheet = undefined

tabInded = undefined

A text field created with createTextField() receives the following default TextFormat object:

font = "Times New Roman"

tabStops = [] (empty array)

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 text field with a width of 300, a height of 100, an x coordinate of

100, a y coordinate of 100, no border, red, and underlined text:

An example is also in the animations.fla file in the HelpExamples folder The following list gives

typical paths to this folder:

• Windows: \Program Files\Macromedia\Flash MX 2004\HelpExamples\

• Macintosh: HD/Applications/Macromedia Flash MX 2004/HelpExamples/

See also

TextFormat class

The following example uses the _currentframe property to direct the playhead of the movie clip

actionClip_mc to advance five frames ahead of its current location:

actionClip_mc.gotoAndStop(actionClip_mc._currentframe + 5);

Method; draws a curve using the current line style from the current drawing position to

(anchorX, anchorY) using the control point specified by (controlX, controlY) The current drawing position is then set to (anchorX, anchorY) If the movie clip you are drawing in contains content created with the Flash drawing tools, calls to curveTo() are drawn underneath this content If you call curveTo() before any calls to moveTo(), the current drawing position defaults to (0, 0) If any of the parameters are missing, this method fails and the current drawing position is not changed

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.

MovieClip.curveTo() 509

The curve drawn in this example is a quadratic bezier curve Quadratic bezier curves consist of two anchor points and a control point The curve interpolates the two anchor points, and curves toward the control point

The following ActionScript creates a circle using MovieClip.curveTo() and the Math class:

mc.curveTo(Math.tan(Math.PI/8)*r+x, r+y, x, r+y);

mc.curveTo(-Math.tan(Math.PI/8)*r+x, r+y, -Math.sin(Math.PI/4)*r+x,

Math.sin(Math.PI/4)*r+y);

mc.curveTo(-r+x, Math.tan(Math.PI/8)*r+y, -r+x, y);

mc.curveTo(r+x, Math.tan(Math.PI/8)*r+y, Math.sin(Math.PI/4)*r+x, Math.sin(Math.PI/4)*r+y);

-mc.curveTo(-Math.tan(Math.PI/8)*r+x, -r+y, x, -r+y);

mc.curveTo(Math.tan(Math.PI/8)*r+x, r+y, Math.sin(Math.PI/4)*r+x,

-Math.sin(Math.PI/4)*r+y);

mc.curveTo(r+x, -Math.tan(Math.PI/8)*r+y, r+x, y);

}

An example is also in the drawingapi.fla file in the HelpExamples folder The following list gives

typical paths to this folder:

• Windows: \Program Files\Macromedia\Flash MX 2004\Samples\HelpExamples\

• Macintosh: HD/Applications/Macromedia Flash MX 2004/Samples/HelpExamples/

See also

MovieClip.beginFill() , MovieClip.createEmptyMovieClip() , MovieClip.endFill() ,

MovieClip.lineStyle() , MovieClip.lineTo() , MovieClip.moveTo()

Read-only property; returns the absolute path in slash syntax notation of the movie clip instance

on which my_mc was dropped The _droptarget property always returns a path that starts with a slash (/) To compare the _droptarget property of an instance to a reference, use the eval()function to convert the returned value from slash syntax to a dot syntax reference

Note: You must perform this conversion if you are using ActionScript 2.0, which does not support

slash syntax

Example

The following example evaluates the _droptarget property of the garbage_mc movie clip instance and uses eval() to convert it from slash syntax to a dot syntax reference The

garbage_mc reference is then compared to the reference to the trashcan_mc movie clip instance

If the two references are equivalent, the visibility of garbage_mc is set to false If they are not equivalent, the garbage instance resets to its original position

newname A unique identifier for the duplicate movie clip.

depth A unique number specifying the depth at which the SWF file specified is to be placed

initObject (Supported for Flash Player 6 and later.) An object containing properties with which to populate the duplicated movie clip This parameter allows dynamically created movie clips to receive clip parameters If initObject is not an object, it is ignored All properties of

initObject are copied into the new instance The properties specified with initObject are available to the constructor function This parameter is optional

duplicateMovieClip() are not duplicated if you call duplicateMovieClip() on their parent

If the parent movie clip is deleted, the duplicate movie clip is also deleted If you have loaded a movie clip using MovieClip.loadMovie() or the MovieClipLoader class, the contents of the SWF file are not duplicated This means that you cannot save bandwidth by loading a JPEG or SWF file and then duplicating the movie clip

Example

The following example duplicates the circle_mc movie clip The code creates the movie clip, called circle1_mc, at the x, y coordinates 20,20

circle_mc.duplicateMovieClip("circle1_mc", this.getNextHighestDepth(), {_x:20, _y:20});

See also

duplicateMovieClip() , MovieClip.removeMovieClip()

Property; a Boolean value that indicates whether a movie clip is enabled The default value of

enabled is true If enabled is set to false, the movie clip’s callback methods and onaction

event handlers are no longer invoked, and the Over, Down, and Up frames are disabled The

enabled property does not affect the Timeline of the movie clip; if a movie clip is playing, it continues to play The movie clip continues to receive movie clip events (for example, mouseDown,

mouseUp, keyDown, and keyUp)

The enabled property only governs the button-like properties of a movie clip You can change the enabled property at any time; the modified movie clip is immediately enabled or disabled The enabled property can be read out of a prototype object If enabled is set to false, the object is not included in automatic tab ordering

Method; applies a fill to the lines and curves added since the last call to beginFill() or

beginGradientFill() Flash uses the fill that was specified in the previous call to beginFill()

or beginGradientFill() If the current drawing position does not equal the previous position specified in a moveTo() method and a fill is defined, the path is closed with a line and then filled

An example is also in the drawingapi.fla file in the HelpExamples folder The following list gives

typical paths to this folder:

• Windows: \Program Files\Macromedia\Flash MX 2004\Samples\HelpExamples\

• Macintosh: HD/Applications/Macromedia Flash MX 2004/Samples/HelpExamples/

See Also

MovieClip.beginFill() , MovieClip.beginGradientFill() , MovieClip.moveTo()

In Flash Player 4 or Flash Player 5 SWF files, the _focusrect property controls the global

_focusrect property It is a Boolean value This behavior was changed in Flash Player 6 and later

to permit the customization of _focusrect on an individual movie clip basis

Additionally, you can test your SWF file in the test environment Select Control > Disable Keyboard Shortcuts from the main menu in the test environment This allows you to view the focus rectangle around the instances in the SWF file

See Also

Button._focusrect , _focusrect

The following example uses the _framesloaded property to start a SWF file when all the frames are loaded If all the frames aren’t loaded, the _xscale property of the movie clip instance loader

is increased proportionally to create a progress bar

Enter the following ActionScript in Frame 1 of the Timeline:

var pctLoaded:Number = Math.round(this.getBytesLoaded()/

targetCoordinateSpace The target path of the Timeline whose coordinate system you want

to use as a reference point

Returns

An object with the properties xMin, xMax, yMin, and yMax.

Description

Method; returns properties that are the minimum and maximum x and y coordinate values of the

instance specified by my_mc for the targetCoordinateSpace parameter

Note: Use MovieClip.localToGlobal() and MovieClip.globalToLocal() to convert the movie clip’s local coordinates to Stage coordinates, or Stage coordinates to local coordinates, respectively.

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 movie clip called square_mc The code draws a square for that movie clip and uses MovieClip.getBounds() to display the coordinate values of the instance in the Output panel

var bounds_obj:Object = square_mc.getBounds(this);

for (var i in bounds_obj) {

See also

MovieClip.globalToLocal() , MovieClip.localToGlobal()

MovieClip.getBytesTotal() to determine what percentage of a movie clip has loaded.

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 uses the _framesloaded property to start a SWF file when all the frames are loaded If all the frames aren’t loaded, the _xscale property of the movie clip instance loader

is increased proportionally to create a progress bar

Enter the following ActionScript in Frame 1 of the Timeline:

var pctLoaded:Number = Math.round(this.getBytesLoaded()/

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 uses the _framesloaded property to start a SWF file when all the frames are loaded If all the frames aren’t loaded, the _xscale property of the movie clip instance loader

is increased proportionally to create a progress bar

Enter the following ActionScript in Frame 1 of the Timeline:

var pctLoaded:Number = Math.round(this.getBytesLoaded()/

Method; returns the depth of a movie clip instance For more information, see “Managing movie

clip depths” in Using ActionScript in Flash.

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 traces the depth of all movie clip instances on the Stage:

for (var i in this) {

if (typeof (this[i]) == "movieclip") {

trace("movie clip '"+this[i]._name+"' is at depth "+this[i].getDepth()); }

}

See also

MovieClip.getInstanceAtDepth() , MovieClip.getNextHighestDepth() ,

MovieClip.swapDepths()

clip depths” in Using ActionScript in Flash.

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.

trace(this.getInstanceAtDepth(1)); // output: _level0.logo_mc

See also

MovieClip.getDepth() , MovieClip.getNextHighestDepth() , MovieClip.swapDepths()

For more information, see “Managing movie clip depths” in Using ActionScript in Flash.

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 new movie clip instance, logo_mc, at the next highest depth available At runtime, logo_mc renders in front of all other instances at the same level

this.createEmptyMovieClip("logo_mc", this.getNextHighestDepth());

var logo_mcl:MovieClipLoader = new MovieClipLoader();

var mclListener:Object = new Object();

See also

MovieClip.getDepth() , MovieClip.getInstanceAtDepth() , MovieClip.swapDepths()

An integer that specifies the Flash Player version that was targeted when the SWF file loaded into

my_mc was published

Description

Method; returns an integer that indicates the Flash Player version for which my_mc was published

If my_mc is a JPEG file, or if an error occurs and Flash can’t determine the SWF version of my_mc, -1 is returned

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.

trace("Loaded Flash Player " + fp6_mc.getSWFVersion() + " file.");

//output: Loaded Flash Player 6 file.

};

Flash concatenates text and places it in the TextSnapshot object in an order that reflects the tab index order of the static text fields in the movie clip Text fields that don’t have tab index values are placed in a random order in the object, and precede any text from fields that do have tab index values No line breaks or formatting indicates where one field ends and the next begins.

Note: You can’t specify a tab index value for static text in Flash However, other products may do so

(for example, Macromedia FlashPaper).

The contents of the TextSnapshot object aren’t dynamic; that is, if the movie clip moves to a different frame, or is altered in some way (for example, objects in the movie clip are added or removed), the TextSnapshot object might not represent the current text in the movie clip To ensure that the object’s contents are current, reissue this command as needed

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.

var textSnap:TextSnapshot = text_mc.getTextSnapshot();

text_mc.textSnapshot_txt.htmlText = "<textformat tabstops='[150]'>";

for (var i in textSnap) {

text_mc.textSnapshot_txt.htmlText += "<b>"+i+"</b>\t"+textSnap[i]; }

URL String; the URL from which to obtain the document.

window String; an optional parameter specifying the name, frame, or expression that specifies the window or HTML frame that the document is loaded into You can also use one of the following reserved target names: _self specifies the current frame in the current window, _blank

specifies a new window, _parent specifies the parent of the current frame, and _top specifies the top-level frame in the current window

variables String (either "GET" or "POST"); an optional parameter specifying a method for sending variables associated with the SWF file to load If there are no variables, omit this parameter; otherwise, specify whether to load variables using a GET or POST method GET appends the variables to the end of the URL and is used for a small numbers of variables POST sends the variables in a separate HTTP header and is used for long strings of variables

Returns

Nothing

Description

Method; loads a document from the specified URL into the specified window The getURL

method can also be used to pass variables to another application defined at the URL using a GET

or POST method

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 ActionScript creates a new movie clip instance and opens the Macromedia website

in a new browser window:

loader_mc.username = "some user input";

loader_mc.password = "random string";

loader_mc.getURL("http://www.flash-mx.com/mm/viewscope.cfm", "_blank", "GET"); See also

getURL() , LoadVars.sendAndLoad() , LoadVars.send()

point The name or identifier of an object created with the generic Object class The object

specifies the x and y coordinates as properties

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

Add the following ActionScript to a FLA or AS file in the same directory as an image called photo1.jpg:

this.createTextField("coords_txt", this.getNextHighestDepth(), 10, 10, 100, 22);

var rowHeaders = "<b> &nbsp; \t</b><b>_x\t</b><b>_y</b>";

var row_1 = "_root\t"+_xmouse+"\t"+_ymouse;

var row_2 = "target_mc\t"+point.x+"\t"+point.y;

coords_txt.htmlText = "<textformat tabstops='[100, 150]'>";

MovieClip.globalToLocal() 529 See also

MovieClip.getBounds() , MovieClip.localToGlobal()

frame A number representing the frame number, or a string representing the label of the frame,

to which the playhead is sent

Returns

Nothing

Description

Method; starts playing the SWF file at the specified frame If you want to specify a scene as well as

a frame, use gotoAndPlay()

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 uses the _framesloaded property to start a SWF file when all the frames are loaded If all the frames aren’t loaded, the _xscale property of the movie clip instance loader

is increased proportionally to create a progress bar

Enter the following ActionScript in Frame 1 of the Timeline:

var pctLoaded:Number = Math.round(this.getBytesLoaded()/

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 uses the _framesloaded property to start a SWF file when all the frames are loaded If all the frames aren’t loaded, the _xscale property of the movie clip instance loader

is increased proportionally to create a progress bar

Enter the following ActionScript in Frame 1 of the Timeline:

var pctLoaded:Number = Math.round(this.getBytesLoaded()/

var image_mcl:MovieClipLoader = new MovieClipLoader();

var mclListener:Object = new Object();

See Also

MovieClip._width

Property; designates another movie clip to serve as the hit area for a movie clip If the hitArea

property does not exist or is null or undefined, the movie clip itself is used as the hit area The value of the hitArea property may be a reference to a movie clip object

You can change the hitArea property at any time; the modified movie clip immediately takes on the new hit area behavior The movie clip designated as the hit area does not need to be visible; its graphical shape, although not visible, is hit-tested The hitArea property can be read out of a prototype object

Example

The following example sets the circle_mc movie clip as the hit area for the square_mc movie clip Place these two movie clips on the Stage and test the document When you click circle_mc, the square_mc movie clip traces that it has been clicked

x The x coordinate of the hit area on the Stage.

y The y coordinate of the hit area on the Stage.

The x and y coordinates are defined in the global coordinate space.

target The target path of the hit area that may intersect or overlap with the instance specified

by my_mc The target parameter usually represents a button or text-entry field

shapeFlag A Boolean value specifying whether to evaluate the entire shape of the specified instance (true), or just the bounding box (false) This parameter can be specified only if the hit area is identified using x and y coordinate parameters

true is returned This is useful for determining if the movie clip is within a specified hit or hotspot area

Usage 2: Evaluates the bounding boxes of the target and specified instance, and returns true if they overlap or intersect at any point

MovieClip.hitTest() 535 See also

MovieClip.getBounds() , MovieClip.globalToLocal() , MovieClip.localToGlobal()

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.

MovieClip.beginFill() , MovieClip.beginGradientFill() , MovieClip.clear() ,

MovieClip.curveTo() , MovieClip.lineTo() , MovieClip.moveTo()

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.

variables An optional parameter specifying an HTTP method for sending or loading variables The parameter must be the string GET or POST If there are no variables to be sent, omit this parameter The GET method appends the variables to the end of the URL and is used for small numbers of variables The POST method sends the variables in a separate HTTP header and is used for long strings of variables.

Without the loadMovie() method, Flash Player displays a single SWF file and then closes The

loadMovie() method lets you display several SWF files at once and switch between SWF files without loading another HTML document

A SWF file or image loaded into a movie clip inherits the position, rotation, and scale properties

of the movie clip You can use the target path of the movie clip to target the loaded SWF file.When calling loadMovie(), set the MovieClip._lockroot property to true in the loader movie, as shown in the following code If you don’t set _lockroot to true in the loader movie, the loader has access only to its own library, but not the library in the loaded movie:

myMovieClip._lockroot = true;

Use the MovieClip.unloadMovie() method to remove SWF files or images loaded with the

loadMovie() method Use the MovieClip.loadVariables() method to keep the active SWF file, and update the variables of the SWF file with new values

MovieClip.loadMovie() 539

Using event handlers with MovieClip.loadMovie() can be unpredictable If you attach an event handler to a button using on() or if you create a dynamic handler using an event handler method such as MovieClip.onPress, and then you call loadMovie(), the event handler does not remain after the new content is loaded However, if you attach an event handler to a movie clip using

onClipEvent() or on(), and then call loadMovie() on that movie clip, the event handler remains after the new content is loaded

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

As shown in the following example, you can use loadMovie() to load the image picture.jpg into

a movie clip and use the MovieClip.onPress() method to make the image act like a button Loading a JPEG using loadMovie() replaces the movie clip with the image but doesn’t give you access to movie clip methods To get access to movie clip methods, you must create an empty parent movie clip and a container child movie clip Load the image into the container and place the event handler on the parent movie clip

// Creates a parent movie clip to hold the container

this.createEmptyMovieClip("logo_mc", this.getNextHighestDepth());

// creates a child movie clip inside of "mc_1"

// this is the movie clip the image will replace

logo_mc.createEmptyMovieClip("container_mc",0);

logo_mc.container_mc.loadMovie("http://www.macromedia.com/images/shared/ product_boxes/80x92/studio_flashpro.jpg");

// put event handler on the parent movie clip mc_1

logo_mc.onPress = function() {

trace("It works");

};

See also

MovieClip.loadMovie() , loadMovieNum() , MovieClip.loadVariables() ,

MovieClip.unloadMovie() , unloadMovie() , unloadMovieNum()

variables An optional parameter specifying an HTTP method for sending variables The parameter must be the string GET or POST If there are no variables to be sent, omit this parameter The GET method appends the variables to the end of the URL and is used for small numbers of variables The POST method sends the variables in a separate HTTP header and is used for long strings of variables.

This method can also be used to update variables in the active movie clip with new values

This method requires that the text of the URL be in the standard MIME format:

application/x-www-form-urlencoded (CGI script format).

In SWF files running in a version earlier than Flash Player 7, url must be in the same

superdomain as the SWF file that is issuing this call A superdomain is derived by removing the left-most component of a file’s URL For example, a SWF file at www.someDomain.com can load data from a source at store.someDomain.com because both files are in the same superdomain of someDomain.com

In SWF files of any version running in Flash Player 7 or later, url must be in exactly the same

domain as the SWF file that is issuing this call (see “Flash Player security features” in Using

ActionScript in Flash) For example, a SWF file at www.someDomain.com can load data only

from sources that are also at www.someDomain.com If you want to load data from a different

domain, you can place a cross-domain policy file on the server hosting the data source that is being accessed For more information, see “About allowing cross-domain data loading” in Using

ActionScript in Flash

If you want to load variables into a specific level, use loadVariablesNum() instead of

loadVariables()