Timeline.BeginTime Timeline.BeginTime Timeline.BeginTime Timeline.BeginTime Property

Definition

Ruft die Zeit ab, bei der diese Timeline beginnen soll, oder legt diese fest.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)

Eigenschaftswert

Die Zeit, bei der diese Timeline beginnen soll, relativ zur BeginTime des übergeordneten Elements.The time at which this Timeline should begin, relative to its parent's BeginTime. Wenn es sich bei dieser Zeitachse um eine Stammzeitachse handelt, wird die Zeit relativ zur entsprechenden interaktiven Anfangszeit (dem Moment, zu dem die Wiedergabe der Zeitachse ausgelöst wurde) gemessen.If this timeline is a root timeline, the time is relative to its interactive begin time (the moment at which the timeline was triggered). Dieser Wert kann positiv, negativ oder null sein. Der Wert null bedeutet, dass die Zeitachse nie wiedergegeben wird.This value may be positive, negative, or null; a null value means the timeline never plays. Der Standardwert ist 0 (null).The default value is zero.

Beispiele

Einer Zeitachse BeginTime Eigenschaft bestimmt den Anfang des aktiven Zeitraum einer Zeitachse.A timeline's BeginTime property determines the beginning of a timeline's active period. Wenn die Zeitachse eine übergeordnete Zeitachse, verfügt die BeginTime Eigenschaft bestimmt, wie lange es dauert in der Zeitachse gestartet wird, nach dem Start von seinem übergeordneten Elements.If the timeline has a parent timeline, the BeginTime property determines how long it takes the timeline to start after its parent starts. Wenn die Zeitachse eine Stammzeitachse ist (eine Storyboard, z. B.), wird die BeginTime Eigenschaft bestimmt, wie lange dauert, die Zeitachse wiedergegeben werden, nachdem sie ausgelöst wird.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.

Das folgende Beispiel zeigt mehrere unterschiedliche Zeitpläne mit unterschiedlichen BeginTime Einstellungen.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>

Hinweise

Die BeginTime Eigenschaft ist nützlich zum Erstellen von Zeitachsen, in einer Sequenz: durch das Erhöhen der BeginTime von aufeinander folgenden Zeitachsen, die demselben übergeordneten Element gemeinsam nutzen, können Sie staffeln wiedergegeben.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 WerteNegative Values

Eine Negative BeginTime Wert bewirkt, dass eine Timeline so verhält, als ob er zu einem Zeitpunkt in der Vergangenheit gestartet.A negative BeginTime value causes a Timeline to behave as though it started at some time in the past. Z. B. eine Timeline mit einer BeginTime von 2,5 Sekunden negativ und ein Duration von 5 Sekunden wird angezeigt, die Hälfte werden abgeschlossen, wenn er beginnt.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 und "SpeedRatio"BeginTime and SpeedRatio

Die Zeit, die beschrieben werden, indem die BeginTime -Eigenschaft in der übergeordneten Zeitachse der Zeit gemessen wird.The time described by the BeginTime property is measured in the timeline's parent's time. Z. B. eine Zeitachse mit einer BeginTime 5, dessen übergeordnetes Element besitzt, ein SpeedRatio 2 tatsächlich gestartet wird, nach dem 2,5 Sekunden.For example, a timeline with a BeginTime of 5 whose parent has a SpeedRatio of 2 actually starts after 2.5 seconds.

Der Zeitachse selbst SpeedRatio Einstellung hat keine Auswirkungen auf die BeginTime.A timeline's own SpeedRatio setting does not affect its BeginTime. Z. B. eine Zeitachse mit der eine BeginTime von 5 Sekunden eine SpeedRatio 2 und einer übergeordneten Zeitachse mit einer SpeedRatio 1 beginnt, nach 5, nicht 2,5 Sekunden.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.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field BeginTimeProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true NoneNone

Verwendung von XAML-AttributenXAML Attribute Usage

<Objekt BeginTime= "[-] [Tage.] Stunden:Minuten:Sekunden[. FractionalSeconds] "/ ><object BeginTime="[-][days.]hours:minutes:seconds[.fractionalSeconds]"/>

- oder --or-

<Objekt BeginTime= "[-] [Tage.] Stunden:Minuten"/ ><object BeginTime="[-][days.]hours:minutes"/>

- oder --or-

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

- oder --or-

<Objekt BeginTime= "{X: Null Markup Extension}" / ><object BeginTime="{x:Null Markup Extension}"/>

XAML-WerteXAML Values

Elemente in eckigen Klammern ([ und ]) sind optional.Items in square brackets ([ and ]) are optional.

daysdays
System.Int32

Startzeit für ein Wert größer als oder gleich 0, die die Anzahl der Tage für von diesem beschreibt.A value greater than or equal to 0 that describes the number of days spanned by this begin time.

Stundenhours
System.Int32

Startzeit für ein Wert zwischen 0 und 23, der die Anzahl der Stunden für von diesem darstellt.A value between 0 and 23 that represents the number of hours spanned by this begin time.

minutesminutes
System.Int32

Startzeit für ein Wert zwischen 0 und 59, der die Anzahl der von diesem von Minuten darstellt.A value between 0 and 59 that represents the number of minutes spanned by this begin time.

secondsseconds
System.Int32

Startzeit für ein Wert zwischen 0 und 59, der die Anzahl der Sekunden für von diesem darstellt.A value between 0 and 59 that represents the number of seconds spanned by this begin time.

fractionalSecondsfractionalSeconds
System.Int32

Ein Wert, der mit 1 bis 7 Ziffern, der Bruchteile von Sekunden darstellt.A value consisting of 1 to 7 digits that represents fractional seconds.

Für die vollständige TimeSpan -Syntax finden Sie im Abschnitt "Hinweise" der Parse Seite.For the complete TimeSpan syntax, see the Remarks section of the Parse page.

Gilt für:

Siehe auch