BGSOUND Element | bgSound Object

Enables an author to create pages with background sounds or soundtracks.

Members Table

The following table lists the members exposed by the bgSound object. Click a tab on the left to choose the type of member you want to view.

Attributes/Properties

Attribute	Property	Description
BALANCE	balance	Sets or retrieves the value indicating how the volume of the background sound is divided between the left and right speakers.
	canHaveHTML	Sets or retrieves the value indicating whether the object can contain rich HTML markup.
	disabled	Sets or retrieves the value that indicates whether the user can interact with the object.
ID	id	Retrieves the string identifying the object.
	isContentEditable	Retrieves the value indicating whether the user can edit the contents of the object.
	isDisabled	Retrieves the value indicating whether the user can interact with the object.
	isMultiLine	Retrieves the value indicating whether the content of the object contains one or more lines.
LOOP	loop	Sets or retrieves the number of times a sound or video clip will loop when activated.
	nextSibling	Retrieves a reference to the next child of the parent for the object.
	nodeName	Retrieves the name of a particular type of node.
	nodeType	Retrieves the type of the requested node.
	nodeValue	Sets or retrieves the value of a node.
	outerHTML	Sets or retrieves the object and its content in HTML.
	outerText	Sets or retrieves the text of the object.
	parentElement	Retrieves the parent object in the object hierarchy.
	parentNode	Retrieves the parent object in the document hierarchy.
	parentTextEdit	Retrieves the container object in the document hierarchy that can be used to create a TextRange containing the original object.
	previousSibling	Retrieves a reference to the previous child of the parent for the object.
	readyState	Retrieves the current state of the object.
	scopeName	Retrieves the namespace defined for the element.
	sourceIndex	Retrieves the ordinal position of the object, in source order, as the object appears in the document's all collection.
SRC	src	Sets or retrieves the URL of a sound to play.
	tagName	Retrieves the tag name of the object.
	tagUrn	Sets or retrieves the Uniform Resource Name (URN) specified in the namespace declaration.
	uniqueID	Retrieves an autogenerated, unique identifier for the object.
VOLUME	volume	Sets or retrieves the volume setting for the sound.

Behaviors

Behavior	Description
clientCaps	Provides information about features supported by Microsoft® Internet Explorer, as well as a way for installing browser components on demand.
download	Downloads a file and notifies a specified callback function when the download is complete.
homePage	Contains information about a user's homepage.

Collections

Collection	Description
all	Returns a reference to the collection of elements contained by the object.
attributes	Retrieves a collection of attributes of the object.
behaviorUrns	Returns a collection of Uniform Resource Name (URN) strings identifying the behaviors attached to the element.

Events

Event	Description
onlayoutcomplete	Fires when the print or print preview layout process finishes filling the current LayoutRect object with content from the source document.
onmouseenter	Fires when the user moves the mouse pointer into the object.
onmouseleave	Fires when the user moves the mouse pointer outside the boundaries of the object.
onreadystatechange	Fires when the state of the object has changed.

Methods

Method	Description
addBehavior	Attaches a behavior to the element.
applyElement	Makes the element either a child or parent of another element.
attachEvent	Binds the specified function to an event, so that the function gets called whenever the event fires on the object.
clearAttributes	Removes all attributes and values from the object.
cloneNode	Copies a reference to the object from the document hierarchy.
componentFromPoint	Returns the component located at the specified coordinates via certain events.
detachEvent	Unbinds the specified function from the event, so that the function stops receiving notifications when the event fires.
dragDrop	Initiates a drag event.
fireEvent	Fires a specified event on the object.
getAttribute	Retrieves the value of the specified attribute.
getAttributeNode	Retrieves an attribute object referenced by the attribute.name property.
getElementsByTagName	Retrieves a collection of objects based on the specified element name.
insertAdjacentElement	Inserts an element at the specified location.
mergeAttributes	Copies all read/write attributes to the specified element.
normalize	Merges adjacent TextNode objects to produce a normalized document object model.
removeAttribute	Removes the given attribute from the object.
removeAttributeNode	Removes an attribute object from the object.
removeBehavior	Detaches a behavior from the element.
setAttribute	Sets the value of the specified attribute.
setAttributeNode	Sets an attribute object node as part of the object.
swapNode	Exchanges the location of two objects in the document hierarchy.

Styles

Style attribute	Style property	Description
behavior	behavior	Sets or retrieves the location of the Introduction to DHTML Behaviors.
text-autospace	textAutospace	Sets or retrieves the autospacing and narrow space width adjustment of text.
text-underline-position	textUnderlinePosition	Sets or retrieves the position of the underline decoration that is set through the textDecoration property of the object.

Remarks

The BGSOUND element can appear anywhere within the document.

This element is available in HTML as of Internet Explorer 3.0, and in script as of Internet Explorer 4.0.

This element is not rendered.

This element does not require a closing tag.

Standards Information

object is a Microsoft extension to HTML .