Iterate Class

Iterate.When the object is serialized out as xml, its qualified name is p:iterate.

Inheritance Hierarchy

System.Object
  DocumentFormat.OpenXml.OpenXmlElement
    DocumentFormat.OpenXml.OpenXmlCompositeElement
      DocumentFormat.OpenXml.Presentation.Iterate

Namespace:  DocumentFormat.OpenXml.Presentation
Assembly:  DocumentFormat.OpenXml (in DocumentFormat.OpenXml.dll)

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(TimeAbsolute))> _
<ChildElementInfoAttribute(GetType(TimePercentage))> _
Public Class Iterate _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As Iterate
[ChildElementInfoAttribute(typeof(TimeAbsolute))]
[ChildElementInfoAttribute(typeof(TimePercentage))]
public class Iterate : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • TimeAbsolute <p:tmAbs>

  • TimePercentage <p:tmPct>

[ISO/IEC 29500-1 1st Edition]

19.5.49 iterate (Iterate)

This element specifies how the animation should be successively applied to sub elements of the target element for a repeated effect. It can be applied to contained timing and animation structures over the letters, words, or shapes within a target element.

[Example: Consider a text animation where the words appear letter by letter. The <iterate> element should be used as follows:

<p:par>
  <p:cTn id="1" >
    <p:stCondLst> … </p:stCondLst>
    <p:iterate type="lt">
      <p:tmPct val="10000"/>
    </p:iterate>
    <p:childTnLst> … </p:childTnLst>
  </p:cTn>
</p:par>

end example]

Parent Elements

cTn (§19.5.33)

Child Elements

Subclause

tmAbs (Time Absolute)

§19.5.82

tmPct (Time Percentage)

§19.5.83

Attributes

Description

backwards (Backwards)

This attribute specifies whether to go backwards in the timeline to the previous node.

The possible values for this attribute are defined by the W3C XML Schema boolean datatype.

type (Iterate Type)

This attribute specifies the iteration behavior and applies it to each letter, word or shape within a container element.

Values are by word, by letter, or by element. If there is no text or block elements such as shapes within the container or a single word, letter, or shape (depending on iterate type) then no iteration happens and the behavior is applied to the element itself instead.

The possible values for this attribute are defined by the ST_IterateType simple type (§19.7.4).

[Note: The W3C XML Schema definition of this element’s content model (CT_TLIterateData) is located in §A.3. end note]

© ISO/IEC29500: 2008.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Iterate Members

DocumentFormat.OpenXml.Presentation Namespace