KeyTime Structure
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Specifies when a particular key frame should take place during an animation.
Assembly: System.Windows (in System.Windows.dll)
XMLNS for XAML: Not mapped to an xmlns.
The KeyTime type exposes the following members.
| Name | Description | |
|---|---|---|
 | TimeSpan | Gets the time when the key frame ends, expressed as a time relative to the beginning of the animation. |
| Type | Gets the KeyTimeType value this instance represents. |
 | Uniform | Gets a uniform value, which divides the allotted time of the animation evenly between key frames. |
| Name | Description | |
|---|---|---|
 | Equals(KeyTime) | Indicates whether a specified KeyTime is equal to this KeyTime. |
| Equals(Object) | Indicates whether a KeyTime is equal to this KeyTime. (Overrides ValueType::Equals(Object).) |
| Equals(KeyTime, KeyTime) | Indicates whether two KeyTime values are equal. |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
| FromTimeSpan | Creates a new KeyTime, using the supplied TimeSpan. |
| GetHashCode | Returns a hash code representing this KeyTime. (Overrides ValueType::GetHashCode().) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| ToString | Returns a string representation of this KeyTime. (Overrides ValueType::ToString().) |
| Name | Description | |
|---|---|---|
 | Equality | Compares two KeyTime values for equality. |
| Implicit(TimeSpan to KeyTime) | Implicitly converts a TimeSpan to a KeyTime. |
| Inequality | Compares two KeyTime values for inequality. |
Each key frame's KeyTime specifies when that key frame ends. It does not specify how long the key frame plays. The amount of time a key frame plays is determined by when the key frame ends, when the previous key frame ended, and the animation's duration. See Animations, motion, and output for Windows Phone for more information.
In Windows Phone, a KeyTime can only specify a TimeSpan.
Specifying a KeyTime by only an integer without any time span literal characters such as : or . will result in a KeyTime of that number of days! This is seldom the intended result. Usually you specify time spans in seconds. As such, the KeyTime string must include preceding zero values for hours and minutes, along with the appropriate literal : characters as separators between hours, minutes, and seconds. For instance, to specify a KeyTime of five seconds, the KeyTime string would be 0:0:5 (0:0:05 is equivalent).
Object element usage in XAML is possible but has no practical usage. You cannot declare a KeyTime as a usable, shareable object in a ResourceDictionary.
JavaScript API Notes
Creating a KeyTime in the JavaScript API is only possible through a type conversion syntax when setting a property such as KeyTime that takes a KeyTime, with the value specified as a string interpreted by the same grammar as the XAML usage. In managed code, you can create a KeyTime using the constructors.
In the XAML usage, [] indicates optional values; the [] are not literals. The : (colon) and . (period) characters are both literals, and delimit the h:m:s string form of a common time span, or the optional days and fractionalSeconds values.