Timelines Design-Time Control

The Timelines control allows you to specify when events on your Web page occur by defining single or multiple timeline objects.

You can use this control to:

• Make timeline objects available on the page for scripting.
  
  
• Specify a timeline that determines when a single event or a set of events occurs.
  
  
• Set the timeline to play automatically when the page is loaded. After adding this control to your page, you can also use script to start, stop, or pause the timeline due to a user action, like clicking on a button.

For each timeline, you can associate a set of events and set parameters for the time the event plays.

You can specify three types of events within a timeline:

• Discrete events that play once and then stop.
  
  
• Looping events that play multiple times for a limited duration within the timeline.
  
  
• Continuous events that play for the duration of the timeline. Duration is calculated by multiplying Loop minus one times Interval ([Loop -1] * Interval).

To add a timeline to your Web page, you can drag the Timelines control from the Toolbox in the HTML editor and specify properties and events for timeline objects in the Timelines Properties dialog box.

Remarks

Timeline objects and events are design-time only constructs. After you create timelines, use the Source view of the HTML editor and add a function for each event specified in the timelines. If you don't specify a function for each event named in the timeline, the page will generate errors.

You can also control the timeline by using the same events and methods used by the Sequencer object. For more information about the Sequencer object, see the Internet SDK documentation.

Note   You can add only one Timelines control on a page. All the timelines for that page must be defined in that control.

You can use events specified in the timeline to perform the following:

• Call methods on ActiveX^® controls, applet objects, Dynamic HTML objects, and intrinsic controls.
  
  
• Change properties for ActiveX controls, applet objects, Dynamic HTML objects, and intrinsic controls.
  
  
• Script procedures or functions.

Example

After adding the Timelines control, add script that specifies the events you named in the control's property pages.

For example, the control in the figure below has two timelines specified. TimeLine1 has two events, ActionA and ActionB. TimeLine2 has only ActionX. To simplify the example, the events cause an alert to appear.