9.9 Presentation Events
Many objects inside a presentation document support special
presentation events. For example, a user can advance the presentation one frame
when he clicks on an object with a corresponding event. Presentation events are
contained with a graphic object's event listener table. See section 9.2.21 for
details.
<define name="presentation-event-listener">
<element
name="presentation:event-listener">
<ref
name="presentation-event-listener-attlist"/>
<optional>
<ref
name="presentation-sound"/>
</optional>
</element>
</define>
Event Name
The script:event-name attribute
specifies the name of the event. See section
12.4.1 for details.
<define
name="presentation-event-listener-attlist"
combine="interleave">
<attribute
name="script:event-name">
<ref
name="string"/>
</attribute>
</define>
Event Action
The kind of action that is executed when the event is
triggered can be selected with the presentation:action
attribute. The following actions are available:
� none:
no action is performed when this event is triggered.
� previous-page:
the presentation jumps to the previous page.
� next-page:
the presentation jumps to the next page.
� first-page:
the presentation jumps to the first page of the current document.
� last-page:
the presentation jumps to the last page of the current document.
� hide:
the object that contains this event is hidden if the event is triggered.
� stop:
if a slide show is active, it will be stopped.
� execute:
another application is lunched when this event is triggered. The application
can be set with an xlink.
� show:
the target of an URL is opened when this event is triggered. The URL can be set
with an xlink.
� verb:
if the object that contains this event supports the execution of [OLE] verbs,
the verb with the id set in the presentation:verb
attribute is executed.
� fade-out:
the object that contains this event is faded out when this event is triggered.
The attributes presentation:effect, presentation:direction,
presentation:speed and presentation:start-scale
can be used to set the effect.
� sound:
an audio effect is started when the effect is triggered. The audio effect is
described by a <presentation:sound> child
element.
<define
name="presentation-event-listener-attlist"
combine="interleave">
<attribute
name="presentation:action">
<choice>
<value>none</value>
<value>previous-page</value>
<value>next-page</value>
<value>first-page</value>
<value>last-page</value>
<value>hide</value>
<value>stop</value>
<value>execute</value>
<value>show</value>
<value>verb</value>
<value>fade-out</value>
<value>sound</value>
</choice>
</attribute>
</define>
Event Effect
See presentation:effect
attribute in section 9.7.2.
<define
name="presentation-event-listener-attlist"
combine="interleave">
<optional>
<attribute
name="presentation:effect" a:defaultValue="none">
<ref
name="presentationEffects"/>
</attribute>
</optional>
</define>
Effect Direction
See presentation:direction
attribute in section 9.7.2.
<define
name="presentation-event-listener-attlist"
combine="interleave">
<optional>
<attribute
name="presentation:direction" a:defaultValue="none">
<ref
name="presentationEffectDirections"/>
</attribute>
</optional>
</define>
Effect Speed
See presentation:speed attribute
in section 9.7.2.
<define name="presentation-event-listener-attlist"
combine="interleave">
<optional>
<attribute
name="presentation:speed" a:defaultValue="medium">
<ref
name="presentationSpeeds"/>
</attribute>
</optional>
</define>
Start Scale
See presentation:start-scale
attribute in section 9.7.2.
<define
name="presentation-event-listener-attlist"
combine="interleave">
<optional>
<attribute
name="presentation:start-scale" a:defaultValue="100%">
<ref
name="percent"/>
</attribute>
</optional>
</define>
Link
Depending on the action selected by the presentation:action attribute, this xlink:href attribute either selects a document bookmark
or an application.
<define
name="presentation-event-listener-attlist"
combine="interleave">
<optional>
<attribute
name="xlink:href">
<ref
name="anyURI"/>
</attribute>
</optional>
<optional>
<attribute
name="xlink:type" a:defaultValue="simple">
<choice>
<value>simple</value>
</choice>
</attribute>
</optional>
<optional>
<attribute
name="xlink:show" a:defaultValue="embed">
<choice>
<value>embed</value>
</choice>
</attribute>
</optional>
<optional>
<attribute
name="xlink:actuate" a:defaultValue="onRequest">
<choice>
<value>onRequest</value>
</choice>
</attribute>
</optional>
</define>
Verb
The [OLE] verb defined by the presentation:verb
attribute is executed for event listeners of type verb
at the object that contains this event.
<define
name="presentation-event-listener-attlist"
combine="interleave">
<optional>
<attribute
name="presentation:verb">
<ref name="nonNegativeInteger"/>
</attribute>
</optional>
</define>