Timeline.BeginTime Propriedade

Definição

Obtém ou define a hora em que esse Timeline deve começar.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)

Valor da propriedade

A hora em que esse Timeline deve começar, em relação ao seu pai BeginTime.The time at which this Timeline should begin, relative to its parent's BeginTime. Se essa linha do tempo for uma linha do tempo raiz, a hora será em relação à sua hora de início interativa (o momento em que a linha do tempo foi disparada).If this timeline is a root timeline, the time is relative to its interactive begin time (the moment at which the timeline was triggered). Esse valor pode ser positivo, negativo ou null; um valor null significa que a linha do tempo nunca é reproduzida.This value may be positive, negative, or null; a null value means the timeline never plays. O valor padrão é zero.The default value is zero.

Exemplos

A BeginTime propriedade de uma linha do tempo determina o início do período ativo de uma linha do tempo.A timeline's BeginTime property determines the beginning of a timeline's active period. Se a linha do tempo tiver uma linha do BeginTime tempo pai, a propriedade determinará quanto tempo levará a linha do tempo para iniciar depois que seu pai for iniciado.If the timeline has a parent timeline, the BeginTime property determines how long it takes the timeline to start after its parent starts. Se a linha do tempo for uma linha do Storyboardtempo raiz (um, por BeginTime exemplo), a propriedade determinará quanto tempo o cronograma leva para começar a ser reproduzido após ser disparado.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.

O exemplo a seguir mostra várias linhas do tempo diferentes com BeginTime configurações diferentes.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>

Comentários

A BeginTime propriedade é útil para a criação de linhas do tempo que são executadas em uma sequência: BeginTime ao aumentar o de cronogramas sucessivos que compartilham o mesmo pai, você pode escalonar seus tempos de execução.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.

Valores negativosNegative Values

Um valor BeginTime negativo faz com Timeline que um se comporte como se fosse iniciado em algum momento no passado.A negative BeginTime value causes a Timeline to behave as though it started at some time in the past. Por exemplo, um Timeline com um BeginTime de 2,5 segundos negativos e um Duration de 5 segundos parecerá ser concluído pela metade do processo.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 e SpeedRatioBeginTime and SpeedRatio

O tempo descrito pela BeginTime propriedade é medido no tempo de parent's da linha do tempo.The time described by the BeginTime property is measured in the timeline's parent's time. Por exemplo, uma linha do tempo BeginTime com um de 5 cujo pai SpeedRatio tem um de 2 realmente inicia após 2,5 segundos.For example, a timeline with a BeginTime of 5 whose parent has a SpeedRatio of 2 actually starts after 2.5 seconds.

A própria SpeedRatio configuração de um Timeline não afeta sua BeginTime.A timeline's own SpeedRatio setting does not affect its BeginTime. Por exemplo, uma linha do tempo BeginTime com um de 5 segundos SpeedRatio , um de 2 e uma linha do tempo SpeedRatio pai com um de 1 inicia após 5 segundos, não 2,5.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.

Informações da propriedade de dependênciaDependency Property Information

Campo de identificadorIdentifier field BeginTimeProperty
Propriedades de metadados definidas comotrueMetadata properties set to true NenhumNone

Uso do Atributo XAMLXAML Attribute Usage

<objeto do = "[-] [dias.] BeginTime horas:minutos:segundos[. fractionalSeconds] "/><object BeginTime="[-][days.]hours:minutes:seconds[.fractionalSeconds]"/>

- ou --or-

<objeto do = "[-] [dias.] BeginTime horas:minutos"/><object BeginTime="[-][days.]hours:minutes"/>

- ou --or-

<objeto do = "[-] dias"/>** BeginTime<object BeginTime="[-]days"/>

- ou --or-

<objeto do = "{x:Null Markup Extension}"/> BeginTime<object BeginTime="{x:Null Markup Extension}"/>

Valores XAMLXAML Values

Os itens entre colchetes ([ e ]) são opcionais.Items in square brackets ([ and ]) are optional.

diasdays
System.Int32

Um valor maior ou igual a 0 que descreve o número de dias abrangidos por essa hora de início.A value greater than or equal to 0 that describes the number of days spanned by this begin time.

duraçãohours
System.Int32

Um valor entre 0 e 23 que representa o número de horas abarcadas por essa hora de início.A value between 0 and 23 that represents the number of hours spanned by this begin time.

algunsminutes
System.Int32

Um valor entre 0 e 59 que representa o número de minutos abarcados por essa hora de início.A value between 0 and 59 that represents the number of minutes spanned by this begin time.

segseconds
System.Int32

Um valor entre 0 e 59 que representa o número de segundos abarcados por essa hora de início.A value between 0 and 59 that represents the number of seconds spanned by this begin time.

fractionalSecondsfractionalSeconds
System.Int32

Um valor que consiste em 1 a 7 dígitos que representa os segundos fracionários.A value consisting of 1 to 7 digits that represents fractional seconds.

Para obter a TimeSpan sintaxe completa, consulte a seção comentários Parse da página.For the complete TimeSpan syntax, see the Remarks section of the Parse page.

Aplica-se a

Veja também