ClockController Class
Interactively controls a Clock.
System.Windows.Threading::DispatcherObject
System.Windows.Media.Animation::ClockController
Assembly: PresentationCore (in PresentationCore.dll)
The ClockController type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | Clock | Gets the Clock controlled by this ClockController. |
![]() | Dispatcher | Gets the Dispatcher this DispatcherObject is associated with. (Inherited from DispatcherObject.) |
![]() | SpeedRatio | Gets or sets the interactive speed of the target Clock. |
| Name | Description | |
|---|---|---|
![]() | Begin | Sets the target Clock to begin at the next tick. |
![]() | CheckAccess | Determines whether the calling thread has access to this DispatcherObject. (Inherited from DispatcherObject.) |
![]() | Equals(Object) | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | Pause | Stops the target Clock from progressing. |
![]() | Remove | Removes the Clock associated with this ClockController from the properties it animates. The clock and its child clocks will no longer affect these properties. |
![]() | Resume | Enables a Clock that was previously paused to resume progressing. |
![]() | Seek | Seeks the target Clock by the specified amount when the next tick occurs. If the target clock is stopped, seeking makes it active again. |
![]() | SeekAlignedToLastTick | Seeks the target Clock by the specified amount immediately. If the target clock is stopped, seeking makes it active again. |
![]() | SkipToFill | Advances the current time of the target Clock to the end of its active period. |
![]() | Stop | Stops the target Clock. |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
![]() | VerifyAccess | Enforces that the calling thread has access to this DispatcherObject. (Inherited from DispatcherObject.) |
Use a ClockController to interactively begin, pause, resume, seek, skip, stop, and remove a Clock. You can only interactively control root-level clocks.
A Clock object's ClockController property enables you to interactively start, pause, resume, seek, advance the clock to its fill period, and stop the clock. Only the root clock of a timing tree can be interactively controlled.
Note |
|---|
There are other ways to interactively control animations that don't require you to work directly with clocks: you can also use Storyboards. Storyboards are supported in both markup and code. For an example, see How to: Animate a Property by Using a Storyboard or the Animation Overview. |
In the following example, several buttons are used to interactively control an animation clock.
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
