Timeline.Duration プロパティ


繰り返しをカウントせずに、このタイムラインの再生に要する時間を取得または設定します。Gets or sets the length of time for which this timeline plays, not counting repetitions.

 property System::Windows::Duration Duration { System::Windows::Duration get(); void set(System::Windows::Duration value); };
public System.Windows.Duration Duration { get; set; }
member this.Duration : System.Windows.Duration with get, set
Public Property Duration As Duration


タイムラインの単純継続時間 (このタイムラインが順方向の反復を 1 回完了するのに要する時間)。The timeline's simple duration: the amount of time this timeline takes to complete a single forward iteration. 既定値は Automatic です。The default value is Automatic.

ParallelTimelineおよびStoryboardは、オブジェクトTimelineGroupの型です。ParallelTimeline and Storyboard are types of TimelineGroup objects. TimelineGroup期間は、その子タイムラインの期間によって決まります。The duration of a TimelineGroup is determined by the duration of its child timelines. たとえば、次のStoryboardは6秒間実行されます。これは、その最後の子タイムライン (DoubleAnimation) が終了したときです。For example, the Storyboard below will run for six seconds (duration of 6 seconds) because that is when its last child Timeline (DoubleAnimation) ends.


注: 次の例では、コードが省略されています。これは、説明用の遂行のためだけに用意されています。Note: code has been omitted from the following examples, which are provided for illustrative purposed only.


    <DoubleAnimation Duration="0:0:2" …/>  
    <DoubleAnimation Duration="0:0:4" BeginTime="0:0:2" …/>  

型 > < DoubleAnimation PointAnimationアニメーションの例として、 ** 、、などがあります。ColorAnimationこれらの種類のアニメーションに対してが指定されていない場合は、1秒間実行されます。DurationExamples of <Type>Animations include DoubleAnimation, PointAnimation, ColorAnimation, etc. If no Duration is specified for these types of animations, they will run for one second.


  <!-- With no Duration specified, this animation will run for   
       one second -->  
  <DoubleAnimation .../>  

キーフレーム<の種類> アニメーションの例DoubleAnimationUsingKeyFramesPointAnimationUsingKeyFramesは、、などがあります。これらの種類のアニメーションに対してが指定されていない場合は、すべてのキーフレームが終了するまで実行されます。DurationExamples of <Type>AnimationUsingKeyFrames include DoubleAnimationUsingKeyFrames, PointAnimationUsingKeyFrames, etc. If no Duration is specified for these types of animations they will run until all key frames are finished.


    <!-- This key frame animation will end at 4.5 seconds  
         Because that is when its last KeyFrame KeyTime ends. -->  
    <DoubleAnimationUsingKeyFrames ...>  
      <LinearDoubleKeyFrame ... KeyTime="0:0:3" />  
      <DiscreteDoubleKeyFrame ... KeyTime="0:0:3.5" />  
      <DiscreteDoubleKeyFrame ... KeyTime="0:0:4" />  
      <DiscreteDoubleKeyFrame ... KeyTime="0:0:4.5" />  


タイムラインの単純な期間は、1回の前方反復と、繰り返しを含む再生時間の合計の時間を構成します。A timeline's simple duration constitutes the time for a single forward iteration versus the total play time, which includes repetitions.

既定の期間の動作Default Duration Behavior

値がのDuration Automatic構造体の動作は、タイムラインの型によって異なります。The behavior of a Duration structure with a value of Automatic depends on the type of timeline:

時系列Timeline BehaviorBehavior
Timeline 未確定 (Timeline is abstract)Undetermined (Timeline is abstract)


子タイムラインに合わせるExpands to fit child timelines
<> アニメーション ("From/To/By" または "basic" アニメーションと呼ばれます)<Type>Animation (Known as a "From/To/By" or "basic" animations) 1 秒1 second
<キーフレーム (キーフレームアニメーションと呼ばれます) を介してキーフレームを > に入力します。<Type>AnimationUsingKeyFrames (Known as key frame animations) すべてのキーフレームKeyTime値の合計Sum of all key frame KeyTime values

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field DurationProperty
メタデータプロパティがに設定されるtrueMetadata properties set to true NoneNone