Clock Clock Clock Clock Class


Timeline の実行時のタイミング状態を維持します。Maintains run-time timing state for a Timeline.

public ref class Clock : System::Windows::Threading::DispatcherObject
public class Clock : System.Windows.Threading.DispatcherObject
type Clock = class
    inherit DispatcherObject
Public Class Clock
Inherits DispatcherObject


A Timeline、単独では実際に何も以外の時間のセグメントについて説明します。A Timeline, by itself, doesn't actually do anything other than describe a segment of time. タイムラインのClock実際の処理を行うオブジェクト: タイムラインのタイミングに関連する実行時の状態を保持します。It's the timeline's Clock object that does the real work: it maintains timing-related run-time state for the timeline.

ほとんどの場合は、タイムラインに対して、クロックが自動的に作成します。In most cases, a clock is created automatically for your timeline. 使用してアニメーション化するときに、StoryboardまたはBeginAnimationメソッド、クロックが自動的に、タイムラインとアニメーションの作成し、対象のプロパティに適用します。When you animate by using a Storyboard or the BeginAnimation method, clocks are automatically created for your timelines and animations and applied to their targeted properties. たとえば、「方法:ストーリー ボードを使用してプロパティをアニメーション化する方法。ストーリー ボードを使用せずにプロパティをアニメーション化するします。For examples, see How to: Animate a Property by Using a Storyboard and How to: Animate a Property Without Using a Storyboard.

作成することも、Clockを使用して明示的に、CreateClockメソッド。You can also create a Clock explicitly by using the CreateClock method. 多数の類似のオブジェクトをアニメーション化など、負荷の高いシナリオで管理独自Clock使用はパフォーマンス上の利点を提供できます。In performance-intensive scenarios, such as animating large numbers of similar objects, managing your own Clock use can provide performance benefits.

クロックはツリーの構造に合ったに並べ、Timelineオブジェクトのツリーから作成されます。Clocks are arranged in trees that match the structure of the Timeline objects tree from which they are created. (一時停止、再開、停止、およびなど)、このようなタイミング ツリーのルート クロックを対話的に操作できることができますを取得してそのControllerします。The root clock of such a timing tree can be interactively manipulated (paused, resumed, stopped, and so on) by retrieving its Controller. 非ルート クロックを直接制御できません。Non-root clocks cannot be directly controlled.

いったん作成されると、時計を変更できません (ただし、操作することができます)。Once created, a clock cannot be modified (but it can be manipulated).

タイムラインを使用して、タイマーとしてUsing a Timeline as a Timer

タイムラインのクロックは、関連付けられているイベント ハンドラーがある場合にのみ実行または (の場合、AnimationClockオブジェクト) のプロパティに関連付けられています。A timeline's clock will only progress when there's an event handler associated with it or (in the case of an AnimationClock object) it is associated with a property. この理由 (および他のユーザー)、これは使用しないで使用すること、Timelineタイマーとして。For this reason (and others), it's not recommended that you use a Timeline as a timer.

注意 (継承者)

派生クラスで実装する必要がありますGetCurrentTimeCore()このクロックの時間の流れを変更する場合。Derived classes should implement GetCurrentTimeCore() if they want to modify how time flows for this clock. 派生クラスは、クロックが繰り返されますをスキップします、シーク、開始、一時停止、再開すると、または停止時にオーバーライドすることで、追加の作業を行う可能、 DiscontinuousTimeMovement()SpeedChanged()、およびStopped()メソッド。Derived classes can be made to do additional work when the clock repeats, skips, seeks, begins, pauses, resumes, or stops by overriding the DiscontinuousTimeMovement(), SpeedChanged(), and Stopped() methods.


Clock(Timeline) Clock(Timeline) Clock(Timeline) Clock(Timeline)

指定した Clock をテンプレートとして使用して、Timeline クラスの新しいインスタンスを初期化します。Initializes a new instance of the Clock class, using the specified Timeline as a template. 新しい Clock オブジェクトには、子がありません。The new Clock object has no children.


Controller Controller Controller Controller

この Clock を開始、一時停止、再開、シーク、スキップ、停止、削除するために使用できる ClockController を取得します。Gets a ClockController that can be used to start, pause, resume, seek, skip, stop, or remove this Clock.

CurrentGlobalSpeed CurrentGlobalSpeed CurrentGlobalSpeed CurrentGlobalSpeed

現実世界の時間と比較したときの、クロックの時間が現在進行しているレートを取得します。Gets the rate at which the clock's time is currently progressing, compared to real-world time.

