Clock.CurrentProgress プロパティ


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

 property Nullable<double> CurrentProgress { Nullable<double> get(); };
public Nullable<double> CurrentProgress { get; }
member this.CurrentProgress : Nullable<double>
Public ReadOnly Property CurrentProgress As Nullable(Of Double)


このクロックが Stopped の場合は null、またはこのクロックがアクティブであり、その TimelineDurationForever の場合は 0.0。それ以外の場合は、現在の反復におけるこの Clock の現在の進行状況を示す 0.0 ~ 1.0 の値。null if this clock is Stopped, or 0.0 if this clock is active and its Timeline has a Duration of Forever; otherwise, a value between 0.0 and 1.0 that indicates the current progress of this Clock within its current iteration. 値 0.0 はまったく進行していないことを示し、値 1.0 はクロックが現在の反復の最後にあることを示します。A value of 0.0 indicates no progress, and a value of 1.0 indicates that the clock is at the end of its current iteration.


このプロパティの値は、このCurrentTimeクロックTimelineのにDurationよって正規化されたを示します。The value of this property indicates the CurrentTime normalized by the Duration of this clock's Timeline.

が 1.0 CurrentProgressのクロックFillingA clock that is Filling has a CurrentProgress of 1.0.

タイムラインをタイマーとして使用する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.