Share via

AnimateMotion Class

  • Article

Animate Motion.When the object is serialized out as xml, its qualified name is p:animMotion.

Inheritance Hierarchy

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

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

Syntax

'Declaration
<ChildElementInfoAttribute(GetType(CommonBehavior))> _
<ChildElementInfoAttribute(GetType(FromPosition))> _
<ChildElementInfoAttribute(GetType(ByPosition))> _
<ChildElementInfoAttribute(GetType(ToPosition))> _
<ChildElementInfoAttribute(GetType(RotationCenter))> _
Public Class AnimateMotion _
    Inherits OpenXmlCompositeElement
'Usage
Dim instance As AnimateMotion

[ChildElementInfoAttribute(typeof(CommonBehavior))]
[ChildElementInfoAttribute(typeof(FromPosition))]
[ChildElementInfoAttribute(typeof(ByPosition))]
[ChildElementInfoAttribute(typeof(ToPosition))]
[ChildElementInfoAttribute(typeof(RotationCenter))]
public class AnimateMotion : OpenXmlCompositeElement

Remarks

The following table lists the possible child types:

  • CommonBehavior <p:cBhvr>

  • ByPosition <p:by>

  • FromPosition <p:from>

  • ToPosition <p:to>

  • RotationCenter <p:rCtr>

[ISO/IEC 29500-1 1st Edition]

19.5.4 animMotion (Animate Motion)

Animate motion provides an abstracted way to move positioned elements. It provides the ability to specify from/to/by motion as well as to use more detailed path descriptions for motion over polylines or bezier curves.

[Example: Consider animating a shape from its original position to the right.. The <animMotion> element should be used as follows:

<p:animMotion origin="layout" path="M 0 0 L 0.25 0 E" pathEditMode="relative">
  <p:cBhvr>
    <p:cTn id="1" dur="2000" fill="hold"/>
    <p:tgtEl>
      <p:spTgt spid="1"/>
    </p:tgtEl>
    <p:attrNameLst>
      <p:attrName>ppt_x</p:attrName>
      <p:attrName>ppt_y</p:attrName>
    </p:attrNameLst>
  </p:cBhvr>
</p:animMotion>

end example]

Parent Elements

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

Child Elements

Subclause

by (By)

§19.5.21

cBhvr (Common Behavior)

§19.5.22

from (From)

§19.5.44

rCtr (Rotation Center)

§19.5.62

to (To)

§19.5.88

Attributes

Description

origin (Origin)

Specifies what the origin of the motion path is relative to such as the layout of the slide, or the parent.

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

path (Path)

Specifies the path primitive followed by coordinates for the animation motion. The allowed values that are understood within a path are as follows:

M = move to, L = line to, C = curve to, Z=close loop, E=end

UPPERCASE = absolute coords, lowercase = relative coords

Thus total allowed set = {M,L,C,Z,E,m,l,c,z,e)

[Example: The following string is a sample path.

path: “M 0 0 L 1 1 c 1 2 3 4 4 4 Z”

end example]

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

pathEditMode (Path Edit Mode)

This attribute specifies how the motion path moves when the target element is moved.

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

ptsTypes (Points Types)

This attribute describes the point type of the points in the path attribute. The allowed values that are understood for the ptsTypes attribute are as follows:

A = Auto, F = Corner, T = Straight, S = Smooth

UPPERCASE = Straight Line follows point, lowercase = curve follows point.

Thus, the total allowed set = {A,F,T,S,a,f,t,s}

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

rAng (Relative Angle)

The attribute describes the relative angle of the motion path.

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

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

AnimateMotion Members

DocumentFormat.OpenXml.Presentation Namespace