beautypg.com

Document.addnewline() – Adobe Extending Flash Professional CS4 User Manual

Page 88

background image

66

EXTENDING FLASH CS4 PROFESSIONAL

Document object

item

An Item object that specifies the item to add and the library from which to add it (see

Item object

).

Returns
A Boolean value:

true

if successful;

false

otherwise.

Description
Method; adds an item from any open document or library to the specified Document object.

Example
The following example adds the first item from the library to the first document at the specified location for the
selected symbol, bitmap, or video:

var item = fl.documents[0].library.items[0];

fl.documents[0].addItem({x:0,y:0}, item);

The following example adds the symbol

myMovieClip

from the current document’s library to the current document:

var itemIndex = fl.getDocumentDOM().library.findItemIndex("myMovieClip");

var theItem = fl.getDocumentDOM().library.items[itemIndex];

fl.getDocumentDOM().addItem({x:0,y:0}, theItem);

The following example adds the symbol

myMovieClip

from the second document in the documents array to the third

document in the documents array:

var itemIndex = fl.documents[1].library.findItemIndex("myMovieClip");

var theItem = fl.documents[1].library.items[itemIndex];

fl.documents[2].addItem({x:0,y:0}, theItem);

document.addNewLine()

Availability
Flash MX 2004.

Usage

document.addNewLine(startPoint, endpoint)

Parameters

startpoint

A pair of floating-point numbers that specify the x and y coordinates where the line starts.

endpoint

A pair of floating-point numbers that specify the x and y coordinates where the line ends.

Returns
Nothing.

Description
Method; adds a new path between two points. The method uses the document’s current stroke attributes and adds the
path on the current frame and current layer. This method works in the same way as clicking on the line tool and
drawing a line.