Microsoft Producer for PowerPoint 2003 SDK banner art
PreviousNext

tocentry

The tocentry element allows an application to specify a table of contents entry linked to an absolute time on the timeline. The table of contents is a list of hyperlinks in the presentation screen that allow a viewer to jump to specific times in the presentation. A tocentry element immediately follows the sequence element it applies to, and links to the start time of that element on the timeline (with an optional offset, specified by the begintime attribute).

You may stack several of these elements sequentially in the XML, but unless you specify an offset time, they will all point to the same start time, that of the sequence element to which they are attached. Therefore, you may put them in any order in the XML, and they will be compiled correctly because each element should have a unique start time.

You can also attach a table of contents entry to a media element, by using a tocentryclip element. All tocentry and tocentryclip elements in the project are compiled into a single table of contents. You must handle the indentation to indicate subtopics, if you wish.

Syntax

<tocentry
    title="string value"
    indent="integer value"
    begintime="floating point value">
</tocentry>

Attributes

title (required)

Specifies the text that will appear as the table of contents entry.

indent (optional)

Indicates how many levels to indent the entry, from zero to 3, where zero is no indentation and 3 is the most indented.

begintime (optional)

A floating-point value indicating the number of seconds into the timeline from absolute time zero to anchor the link.

Example Code

The following sample code shows a video sequence and four slides. It adds four table of contents entries at zero, 10, 25, and 35 seconds in the timeline.

<sequence type="video">
    <media src="g:\projects\producer\my Video Files\Marketing Video.wmv" endtime="15" />
</sequence>

<sequence type="slides">
    <media src="g:\projects\producer\my Slides\My Slides.ppt" index="0" begintime="10"/>
    <media src="g:\projects\producer\my Slides\My Slides.ppt" index="1" begintime="25"/>
    <media src="g:\projects\producer\my Slides\My Slides.ppt" index="2" begintime="35"/>
    <media src="g:\projects\producer\my Slides\My Slides.ppt" index="7" begintime="45" endtime="55"/>
</sequence>

<tocentry title="The beginning"/>
<tocentry title="Slide 1" indent="1" begintime="10"/>
<tocentry title="Slide 2" indent="1" begintime="25"/>
<tocentry title="Slide 3" indent="1" begintime="35"/>

Parent/Child Elements

Hierarchy Elements
Parent sequence
Child None

See Also

PreviousNext


© 2001-2003 Microsoft Corporation. All rights reserved.