Microsoft Developer Network

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

Members Table

The following table lists the members exposed by the bgSound object.

Attributes/Properties

Show: Attributes/Properties Behaviors Collections Events Methods Styles

Attribute Property Description ariaBusy   Sets or retrieves the busy state of this element. ariaChecked   Sets or retrieves the checked state of this element. ariaDisabled   Sets or retrieves the disabled state of this element. ariaExpanded   Sets or retrieves the expanded state of this element. ariaHaspopup   Sets or retrieves a value indicating whether this element may display a pop-up window. ariaHidden   Sets or retrieves the hidden state of this element. ariaInvalid   Sets or retrieves the invalid state of this element. ariaLevel   Sets or retrieves the level of this element. ariaMultiselect   Sets or retrieves the multiple-selection state of this element. ariaPosinset   Sets or retrieves the current position of an item within a set. ariaPressed   Sets or retrieves the pressed state of a button that can be toggled. ariaReadonly   Sets or retrieves the read-only state of this element. ariaRequired   Sets or retrieves the form-completion requirement of this element. ariaSecret   Sets or retrieves the secret state of this element. ariaSelected   Sets or retrieves the selection state of this element. ariaSetsize   Sets or retrieves the set size of this element. attributes   Retrieves a collection of attributes of the object. BALANCE balance Sets or gets the value indicating how the volume of the background sound is divided between the left speaker and the right speaker. canHaveHTML Sets or retrieves the value indicating whether the object can contain rich HTML markup. ID id Retrieves the string identifying the object. isContentEditable Gets the value that indicates whether the user can edit the contents of the object. isDisabled Gets the value that indicates 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. role   Sets or retrieves the role for this element. scopeName Gets 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 gets the URL of a sound to play. tagName Retrieves the tag name of the object. tagUrn Sets or gets the Uniform Resource Name (URN) specified in the namespace declaration. uniqueID Retrieves an autogenerated, unique identifier for the object. VOLUME volume Sets or gets the volume setting for the sound. Behavior Description clientCaps Provides information about features supported by 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. 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. 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. 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. getAttribute Retrieves the value of the specified attribute. getAttributeNode Gets an attribute object referenced by the attribute.name property. getElementsByTagName Retrieves a collection of objects based on the specified element name. hasAttribute   Determines whether an attribute with the specified name exists. 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. 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. 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. Style attribute Style property Description behavior behavior Sets or retrieves the location of the Dynamic HTML (DHTML) behavior. 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 not rendered.

This element does not require a closing tag.

Standards Information

This object is a Microsoft extension to HTML .