CurrentGlobalTime CurrentGlobalTime CurrentGlobalTime CurrentGlobalTime

WPFWPF タイミング システムによって確立される、現在のグローバル時刻を取得します。Gets the current global time, as established by the WPFWPF timing system.

CurrentIteration CurrentIteration CurrentIteration CurrentIteration

このクロックの現在の反復を取得します。Get the current iteration of this clock.

CurrentProgress CurrentProgress CurrentProgress CurrentProgress

現在の反復におけるこの Clock の進行状況を取得します。Gets the current progress of this Clock within its current iteration.

CurrentState CurrentState CurrentState CurrentState

クロックが現在 ActiveFilling、または Stopped であるかどうかを示す値を取得します。Gets a value indicating whether the clock is currently Active, Filling, or Stopped.

CurrentTime CurrentTime CurrentTime CurrentTime

このクロックの現在の反復における現在の時刻を取得します。Gets this clock's current time within its current iteration.

Dispatcher Dispatcher Dispatcher Dispatcher

この Dispatcher が関連付けられている DispatcherObject を取得します。Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
HasControllableRoot HasControllableRoot HasControllableRoot HasControllableRoot

この Clock が制御可能なクロック ツリーの一部かどうかを示す値を取得します。Gets a value that indicates whether this Clock is part of a controllable clock tree.

IsPaused IsPaused IsPaused IsPaused

この Clock または親が一時停止しているかどうかを示す値を取得します。Gets a value that indicates whether this Clock, or any of its parents, is paused.

NaturalDuration NaturalDuration NaturalDuration NaturalDuration

このクロックの Timeline の自然な継続時間を取得します。Gets the natural duration of this clock's Timeline.

Parent Parent Parent Parent

このクロックの親であるクロックを取得します。Gets the clock that is the parent of this clock.

Timeline Timeline Timeline Timeline

この Timeline の作成元である Clock を取得します。Gets the Timeline from which this Clock was created.


CheckAccess() CheckAccess() CheckAccess() CheckAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるかどうかを確認します。Determines whether the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)
DiscontinuousTimeMovement() DiscontinuousTimeMovement() DiscontinuousTimeMovement() DiscontinuousTimeMovement()

派生クラスで実装された場合、クロックを反復、スキップ、シークするたびに呼び出されます。When implemented in a derived class, will be invoked whenever a clock repeats, skips, or seeks.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCanSlip() GetCanSlip() GetCanSlip() GetCanSlip()

Clock に、タイミング システムとの同期を必要とする可能性がある専用の外部タイム ソースがあるかどうかを示す値を返します。Returns whether the Clock has its own external time source, which may require synchronization with the timing system.

GetCurrentTimeCore() GetCurrentTimeCore() GetCurrentTimeCore() GetCurrentTimeCore()

このクロックの現在の反復における現在の時刻を取得します。Gets this clock's current time within its current iteration.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
SpeedChanged() SpeedChanged() SpeedChanged() SpeedChanged()

派生クラスで実装された場合、クロックを開始、スキップ、一時停止、再開するか、クロックの SpeedRatio を変更するたびに呼び出されます。When implemented in a derived class, will be invoked whenever a clock begins, skips, pauses, resumes, or when the clock's SpeedRatio is modified.

Stopped() Stopped() Stopped() Stopped()

派生クラスで実装された場合、Stop() メソッドを使用してクロックを停止するたびに呼び出されます。When implemented in a derived class, will be invoked whenever a clock is stopped using the Stop() method.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

呼び出し元のスレッドがこの DispatcherObject にアクセスできるように強制します。Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)


Completed Completed Completed Completed

クロックの再生が完全に終了すると発生します。Occurs when this clock has completely finished playing.

CurrentGlobalSpeedInvalidated CurrentGlobalSpeedInvalidated CurrentGlobalSpeedInvalidated CurrentGlobalSpeedInvalidated

クロックの速度が更新されると発生します。Occurs when the clock's speed is updated.

CurrentStateInvalidated CurrentStateInvalidated CurrentStateInvalidated CurrentStateInvalidated

クロックの CurrentState プロパティが更新されると発生します。Occurs when the clock's CurrentState property is updated.

CurrentTimeInvalidated CurrentTimeInvalidated CurrentTimeInvalidated CurrentTimeInvalidated

このクロックの CurrentTime が無効になると発生します。Occurs when this clock's CurrentTime becomes invalid.

RemoveRequested RemoveRequested RemoveRequested RemoveRequested

この Remove() または親クロックのいずれかで Clock メソッドが呼び出されると発生します。Occurs when the Remove() method is called on this Clock or one of its parent clocks.