03.05.2013 Views

FLASH® LITE™ 2.x - Adobe Help and Support

FLASH® LITE™ 2.x - Adobe Help and Support

FLASH® LITE™ 2.x - Adobe Help and Support

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

The setMask() method allows multiple-frame movie clips with complex, multilayered<br />

content to act as masks (which is possible by using mask layers). If you have device fonts in a<br />

masked movie clip, they are drawn but not masked. You can't set a movie clip to be its own<br />

maskfor example, my_mc.setMask(my_mc).<br />

If you create a mask layer that contains a movie clip, <strong>and</strong> then apply the setMask() method<br />

to it, the setMask() call takes priority <strong>and</strong> this is not reversible. For example, you could have<br />

a movie clip in a mask layer called UIMask that masks another layer that contains another<br />

movie clip called UIMaskee. If, as the SWF file plays, you call UIMask.setMask(UIMaskee),<br />

from that point on, UIMask is masked by UIMaskee.<br />

To cancel a mask created with ActionScript, pass the value null to the setMask() method.<br />

The following code cancels the mask without affecting the mask layer in the Timeline.<br />

UIMask.setMask(null);<br />

You can extend the methods <strong>and</strong> event h<strong>and</strong>lers of the MovieClip class by creating a subclass.<br />

Parameters<br />

mc:Object - The instance name of a movie clip to be a mask. This can be a String or a<br />

MovieClip.<br />

Example<br />

The following code uses the circleMask_mc movie clip to mask the theMaskee_mc movie<br />

clip:<br />

theMaskee_mc.setMask(circleMask_mc);<br />

_soundbuftime (MovieClip._soundbuftime property)<br />

public _soundbuftime : Number<br />

Specifies the number of seconds a sound prebuffers before it starts to stream.<br />

Note: Although you can specify this property for a MovieClip object, it is actually a global<br />

property that applies to all sounds loaded, <strong>and</strong> you can specify its value simply as<br />

_soundbuftime. Setting this property for a MovieClip object actually sets the global property.<br />

See also<br />

_soundbuftime property<br />

startDrag (MovieClip.startDrag method)<br />

public startDrag([lockCenter:Boolean], [left:Number], [top:Number],<br />

[right:Number], [bottom:Number]) : Void<br />

466 ActionScript classes

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!