BGSOUND object (Object/HTML)

An object representing a <<BGSOUND>> HTML tag that defines an audio track to play while the page is displayed.

Availability:

JScript - 3.0
Internet Explorer - 4.0 (as HTML in IE 3.0)
Inherits from:Element object
JavaScript syntax:IEmyBGSOUND = myDocument.all.anElementID
IEmyBGSOUND = myDocument.all.tags("BGSOUND")[anIndex]
IEmyBGSOUND = myDocument.all[aName]
-myBGSOUND = myDocument.getElementById(anElementID)
-myBGSOUND = myDocument.getElementsByName(aName)[anIndex]
-myBGSOUND = myDocument.getElementsByTagName("BGSOUND")[anIndex]
HTML syntax:<BGSOUND>
Argument list:anIndexA valid reference to an item in the collection
aNameThe name attribute of an element
anElementIDThe ID attribute of an element
Object properties:balance, loop, src, volume
Event handlers:onClick, onDblClick, onHelp, onKeyDown, onKeyPress, onKeyUp, onMouseDown, onMouseMove, onMouseOut, onMouseOver, onMouseUp

This object is instantiated by the <<BGSOUND>> HTML tag and represents a sound effect that is to be played in the background. As the BGSOUND object is created during document loading and requires that a sound file be downloaded, there may some noticeable delay before the sound starts to play.

See also:Element object

PropertyJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
balance n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aReadOnly
loop n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
src n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
volume n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aReadOnly

Event nameJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
onClickn/a3.0 3.0n/a4.0 4.0n/a n/a n/a n/a n/a4.0 4.0Warning
onDblClickn/a3.0 3.0n/a4.0 4.0n/a n/a n/a n/a n/a4.0 4.0Warning
onHelp n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/aWarning
onKeyDownn/a3.0 3.0n/a4.0 4.0n/a n/a n/a n/a n/a4.0 4.0Warning
onKeyPressn/a3.0 3.0n/a4.0 4.0n/a n/a n/a n/a n/a4.0 4.0Warning
onKeyUpn/a3.0 3.0n/a4.0 4.0n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseDownn/a3.0 3.0n/a4.0 4.0n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseMoven/a3.0 3.0n/a4.0 4.0 n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseOutn/a 3.0 3.0n/a4.0 4.0n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseOvern/a 3.0 3.0n/a4.0 4.0n/a n/a n/a n/a n/a4.0 4.0Warning
onMouseUpn/a3.0 3.0n/a4.0 4.0n/a n/a n/a n/a n/a4.0 4.0Warning

Inheritance chain:

Element object, Node object