MACROMEDIA FLASH 8-EXTENDING FLASH, Manual

Page: 178 / 554

178 Objects
drawingLayer.beginDraw()
Availability
Flash MX 2004.
Usage
drawingLayer.beginDraw([ persistentDraw ])
Parameters
persistentDraw
A Boolean value (optional). If set to
true
, it indicates that the drawing in
the last frame remains on the Stage until a new
beginDraw()
or
beginFrame()
call is made.
(In this context, frame refers to where you start and end drawing; it does not refer to timeline
frames.) For example, when users draw a rectangle, they can preview the outline of the shape
while dragging the mouse. If you want that preview shape to remain after the user releases the
mouse button, set
persistentDraw
to
true
.
Returns
Nothing.
Description
Method; puts Flash in drawing mode. Drawing mode is used for temporary drawing while the
mouse button is pressed. You typically use this method only when creating extensible tools.
Example
The following example puts Flash in drawing mode:
fl.drawingLayer.beginDraw();
drawingLayer.beginFrame()
Availability
Flash MX 2004.
Usage
drawingLayer.beginFrame()
Parameters
None.
Returns
Nothing.