Timeline.BeginTime 속성

정의

Timeline이 시작되어야 하는 시간을 가져오거나 설정합니다.Gets or sets the time at which this Timeline should begin.

public:
 property Nullable<TimeSpan> BeginTime { Nullable<TimeSpan> get(); void set(Nullable<TimeSpan> value); };
public Nullable<TimeSpan> BeginTime { get; set; }
member this.BeginTime : Nullable<TimeSpan> with get, set
Public Property BeginTime As Nullable(Of TimeSpan)

속성 값

Timeline이 시작되어야 하는 시간으로, 해당 부모의 BeginTime에 상대적입니다.The time at which this Timeline should begin, relative to its parent's BeginTime. 이 타임라인이 루트 타임라인인 경우 시간이 대화형 시작 시간(타임라인이 트리거된 순간)에 상대적입니다.If this timeline is a root timeline, the time is relative to its interactive begin time (the moment at which the timeline was triggered). 이 값은 양수, 음수 또는 null이 될 수 있습니다. 값이 null이면 타임라인이 재생되지 않습니다.This value may be positive, negative, or null; a null value means the timeline never plays. 기본값은 0입니다.The default value is zero.

예제

타임 라인의 BeginTime 속성 타임 라인의 활성 기간 시작 부분을 결정 합니다.A timeline's BeginTime property determines the beginning of a timeline's active period. 타임 라인에 부모 타임 라인을 BeginTime 속성 부모 시작 된 후 시작 하려면 타임 라인 걸리는 시간을 결정 합니다.If the timeline has a parent timeline, the BeginTime property determines how long it takes the timeline to start after its parent starts. 타임 라인이 루트 타임 라인 있으면 (한 Storyboard예를 들어), BeginTime 속성 결정 타임 라인이 트리거된 후 재생을 시작 하는 데 걸리는.If the timeline is a root timeline (a Storyboard, for example), the BeginTime property determines how long the timeline takes to start playing after it is triggered.

다음 예제에서는 서로 다른 여러 개의 타임 라인 BeginTime 설정 합니다.The following example shows several different timelines with different BeginTime settings.

<!-- This example shows how the BeginTime property determines when a timeline starts.
     Several rectangles are animated by DoubleAnimations with identical 
     durations and target values, but with different
     BeginTime settings. -->
     
<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  WindowTitle="BeginTime Example">
  <StackPanel Margin="20">

    <!-- The rectangles to animate. -->
    <Rectangle Name="DefaultBeginTimeRectangle" 
      Width="20" Height="20" Fill="Blue"  />
      
    <Rectangle Name="DelayedBeginTimeRectangle" 
      Width="20" Height="20" Fill="Blue"  />
    
    <Rectangle Name="DelayedAnimationWithDelayedParentRectangle" 
      Width="20" Height="20" Fill="Blue"  /> 

    <Rectangle Name="NegativeBeginTimeExampleRectangle" 
      Width="20" Height="20" Fill="Blue"  />            
    
    <!-- Create a button to start the animations. -->
    <Button Margin="20" Content="Start Animations">
      <Button.Triggers>
        <EventTrigger RoutedEvent="Button.Click">
          <BeginStoryboard>
            <Storyboard>

              <!-- This animation starts as soon as the button is clicked, because it
                   has a BeginTime of 0. -->
              <DoubleAnimation 
                Storyboard.TargetName="DefaultBeginTimeRectangle" 
                Storyboard.TargetProperty="Width"
                BeginTime="0:0:0" From="100" To="600" Duration="0:0:5"  /> 

              <!-- This animation starts 5 seconds after the button is clicked. -->
              <DoubleAnimation 
                Storyboard.TargetName="DelayedBeginTimeRectangle" 
                Storyboard.TargetProperty="Width"  
                BeginTime="0:0:5" From="100" To="600" Duration="0:0:5" />
                
              <ParallelTimeline BeginTime="0:0:5">  

              <!-- This animation starts 10 seconds after the button is clicked, 
                   because its parent has a BeginTime of 5 seconds and it has
                   a BeginTime of 5 seconds: 5 + 5 = 10.  -->              
                <DoubleAnimation  
                  Storyboard.TargetName="DelayedAnimationWithDelayedParentRectangle" 
                  Storyboard.TargetProperty="Width" 
                  BeginTime="0:0:5" From="100" To="600" Duration="0:0:5"  />
              </ParallelTimeline>
              
              <!-- This animation starts as soon as the button is clicked, but
                   it animates from 350 to 600 instead of from 100 to 600 
                   because of its negative BeginTime. The negative BeginTime
                   setting advances the animation, so that it behaves as though
                   it had already been playing for 2.5 seconds as soon as it is
                   started. -->
              <DoubleAnimation 
                Storyboard.TargetName="NegativeBeginTimeExampleRectangle" 
                Storyboard.TargetProperty="Width"  
                BeginTime="-0:0:2.5" From="100" To="600" Duration="0:0:5" />              
              
            </Storyboard>
          </BeginStoryboard>
        </EventTrigger>
      </Button.Triggers>      
    </Button>
    
    <!-- This example demonstrates how the BeginTime property works on a root timeline. -->
    <Rectangle Name="RootTimelineWithDelayedBeginTimeRectangle"
      Width="20" Height="20" Fill="Blue" >
      <Rectangle.Triggers>
        <EventTrigger RoutedEvent="Rectangle.MouseLeftButtonDown">
          <BeginStoryboard>
            <Storyboard BeginTime="0:0:5">
            
              <!-- This animation starts 5 seconds after the left mouse button
                   is pressed, because its parent storyboard (a root timeline)
                   has a BeginTime of 5 seconds. -->
              <DoubleAnimation 
                Storyboard.TargetName="RootTimelineWithDelayedBeginTimeRectangle" 
                Storyboard.TargetProperty="Width"
                BeginTime="0:0:0" From="100" To="600" Duration="0:0:2" />
            </Storyboard>
          </BeginStoryboard>
        </EventTrigger>
      </Rectangle.Triggers>
    </Rectangle>    
  </StackPanel>
