Timeline.BeginTime Özellik

Tanım

Ad Alanı:

System.Windows.Media.Animation

Bütünleştirilmiş Kod:

PresentationCore.dll

Bunun Timeline başlaması gereken zamanı alır veya ayarlar.

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)

Özellik Değeri

Nullable<TimeSpan>

Bunun başlaması gereken zaman Timeline , üst öğesinin BeginTimezamanına göre. Bu zaman çizelgesi bir kök zaman çizelgesiyse, zaman etkileşimli başlangıç zamanına göredir (zaman çizelgesinin tetiklendiği an). Bu değer pozitif, negatif veya nullolabilir; değer null , zaman çizelgesinin hiçbir zaman oynatılmaması anlamına gelir. Varsayılan değer sıfırdır.

Örnekler

Zaman çizelgesinin BeginTime özelliği, zaman çizelgesinin etkin döneminin başlangıcını belirler. Zaman çizelgesinin bir üst zaman çizelgesi varsa, özelliği, BeginTime üst zaman çizelgesi başlatıldıktan sonra zaman çizelgesinin başlatılmasının ne kadar süreceğini belirler. Zaman çizelgesi bir kök zaman çizelgesiyse ( Storyboardörneğin), BeginTime özelliği zaman çizelgesinin tetiklendikten sonra yürütülmeye başlamasının ne kadar süreceğini belirler.

Aşağıdaki örnekte, farklı ayarlara sahip birkaç farklı BeginTime zaman çizelgesi gösterilmektedir.

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

Açıklamalar

BeginTime özelliği, bir sırayla oynatılan zaman çizelgeleri oluşturmak için kullanışlıdır: Aynı üst öğeyi BeginTime paylaşan ardışık zaman çizelgelerinin sayısını artırarak, bu zaman çizelgelerinin oynatma sürelerini artırabilirsiniz.

Negatif Değerler

Negatif BeginTime bir değer, geçmişte bir Timeline süre başlamış gibi davranmasına neden olur. Örneğin, Timeline negatif 2,5 saniye ve 5 saniyelik bir içeren BeginTime bir Duration , başlatıldığında yarı yolda tamamlanmış gibi görünür.

BeginTime ve SpeedRatio

özelliği tarafından BeginTime tanımlanan süre zaman çizelgesinin üst öğesinin saat cinsinden ölçülür. Örneğin, üst öğesi 2 olan 5'lik bir BeginTimeSpeedRatio zaman çizelgesi aslında 2,5 saniye sonra başlar.

Zaman çizelgesinin kendi SpeedRatio ayarı, ayarını BeginTimeetkilemez. Örneğin, 5 saniyelik bir BeginTime zaman çizelgesi, 2'lik bir SpeedRatio zaman çizelgesi ve 1 olan üst zaman çizelgesi SpeedRatio 2,5 değil 5 saniye sonra başlar.

Bağımlılık Özelliği Bilgileri

Öğe	Değer
Tanımlayıcı alanı	BeginTimeProperty
Meta veri özellikleri olarak ayarlandı true	Hiç kimse

XAML Öznitelik Kullanımı

< NesneBeginTime="[-][gün.]hours:minutes:seconds[.fractionalSeconds]"/>

-veya-

< NesneBeginTime="[-][gün.]hours:minutes"/>

-veya-

< NesneBeginTime="[-]days"/>

-veya-

< NesneBeginTime="{x:Null biçimlendirme uzantısı}"/>

XAML Değerleri

Köşeli ayraç ([ ve ]) içindeki öğeler isteğe bağlıdır.

GünSystem.Int32

Bu başlangıç saati tarafından yayılan gün sayısını açıklayan 0'dan büyük veya 0'a eşit bir değer.

SaatSystem.Int32

Bu başlangıç saati tarafından yayılan saat sayısını temsil eden 0 ile 23 arasında bir değer.

DakikaSystem.Int32

Bu başlangıç saati tarafından yayılan dakika sayısını temsil eden 0 ile 59 arasında bir değer.

SaniyeSystem.Int32

Bu başlangıç saati tarafından yayılan saniye sayısını temsil eden 0 ile 59 arasında bir değer.

fractionalSecondsSystem.Int32

Kesirli saniyeleri temsil eden 1 ile 7 basamakları içeren bir değer.

Söz diziminin tamamı TimeSpan için sayfanın Açıklamalar bölümüne Parse bakın.

Ayrıca bkz.

• SpeedRatio