Sound.stop( ) Method

ActionScript for Flash MX: The Definitive Guide, 2nd Edition
By Colin Moock
Chapter 18.  ActionScript Language Reference
Sound.stop( ) Method Flash 5

silence all sounds or a specified attached or loaded sound
soundObject.stop() soundObject.stop(linkageIdentifier)

Arguments

linkageIdentifier

The name of any sound attached to any Sound object with the same target as soundObject. Linkage identifiers are specified in the Library under Options figs/u2192.gif Linkage.

Description

When invoked without a linkageIdentifier, stop( ) silences all sounds controlled by soundObject; if soundObject is a global sound, stop( ) silences all sounds in a movie; if soundObject was created with a target parameter, stop( ) silences all sounds in target.

When invoked with a linkageIdentifier, stop( ) silences only the specific sound named by linkageIdentifier. In that case, linkageIdentifier must be a sound that was attached to a Sound object via attachSound( ). However, the sound to stop need not be attached to soundObject itself. It can be attached to any Sound object that shares the same target as soundObject. Or, if soundObject was created with no target (i.e., is a global Sound object), the sound to stop can be attached to any other global Sound object.

Example

// Create a global Sound object mySound = new Sound();     // Attach the sound doorbell to the object mySound.attachSound("doorbell");     // Stop all sounds in the movie mySound.stop();     // Play doorbell mySound.start();     // Stop just doorbell mySound.stop("doorbell");     // Create another global Sound object myOtherSound = new Sound();     // Attach a doorknock sound to the object myOtherSound.attachSound("doorknock");     // Play doorknock myOtherSound.start();     // Now stop the doorknock through mySound, not myOtherSound. // This works because the two Sound objects have the same target. mySound.stop("doorknock");

See Also

Sound.attachSound( ), Sound.start( ), stopAllSounds( )



    ActionScript for Flash MX. The Definitive Guide
    ActionScript for Flash MX: The Definitive Guide, Second Edition
    ISBN: 059600396X
    EAN: 2147483647
    Year: 2002
    Pages: 780
    Authors: Colin Moock

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net