t:REF Element | ref Object

HTML (DHTML)

t:REF Element | ref Object

Internet Development Index

Defines a reference to a generic timed element in an HTML document.

Members Table

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

Attributes/Properties

AttributePropertyDescription
abstract Retrieves a description of the media file.
ACCELERATEaccelerate Sets or retrieves a value that applies an acceleration to an element's timeline.
author Retrieves the name of the media file's author.
AUTOREVERSEautoReverse Sets or retrieves whether the timeline on an element begins playing in reverse immediately after completing in the forward direction.
Banner   Retrieves the Banner content of an entry in an Advanced Stream Redirector (ASX) file.
BannerAbstract   Retrieves the BannerAbstract content of an entry in an ASX file.
BannerMoreInfo   Retrieves the BannerMoreInfo content of an entry in an ASX file.
BEGINbegin Sets or retrieves the delay time before the timeline begins playing on the element.
boundary Sets when music should begin to play by using Microsoft DirectMusic?
bufferingProgress   Retrieves a value that indicates the current percentage of buffering completed.
canPause Retrieves a value that indicates whether the media file can be paused.
canSeek Retrieves a value that indicates whether the media file is capable of locating a specific time in the media's duration.
CLIPBEGINclipBegin Sets or retrieves the beginning point of a sub-clip of a continuous media object.
CLIPENDclipEnd Sets or retrieves the end point of a sub-clip of a continuous media object.
copyright Retrieves the copyright information associated with a media file.
currentFrame Retrieves a value that indicates the currentFrame of the object.
DECELERATEdecelerate Sets or retrieves a value that applies a deceleration to the end of a simple duration.
downloadCurrent   Retrieves a value that indicates the current number of bytes downloaded from streaming content.
downloadTotal   Retrieves a value that indicates the total size of the file (in bytes) downloaded.
DURdur Sets or retrieves a value indicating the amount of time the element remains active or displayed.
ENDend Sets or retrieves a value indicating the end time for the element, or the end of the simple duration when the element is set to repeat.
FILLfill Sets or retrieves the action an element takes if its timeline ends before the timeline on its parent element ends.
hasAudio Retrieves a Boolean value that indicates whether the media contains audio.
hasDownloadProgress   Retrieves a Boolean value that indicates whether a media file has begun to download.
hasMedia Retrieves a Boolean value that indicates whether the element is an Introduction to HTML+TIME media element.
hasPlayList Retrieves a Boolean value that indicates whether the element has a playList collection.
hasVisual Retrieves a Boolean value that indicates whether the element can draw on the screen.
immediateEnd Sets a value that indicates whether a DirectMusic segment ends immediately or plays a transition before ending.
isStreamed   Retrieves a Boolean value that indicates if the source of the media object is streamed.
latestMediaTime   Retrieves a value that indicates the amount of time it takes for a media object to begin playing.
longTransition Sets whether to allow introduction and ending transitions longer than one bar with DirectMusic.
mediaDur Retrieves the duration of the element's media file.
mediaHeight Retrieves the height of the element.
mediaWidth Retrieves the width of the element.
mimeType   Retrieves the MIME content-type of the object.
modulate Sets whether to attempt to modulate between keys when playing transitions with DirectMusic.
motifName Sets the name of the DirectMusic motif to play.
MUTEmute Sets or retrieves a value that indicates whether the audio is turned on or off.
PLAYERplayer Sets or retrieves the object used to render the media associated with this element.
playerObject Retrieves the object that plays media files.
rating Retrieves the rating of the media file.
REPEATCOUNTrepeatCount Sets or retrieves the number of times an element's timeline repeats.
REPEATDURrepeatDur Sets or retrieves the number of seconds that an element's timeline repeats.
RESTARTrestart Sets or retrieves the conditions under which an element can be restarted on a timeline.
segmentType Sets whether to play a DirectMusic segment as a controlling or secondary segment.
SPEEDspeed Sets or retrieves the playback speed of an element relative to its parent time container.
SRCsrc Sets or retrieves the source URL of the media.
SYNCBEHAVIORsyncBehavior Sets or retrieves a value that indicates the synchronization rules for the element's timeline.
SYNCMASTERsyncMaster Sets or retrieves whether the time container must synchronize playback to this element.
syncTolerance Sets or retrieves the time variance allowed on a timeline with locked synchronization.
systemBitrate Retrieves the approximate bandwidth available to the system in bits-per-second.
systemCaptions Indicates whether or not to display a text equivalent of the audio portion of the presentation.
systemLanguage Indicates whether a given language is selected in a user's system preferences.
systemOverdubOrSubtitle Specifies whether overdubs or subtitles render during a presentation.
TIMEACTIONtimeAction Sets or retrieves what action is taken on the element while the timeline is active.
TIMECONTAINERtimeContainer Sets or retrieves the type of timeline associated with an element.
timeParent Retrieves the parent time container element of the current element.
title Retrieves the title of the media file.
TRANSITIONTYPE Sets or retrieves the type of DirectMusic transition to use between segments.
TYPEtype Sets or retrieves the MIME type of the media object referenced by the SRC attribute.
UPDATEMODE  updateMode Specifies or retrieves a value that indicates how the object is to be updated.
VOLUMEvolume Sets or retrieves the volume of the media file.

