Document.setstagevanishingpoint() – Adobe Extending Flash Professional CS5 User Manual

Page 174

152

EXTENDING FLASH PROFESSIONAL

Document object

Last updated 5/2/2011

bContactSensitiveSelection

A Boolean value that specifies whether the Contact Sensitive selection mode is

enabled (

true

) or disabled (

false

) during object selection. The default value is

false

Returns
Nothing.

Description
Method; draws a rectangular selection marquee relative to the Stage, using the specified coordinates. This is unlike

document.getSelectionRect()

, in which the rectangle is relative to the object being edited.

This method is equivalent to dragging a rectangle with the Selection tool. An instance must be fully enclosed by the
rectangle to be selected.

If you pass a value for bContactSensitiveSelection, it is valid only for this method and doesn’t affect the Contact
Sensitive selection mode for the document (see

fl.contactSensitiveSelection

Note: Repeating

setSelectionRect()

using the History panel or menu item repeats the step previous to the

setSelectionRect()

operation.

Example
In the following example, the second selection replaces the first one:

fl.getDocumentDOM().setSelectionRect({left:1, top:1, right:200, bottom:200});

fl.getDocumentDOM().setSelectionRect({left:364.0, top:203.0, right:508.0, bottom:434.0},

true);

In the following example, the second selection is added to the first selection. This is the same as the manual operation
of holding down Shift and selecting a second object.

fl.getDocumentDOM().setSelectionRect({left:1, top:1, right:200, bottom:200});

fl.getDocumentDOM().setSelectionRect({left:364.0, top:203.0, right:508.0, bottom:434.0},

false);

See also

document.getSelectionRect()

document.selection

document.setSelectionBounds()

document.setStageVanishingPoint()

Availability
Flash CS4 Professional.

Usage

document.setStageVanishingPoint(point)

Parameters