This documentation is archived and is not being maintained.

Iterate Class

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

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

public class Iterate : OpenXmlCompositeElement

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:cTn id="1" >
    <p:stCondLst> … </p:stCondLst>
    <p:iterate type="lt">
      <p:tmPct val="10000"/>
    <p:childTnLst> … </p:childTnLst>

end example]

Parent Elements

cTn (§19.5.33)

Child Elements


tmAbs (Time Absolute)


tmPct (Time Percentage)




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.

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