</Page>

설명

합니다 BeginTime 속성은 시퀀스에서 수행 하는 타임 라인을 만드는 데 유용: 늘려는 BeginTime 동일한 부모를 공유 하는 연속 타임 라인의 플레이 시간에 따라를 스 태거 수 있습니다.The BeginTime property is useful for creating timelines that play in a sequence: by increasing the BeginTime of successive timelines that share the same parent, you can stagger their play times.

음수 값Negative Values

음수 BeginTime 원인 값을 Timeline 지난에서 몇 시간에 시작 된 것 처럼 동작 합니다.A negative BeginTime value causes a Timeline to behave as though it started at some time in the past. 예를 들어를 Timeline 사용 하 여를 BeginTime 음수 2.5 시간 (초) 및 Duration 절반에 5 초의 더 표시 시작 될 때 완료 합니다.For example, a Timeline with a BeginTime of negative 2.5 seconds and a Duration of 5 seconds will appear to be half-way finished when it starts.

BeginTime 및 SpeedRatioBeginTime and SpeedRatio

설명 하는 시간을 BeginTime 속성이 부모 timeline의 시간 단위로 측정 됩니다.The time described by the BeginTime property is measured in the timeline's parent's time. 예를 들어 타임 라인을 사용 하 여는 BeginTime 부모가 5를 SpeedRatio 2 실제로 2.5 초 후 시작 합니다.For example, a timeline with a BeginTime of 5 whose parent has a SpeedRatio of 2 actually starts after 2.5 seconds.

타임 라인의 자체 SpeedRatio 설정에 영향을 주지 않습니다 해당 BeginTime합니다.A timeline's own SpeedRatio setting does not affect its BeginTime. 예를 들어 타임 라인을 사용 하 여는 BeginTime 5 초의 SpeedRatio 2 및 사용 하 여 부모 타임 라인의는 SpeedRatio 없습니다 2.5 5 초 후에 시작 1입니다.For example, a timeline with a BeginTime of 5 seconds, a SpeedRatio of 2, and a parent timeline with a SpeedRatio of 1 starts after 5 seconds, not 2.5.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field BeginTimeProperty
메타 데이터 속성 설정 trueMetadata properties set to true 없음None

XAML 특성 사용XAML Attribute Usage

<object BeginTime="[-][days.]hours:minutes:seconds[.fractionalSeconds]"/><object BeginTime="[-][days.]hours:minutes:seconds[.fractionalSeconds]"/>

또는-or-

<개체 BeginTime= "[-] [.] 시간:"/ ><object BeginTime="[-][days.]hours:minutes"/>

또는-or-

<object BeginTime="[-]days"/><object BeginTime="[-]days"/>

또는-or-

<개체 BeginTime= "{X:null 태그 확장}" / ><object BeginTime="{x:Null Markup Extension}"/>

XAML 값XAML Values

대괄호 안에 있는 항목 ([])은 선택 사항입니다.Items in square brackets ([ and ]) are optional.

daysdays
System.Int32

값이 포함 되는 일 수를 설명 하는 0 보다 크거나 시작 시간입니다.A value greater than or equal to 0 that describes the number of days spanned by this begin time.

시간hours
System.Int32

시작 시간에이 포함 되는 시간 수를 나타내는 0에서 23 사이의 값입니다.A value between 0 and 23 that represents the number of hours spanned by this begin time.

minutesminutes
System.Int32

시작 시간에이 포함 되는 분 수를 나타내는 0에서 59 사이의 값입니다.A value between 0 and 59 that represents the number of minutes spanned by this begin time.

secondsseconds
System.Int32

시작 시간에이에 포함 되는 시간 (초) 수를 나타내는 0에서 59 사이의 값입니다.A value between 0 and 59 that represents the number of seconds spanned by this begin time.

fractionalSecondsfractionalSeconds
System.Int32

소수 자릿수 초를 나타내는 1 ~ 7 자리 이루어진는 값입니다.A value consisting of 1 to 7 digits that represents fractional seconds.

전체 TimeSpan 구문을의 주의 섹션을 참조 합니다 Parse 페이지입니다.For the complete TimeSpan syntax, see the Remarks section of the Parse page.

적용 대상

추가 정보