HTMLWindowEvents4::ontimeupdate Event

[This documentation is preliminary and is subject to change.]

Occurs to indicate the current playback position.

Syntax

void ontimeupdate(
    IHTMLEventObj *pEvtObj
);

Parameters

• pEvtObj
  [in] Pointer to an IHTMLEventObj interface for the current event. This is the same interface returned from IHTMLWindow2::event.

Return Value

No return value.

Event DISPID

DISPID_HTMLWINDOWEVENTS4_ONTIMEUPDATE

The DISPID for this event is defined in mshtmdid.h. Use this value to identify the event handler when implementing IDispatch::Invoke.

Event Information

Bubbles	No
Cancels	No
To invoke	Play the video. Move the position indicator on the playback controls.
Default action	N/A

Event Object Properties

The IHTMLEventObj interface contains additional information about the current event. When the ontimeupdate event is fired, you can use the IHTMLWindow2::event property to retrieve an IHTMLEventObj interface. To obtain an alternate interface pointer such as IHTMLEventObj2 or IHTMLEventObj3, call QueryInterface on the object.

Refer to the specific event object for additional event properties.

Remarks

Use the IHTMLMediaElement::currentTime property to retrieve the current playback position. For the total length of the audio or video clip, use IHTMLMediaElement::duration.

See Also

IHTMLMediaElement::currentTime, IHTMLMediaElement::duration, HTMLWindowEvents4::ondurationchange