Sets or retrieves a value that starts the timeline of an element when the referenced event occurs.

Syntax

XML	<ELEMENT t:BEGINEVENT = sEventName... >
Scripting	object.beginEvent [ = sEventName ]

Possible Values

sEventName

String that specifies or receives one of the following values: event String that specifies a timing event or an event supported by the Dynamic HTML (DHTML) Object Model. none Default. Value that specifies the element's timeline is not started when a particular event occurs.

The property is read/write. The property has a default value of none.

Remarks

This property is deprecated. For similar functionality, refer to the begin property available with the time2 behavior.

This property supports interactive timing, where element timelines can begin in response to events from users, media players, or the presentation. You can offset the start time by specifying a nonzero value for the t:BEGIN attribute on the element. This indicates that the timeline should start a specified amount of time after the referenced event occurs. If the referenced event doesn't occur, the timeline on the current element does not start. This property cannot be used on the same element as the t:BEGINAFTER or t:BEGINWITH attribute.

To start the timeline on the current element, you can specify more than one event setting the t:BEGINEVENT attribute to a string containing a list of semicolon-separated events. For example, you would use the following code to cause the timeline to begin on the heading when either button is pressed:

<BUTTON ID="btn1">Button #1</BUTTON>
<BUTTON ID="btn2">Button #2</BUTTON>
.
.
.
<H1 CLASS="time" t:BEGINEVENT="btn1.onclick;btn2.onclick" t:DUR="5">
My Heading
</H1>

The t: prefix is used to associate this attribute with an XML namespace.

Standards Information

This property is defined in HTML+TIME (Timed Interactive Multimedia Extensions) 1.0 .

Applies To

	t:AUDIO, t:IMG, t:MEDIA, t:PAR, t:SEQ, time, t:VIDEO

See Also

t:BEGIN, t:BEGINAFTER, t:BEGINWITH, Introduction to HTML+TIME