SequenceTimeNode Class

  • Article

Sequence Time Node.When the object is serialized out as xml, its qualified name is p:seq.

Inheritance Hierarchy

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

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(CommonTimeNode))> _
<ChildElementInfoAttribute(GetType(PreviousConditionList))> _
<ChildElementInfoAttribute(GetType(NextConditionList))> _
Public Class SequenceTimeNode _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As SequenceTimeNode

[ChildElementInfoAttribute(typeof(CommonTimeNode))]
[ChildElementInfoAttribute(typeof(PreviousConditionList))]
[ChildElementInfoAttribute(typeof(NextConditionList))]
public class SequenceTimeNode : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • CommonTimeNode <p:cTn>

  • PreviousConditionList <p:prevCondLst>

  • NextConditionList <p:nextCondLst>

[ISO/IEC 29500-1 1st Edition]

19.5.65 seq (Sequence Time Node)

This element describes the Sequence time node and it can only be activated when the one before it finishes. Conceptually it can be though of as follows:

DocumentFormat.OpenXml.Presentation.SequenceTimeNo

[Example: For example, suppose we have a simple animation with a blind entrance.

<p:timing>
  <p:tnLst>
    <p:par>
      <p:cTn id="1" dur="indefinite" restart="never" nodeType="tmRoot">
        <p:childTnLst>
          <p:seq concurrent="1" nextAc="seek">
            …
          </p:seq>
        </p:childTnLst>
      </p:cTn>
    </p:par>
  </p:tnLst>
</p:timing>

end example]

Parent Elements

childTnLst (§19.5.25); subTnLst (§19.5.78); tnLst (§19.5.87)

Child Elements

Subclause

cTn (Common Time Node Properties)

§19.5.33

nextCondLst (Next Conditions List)

§19.5.51

prevCondLst (Previous Conditions List)

§19.5.55

Attributes

Description

concurrent (Concurrent)

This attribute specifies if concurrency is enabled or disabled. By default this attribute has a value of "disabled". When the value is set to "enabled", the previous element is left enabled when advancing to the next element in a sequence instead of being ended. This is only relevant for advancing via the next condition element being triggered. The only other way to advance to the next element would be to have the current element end, which implies it is no longer concurrent.

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

nextAc (Next Action)

This attribute specifies what to do when going forward in sequence. By default this attribute has a value of "none". When this is set to seek it seeks the element to a natural end time (not necessarily the actual end time).

The natural end position is defined as the latest non-infinite end time of the children. If a child loops forever, the end of its first loop is used as its "end time" for the purposes of this calculation.

Some container elements can have infinite durations due to an infinite-duration child element. The engine needs to recurse down through all infinite duration containers to calculate their natural duration in case a child might have non-infinite duration within it that needs to be taken into account.

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

prevAc (Previous Action)

This attribute specifies what to do when going backwards in a sequence. By default it is set to "none" and nothing special is done. When the value is "skipTimed", the sequence continues to go backwards until it reaches a sequence element that was defined to begin only on the next condition element.

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

[Note: The W3C XML Schema definition of this element’s content model (CT_TLTimeNodeSequence) 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

SequenceTimeNode Members

DocumentFormat.OpenXml.Presentation Namespace