Collections

CollectionDescription
playList Retrieves a collection of playItem objects.

Events

EventDescription
onbegin Fires when the timeline starts on an element.
onend Fires when the timeline stops on an element.
onmediacomplete Fires when the element's associated media finish loading.
onmediaerror Fires when an element's media file causes any error.
onoutofsync Fires when the element loses synchronization with its associated timeline.
onpause Fires when the timeline on an element pauses.
onrepeat Fires when the timeline repeats on an element, beginning with the second iteration.
onreset Fires when the timeline reaches the value of the BEGIN attribute or when the resetElement method is called on the element.
onresume Fires when an element's timeline resumes from a paused state.
onreverse Fires when the timeline on an element begins to play backward.
onseek Fires whenever a seek operation is performed on the element.
onsyncrestored Fires when synchronization is resumed between the element and its associated timeline.
ontrackchange   The event fires when a track changes in a playList defined in an ASX file.

Methods

MethodDescription
activeTimeToParentTime Converts a value in the element's active timeline to the corresponding point in the parent timeline.
activeTimeToSegmentTime Converts a value in the element's active timeline to the corresponding point in the segment timeline.
beginElement Starts the element on the timeline.
beginElementAt Starts an element's timeline at the specified time.
documentTimeToParentTime Converts a value in the document timeline to the corresponding point in the element's parent timeline.
endElement Stops the element on the timeline.
endElementAt Ends an element's timeline at the specified time.
nextTrack Advances the media-playing container to the next track, or playItem object, in the playList collection, and begins playing that track.
parentTimeToActiveTime Converts a value in the parent timeline to the corresponding point in the element's active timeline.
parentTimeToDocumentTime Converts a value in the element's parent timeline to the corresponding point in the document timeline.
pauseElement Stops playing an element's timeline at the current point.
prevTrack Sets the media-playing container to the previous track, or playItem object, in the playList collection and begins playing that track.
resetElement Removes any changes made to the element and returns the element to its original state.
resumeElement Restarts the element's timeline from a paused state.
seekActiveTime Locates a specified point on the element's active timeline and begins playing from that point.
seekSegmentTime Locates the specified point on the element's segment timeline, and begins playing from that point.
seekTo Locates a specified point on the element's segment timeline, including repetitions, and begins playing from that point.
seekToFrame Locates a specified frame in the object.
segmentTimeToActiveTime Converts a value in the element's segment timeline to the corresponding point in the element's active timeline.
segmentTimeToSimpleTime Converts a value in the element's segment timeline to the corresponding point in the element's simple timeline.
simpleTimeToSegmentTime Converts a value in the element's simple timeline to the corresponding point in the element's segment timeline.

Objects

ObjectDescription
currTimeState Contains information about an HTML+TIME timeline.

Remarks

Although different media-based elements exist, there is no functional difference in their current implementation. However, you are encouraged to use elements such as t:ANIMATION, t:AUDIO, t:IMG, t:MEDIA, t:REF, and t:VIDEO for improved document readability and enhanced support.

The prefix t: is used to associate this element with an Extensible Markup Language (XML) namespace. You must declare the XML namespace in the html tag of your document when using this element.

<HTML XMLNS:t ="urn:schemas-microsoft-com:time">

You must then import the tag definitions from the time2 behavior by using the IMPORT processing instruction.

<?IMPORT namespace="t" implementation="#default#time2">

The members listed in the following table might not be accessible through scripting until the window.onload event fires. Waiting for this event to fire ensures that the page is completely loaded, that all behaviors have been applied to corresponding elements on the page, and that all the behavior's properties, methods, and events are available for scripting. Using any of the behavior-defined members before the window.onload event fires could result in a scripting error, indicating that the object does not support that particular member.

Media elements with timed children should have their TIMECONTAINER attribute set to par for Synchronized Multimedia Integration Language (SMIL) 2.0 Non-Microsoft link compatibility. Currently, media elements such as t:ANIMATION, t:AUDIO, t:IMG, t:MEDIA, t:REF, and t:VIDEO do not treat their child elements as parallel but the SMIL 2.0 specification says that media elements with timed children should be parallel. Setting this value now may prevent incompatibilities.

This element is not rendered.

This element requires a closing tag.

Standards Information

This object is defined in SMIL 2.0 Non-Microsoft link.

See Also

Introduction to DHTML Behaviors, Introduction to HTML+TIME, time2, Using DHTML Behaviors