Timeline.BeginTime Vlastnost

Definice

Obor názvů:

System.Windows.Media.Animation

Sestavení:

PresentationCore.dll

Získá nebo nastaví čas, ve kterém má začít Timeline .

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)

Hodnota vlastnosti

Nullable<TimeSpan>

Čas, kdy by to Timeline mělo začínat vzhledem k nadřazené sadě BeginTime. Pokud je tato časová osa kořenovou časovou osou, čas je relativní k interaktivnímu počátečnímu času (okamžiku, kdy se časová osa aktivovala). Tato hodnota může být kladná, záporná nebo null; null hodnota znamená, že časová osa se nikdy nepřehrává. Výchozí hodnota je nula.

Příklady

Vlastnost časové osy BeginTime určuje začátek aktivního období časové osy. Pokud má časová osa nadřazenou časovou osu, vlastnost určuje, BeginTime jak dlouho trvá, než se časová osa spustí po spuštění nadřazeného objektu. Pokud je časová osa kořenovou časovou osou ( Storyboardnapříklad), BeginTime vlastnost určuje, jak dlouho trvá, než se časová osa začne přehrávat po aktivaci.

Následující příklad ukazuje několik různých časových os s různými BeginTime nastaveními.

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

Poznámky

Vlastnost BeginTime je užitečná pro vytváření časových os, které se hrají v posloupnosti: zvýšením BeginTime po sobě jdoucích časových os, které sdílejí stejný nadřazený objekt, můžete jejich časy přehrávání rozhodit.

Záporné hodnoty

Záporná BeginTime hodnota způsobí Timeline , že se bude chovat, jako by se v určitém okamžiku v minulosti spustil. Například Timeline se zápornou BeginTime 2,5 sekundou a Duration 5 sekund se zdá, že se po spuštění dokončí napůl.

BeginTime a SpeedRatio

Čas popsaný BeginTime vlastností se měří v čase nadřazeného objektu časové osy. Například časová osa s BeginTime 5, jejíž nadřazený objekt má SpeedRatio ve skutečnosti 2, začíná po 2,5 sekundách.

Vlastní SpeedRatio nastavení časové osy nemá vliv na jeho nastavení BeginTime. Například časová osa s BeginTime 5 sekundami, SpeedRatio 2 a nadřazenou časovou osou s SpeedRatio 1 začíná po 5 sekundách, nikoli po 2,5.

Informace o vlastnosti závislosti

Pole identifikátoru	BeginTimeProperty
Vlastnosti metadat nastavené na true	Žádné

Použití atributu XAML

<object BeginTime="^[dny.] hours:minutes:seconds[.fractionalSeconds]"/>

-nebo-

<object BeginTime="^[dny.] hours:minutes"/>

-nebo-

<object BeginTime="^days"/>

-nebo-

<object BeginTime="{x:Null – rozšíření značek}"/>

Hodnoty XAML

Položky v hranatých závorkách ([ a ]) jsou volitelné.

Dní
System.Int32

Hodnota větší než nebo rovna 0, která popisuje počet dní rozložených do tohoto počátečního času.

Hodin
System.Int32

Hodnota mezi 0 a 23, která představuje počet hodin rozložených do tohoto počátečního času.

Minut
System.Int32

Hodnota mezi 0 a 59, která představuje počet minut rozložených do tohoto počátečního času.

Sekund
System.Int32

Hodnota mezi 0 a 59, která představuje počet sekund rozložených do tohoto počátečního času.

fractionalSeconds
System.Int32

Hodnota skládající se z 1 až 7 číslic, která představuje zlomek sekund.

Kompletní TimeSpan syntaxi najdete v části Poznámky na Parse stránce.

Viz také

• SpeedRatio