User Guide

136 Chapter 3: Objects
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.
Description
Method; erases what was previously drawn using the drawingLayer and prepares for more drawing
commands. Should be called after
drawingLayer.beginDraw(). Everything drawn between
drawingLayer.beginFrame() and an drawingLayer.endFrame() remains on the Stage until
you call the next
beginFrame() and endFrame(). (In this context, frame refers to where you start
and end drawing; it does not refer to Timeline frames.) You typically use this method only when
creating extensible tools.