Timeline.BeginTime Eigenschap

public:
 property Nullable<TimeSpan> BeginTime { Nullable<TimeSpan> get(); void set(Nullable<TimeSpan> value); };

public TimeSpan? BeginTime { get; set; }

member this.BeginTime : Nullable<TimeSpan> with get, set

Public Property BeginTime As Nullable(Of TimeSpan)

Waarde van eigenschap

Het tijdstip waarop dit Timeline moet beginnen, ten opzichte van de bovenliggende BeginTime. Als deze tijdlijn een hoofdtijdlijn is, is de tijd relatief ten opzichte van de interactieve begintijd (het moment waarop de tijdlijn is geactiveerd). Deze waarde kan positief, negatief of null; een null waarde zijn die betekent dat de tijdlijn nooit wordt afgespeeld. De standaardwaarde is nul.

Voorbeelden

De eigenschap van BeginTime een tijdlijn bepaalt het begin van de actieve periode van een tijdlijn. Als de tijdlijn een bovenliggende tijdlijn heeft, bepaalt de BeginTime eigenschap hoe lang het duurt voordat de tijdlijn begint nadat het bovenliggende item is gestart. Als de tijdlijn een hoofdtijdlijn is (bijvoorbeeld een Storyboard), bepaalt de BeginTime eigenschap hoe lang het duurt voordat de tijdlijn wordt afgespeeld nadat deze is geactiveerd.

In het volgende voorbeeld ziet u verschillende tijdlijnen met verschillende BeginTime instellingen.

<!-- 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>

Opmerkingen

De BeginTime eigenschap is handig voor het maken van tijdlijnen die in een reeks worden afgespeeld: door de BeginTime opeenvolgende tijdlijnen te verhogen die hetzelfde bovenliggende item delen, kunt u de afspeeltijden van de tijdlijnen wijzigen.

Negatieve waarden

Een negatieve BeginTime waarde zorgt ervoor dat een Timeline gedrag zich gedraagt alsof deze op een bepaald moment in het verleden is gestart. Een met een Timeline negatieve 2,5 seconden en een BeginTime van 5 seconden lijkt bijvoorbeeld Duration halverwege te zijn wanneer deze wordt gestart.

BeginTime en SpeedRatio

De tijd die door de BeginTime eigenschap wordt beschreven, wordt gemeten in de bovenliggende tijd van de tijdlijn. Een tijdlijn met een van 5 waarvan het BeginTime bovenliggende item een SpeedRatio van 2 heeft, begint bijvoorbeeld na 2,5 seconden.

De eigen SpeedRatio instelling van een tijdlijn heeft geen invloed op de instelling BeginTime. Bijvoorbeeld: een tijdlijn met een BeginTime van 5 seconden, een SpeedRatio van 2 en een bovenliggende tijdlijn met een SpeedRatio van 1 begint na 5 seconden, niet 2,5.

Informatie over afhankelijkheidseigenschappen

XAML-kenmerkgebruik

< ObjectBeginTime="^[dagen.]uren:minuten:seconden[.fractionalSeconds]"/>

– of –

< ObjectBeginTime="^[dagen.]uren:minuten"/>

– of –

< ObjectBeginTime="^dagen"/>

– of –

< ObjectBeginTime="{x:Null-markeringsextensie}"/>

XAML-waarden

Items in vierkante haken ([ en ]) zijn optioneel.

DagenSystem.Int32

Een waarde groter dan of gelijk aan 0 die het aantal dagen beschrijft dat door deze begintijd is geduurd.

UurSystem.Int32

Een waarde tussen 0 en 23 die het aantal uren aangeeft dat door deze begintijd is geduurd.

MinutenSystem.Int32

Een waarde tussen 0 en 59 die het aantal minuten aangeeft dat gedurende deze begintijd is opgegeven.

SecondenSystem.Int32

Een waarde tussen 0 en 59 die het aantal seconden aangeeft dat door deze begintijd is gespeid.

fractionalSecondsSystem.Int32

Een waarde die bestaat uit 1 tot 7 cijfers die fractionele seconden vertegenwoordigen.

Zie de sectie Opmerkingen van de TimeSpan pagina voor de volledige Parse syntaxis.

Zie ook

• SpeedRatio