Timeline Sınıf

Tanım

Ad Alanı:

System.Windows.Media.Animation

Bütünleştirilmiş Kod:

PresentationCore.dll

Zaman dilimini tanımlar.

public ref class Timeline abstract : System::Windows::Media::Animation::Animatable

[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
[System.Windows.Markup.RuntimeNameProperty("Name")]
public abstract class Timeline : System.Windows.Media.Animation.Animatable

[<System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)>]
[<System.Windows.Markup.RuntimeNameProperty("Name")>]
type Timeline = class
    inherit Animatable

Public MustInherit Class Timeline
Inherits Animatable

Devralma

Object

DispatcherObject

DependencyObject

Freezable

Animatable

Timeline

Türetilmiş

System.Windows.Media.Animation.AnimationTimeline

System.Windows.Media.Animation.TimelineGroup

System.Windows.Media.MediaTimeline

Öznitelikler

LocalizabilityAttribute RuntimeNamePropertyAttribute

Açıklamalar

Zaman çizelgesi bir zaman dilimini temsil eder. Bu, bu segmentin uzunluğunu, ne zaman başlaması gerektiğini, kaç kez yineleneceğini, bu segmentte ne kadar hızlı ilerlediğini ve daha fazlasını belirtmenizi sağlayan özellikler sağlar.

Zaman çizelgesi sınıfından devralan sınıflar, animasyon ve medya kayıttan yürütme gibi ek işlevler sağlar. Aşağıda, kullanılabilir farklı türlerdeki özel zaman çizelgelerinin örnekleri verilmiştir.

• Animasyonlar: Bir AnimationTimeline , çıkış değerleri üreten bir zaman çizelgesi türüdür. Bir animasyonu bir özellikle ilişkilendirdiğinizde, animasyon oynatıldığında özelliğin değerini güncelleştirir ve böylece "animasyon" oluşturur. Animasyonlara giriş için bkz. Animasyona Genel Bakış. Animasyonları uygulamanın farklı yolları hakkında bilgi için bkz. Özellik Animasyon Tekniklerine Genel Bakış.

• MediaTimelines: A MediaTimeline , bir medya dosyasının kayıttan yürütülmesini denetleen bir zaman çizelgesi türüdür.

• ParallelTimelines: A ParallelTimeline , diğer zaman çizelgelerini gruplandıran bir zaman çizelgesi türüdür.

• Görsel Taslaklar: A Storyboard , içerdiği zaman çizelgeleri için nesne ve özellik hedefleme bilgileri sağlayan özel bir türüdür ParallelTimeline . Nesneler hakkında Storyboard daha fazla bilgi için bkz. Görsel Taslaklara Genel Bakış.

Zaman çizelgelerini kullanma hakkında daha fazla bilgi için bkz. Animasyona Genel Bakış. Zaman çizelgelerinin zamanlama özelliklerine giriş için bkz . Zamanlama Davranışlarına Genel Bakış.

Veri Bağlama ve Zaman Çizelgelerini Animasyonu Oluşturma

Zaman çizelgesi özelliklerinin çoğu veriye bağlı veya animasyonlu olabilir; ancak zamanlama sisteminin çalışma şekli nedeniyle, veri bağlı veya animasyonlu zaman çizelgeleri diğer veri bağlı veya animasyonlu nesneler gibi davranmaz. Davranışlarını anlamak için zaman çizelgesini etkinleştirmenin ne anlama geldiğini anlamanıza yardımcı olur.

Zaman çizelgesi uygulandığında, kopyalar zaman çizelgesinden ve alt zaman çizelgelerinden oluşturulur. Bu kopyalar dondurulur (salt okunur yapılır) ve Clock nesnelerden oluşturulur. Hedeflenen özelliklere animasyon ekleme işleminin asıl işini bu saatler yapar. Zaman çizelgesi veriye bağlı veya animasyonluysa, saati oluşturulduğunda geçerli değerlerinin anlık görüntüsü oluşturulur. Özgün zaman çizelgesi değişmeye devam etse de, saati değişmez.

Zaman çizelgesinin veri bağlama veya animasyon değişikliklerini yansıtması için saati yeniden oluşturulmalıdır. Saatler sizin için otomatik olarak yeniden oluşturulmuyor. Zaman çizelgesi değişikliklerini uygulamanın birkaç yolu şunlardır:

• Zaman çizelgesi bir Storyboard öğesine aitse, değişiklikleri yansıtmak için BeginStoryboard veya Begin yöntemini kullanarak görsel taslağını yeniden uygulayabilirsiniz. Bu, animasyonu yeniden başlatmanın yan etkisine sahiptir. Kodda, görsel şeridi önceki konumuna geri döndürmek için yöntemini kullanabilirsiniz Seek .

• Yöntemini kullanarak BeginAnimation bir özelliğe doğrudan animasyon uyguladıysanız, yöntemini yeniden çağırın BeginAnimation ve değiştirilen animasyonu geçirin.

• Doğrudan saat düzeyinde çalışıyorsanız, yeni bir saat kümesi oluşturup uygulayın ve bunları önceki oluşturulan saat kümesini değiştirmek için kullanın.

Veriye bağlı animasyon örneği için bkz . Anahtar Spline Animasyon Örneği .

Zaman Çizelgesini Zamanlayıcı Olarak Kullanma

Zaman çizelgesinin saati yalnızca kendisiyle ilişkilendirilmiş bir olay işleyicisi olduğunda veya (nesne AnimationClock söz konusu olduğunda) bir özellikle ilişkilendirildiğinde ilerler. Bu nedenle (ve diğerleri) zamanlayıcı olarak kullanmanız Timeline önerilmez.

Oluşturucular

Name	Description
Timeline()	Timeline sınıfının yeni bir örneğini başlatır.
Timeline(Nullable<TimeSpan>, Duration, RepeatBehavior)	Belirtilen Timeline, BeginTimeve Durationile sınıfının yeni bir örneğini RepeatBehavior başlatır.
Timeline(Nullable<TimeSpan>, Duration)	Belirtilen Timeline ve BeginTimeile Duration sınıfının yeni bir örneğini başlatır.
Timeline(Nullable<TimeSpan>)	belirtilen Timelineile BeginTime sınıfının yeni bir örneğini başlatır.

Alanlar

Name	Description
AccelerationRatioProperty	AccelerationRatio Bağımlılık özelliğini tanımlar.
AutoReverseProperty	AutoReverse Bağımlılık özelliğini tanımlar.
BeginTimeProperty	BeginTime Bağımlılık özelliğini tanımlar.
DecelerationRatioProperty	Bağımlılık özelliği için DecelerationRatio tanımlar.
DesiredFrameRateProperty	Ekli özelliği tanımlar DesiredFrameRate .
DurationProperty	Duration Bağımlılık özelliğini tanımlar.
FillBehaviorProperty	FillBehavior Bağımlılık özelliğini tanımlar.
NameProperty	Name Bağımlılık özelliğini tanımlar.
RepeatBehaviorProperty	RepeatBehavior Bağımlılık özelliğini tanımlar.
SpeedRatioProperty	Bağımlılık özelliği için SpeedRatio tanımlar.

Özellikler

Name	Description
AccelerationRatio	Zaman çizelgesinin Duration harcanan yüzdesini belirterek sıfırdan en yüksek hıza kadar olan süreyi hızlandıran bir değer alır veya ayarlar.
AutoReverse	Zaman çizelgesinin ileriye doğru yineleme tamamlandıktan sonra ters oynatılıp oynatılmadığını gösteren bir değer alır veya ayarlar.
BeginTime	Bunun Timeline başlaması gereken zamanı alır veya ayarlar.
CanFreeze	Nesnenin değiştirilemez hale getirilip getirilemeyeceğini gösteren bir değer alır. (Devralındığı yer: Freezable)
DecelerationRatio	Zaman çizelgesinin Duration harcanan yüzdesini belirten bir değeri alır veya ayarlar ve zaman çizelgesinin en yüksek hızından sıfıra geçişini yavaşlatır.
DependencyObjectType	DependencyObjectType Bu örneğin CLR türünü sarmalayan öğesini alır. (Devralındığı yer: DependencyObject)
Dispatcher	Dispatcher Bunun DispatcherObject ilişkili olduğu öğesini alır. (Devralındığı yer: DispatcherObject)
Duration	Yinelemeleri saymak yerine bu zaman çizelgesinin yürütülme süresini alır veya ayarlar.
FillBehavior	Etkin süresinin sonuna ulaştıktan sonra değerinin nasıl Timeline davranacağını belirten bir değer alır veya ayarlar.
HasAnimatedProperties	Bir veya daha fazla AnimationClock nesnenin bu nesnenin bağımlılık özelliklerinden herhangi biriyle ilişkili olup olmadığını gösteren bir değer alır. (Devralındığı yer: Animatable)
IsFrozen	Nesnenin şu anda değiştirilebilir olup olmadığını gösteren bir değer alır. (Devralındığı yer: Freezable)
IsSealed	Bu örneğin şu anda korumalı (salt okunur) olup olmadığını gösteren bir değer alır. (Devralındığı yer: DependencyObject)
Name	Bu Timelineöğesinin adını alır veya ayarlar.
RepeatBehavior	Bu zaman çizelgesinin yinelenen davranışını alır veya ayarlar.
SpeedRatio	Bu için ilerlediği Timelineana öğeye göre hızı alır veya ayarlar.

İliştirilmiş Özellikler

Name	Description
DesiredFrameRate	Bu zaman çizelgesi ve alt zaman çizelgeleri için istenen kare hızını alır veya ayarlar.

Yöntemler

Name	Description
AllocateClock()	Bunun Clockiçin bir Timeline oluşturur.
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Belirtilen AnimationClocköğesine bir DependencyProperty uygular. Özellik zaten animasyonluysa, belirtilen HandoffBehavior kullanılır. (Devralındığı yer: Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Belirtilen AnimationClocköğesine bir DependencyProperty uygular. Özelliği zaten animasyonlu ise, SnapshotAndReplace iletim davranışı kullanılır. (Devralındığı yer: Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)	Belirtilen DependencyPropertyöğesine bir animasyon uygular. Animasyon, sonraki çerçeve işlendiğinde başlatılır. Belirtilen özellik zaten animasyonluysa, belirtilen HandoffBehavior kullanılır. (Devralındığı yer: Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)	Belirtilen DependencyPropertyöğesine bir animasyon uygular. Animasyon, sonraki çerçeve işlendiğinde başlatılır. Belirtilen özellik zaten animasyonluysa, SnapshotAndReplace iletim davranışı kullanılır. (Devralındığı yer: Animatable)
CheckAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişimi olup olmadığını belirler. (Devralındığı yer: DispatcherObject)
ClearValue(DependencyProperty)	Bir özelliğin yerel değerini temizler. Temizlenecek özellik bir DependencyProperty tanımlayıcı tarafından belirtilir. (Devralındığı yer: DependencyObject)
ClearValue(DependencyPropertyKey)	Salt okunur özelliğin yerel değerini temizler. Temizlenecek özellik tarafından DependencyPropertyKeybelirtilir. (Devralındığı yer: DependencyObject)
Clone()	Bu Timelinenesnenin değerlerinin derin kopyalarını oluşturarak bu öğesinin değiştirilebilir bir kopyasını oluşturur.
CloneCore(Freezable)	Temel (animasyonsuz) özellik değerlerini kullanarak örneği belirtilenlerin Freezable bir kopyası (derin kopya) yapar. (Devralındığı yer: Freezable)
CloneCurrentValue()	Bu nesnenin değiştirilebilir bir kopyasını oluşturarak bu Timeline nesnenin geçerli değerlerinin derin kopyalarını oluşturur.
CloneCurrentValueCore(Freezable)	Geçerli özellik değerlerini kullanarak örneği belirtilenlerin Freezable değiştirilebilir bir kopyası (derin kopya) yapar. (Devralındığı yer: Freezable)
CoerceValue(DependencyProperty)	Belirtilen bağımlılık özelliğinin değerini zorlama. Bu, çağrısında CoerceValueCallbackvar olan bağımlılık özelliği için özellik meta verilerinde belirtilen herhangi bir DependencyObject işlevi çağırarak gerçekleştirilir. (Devralındığı yer: DependencyObject)
CreateClock()	Bu Timelinesürümünden yeni, denetlenebilir Clock bir oluşturur. Bunun Timeline alt öğeleri varsa, kök olarak bununla Timeline bir saat ağacı oluşturulur.
CreateClock(Boolean)	Bundan Clock yeni Timeline bir oluşturur ve yeninin Clock denetlenebilir olup olmadığını belirtir. Bunun Timeline alt öğeleri varsa, kök olarak bununla Timeline bir saat ağacı oluşturulur.
CreateInstance()	Freezable sınıfının yeni bir örneğini başlatır. (Devralındığı yer: Freezable)
CreateInstanceCore()	Türetilmiş bir sınıfta uygulandığında, türetilmiş sınıfın Freezable yeni bir örneğini oluşturur. (Devralındığı yer: Freezable)
Equals(Object)	Sağlanan DependencyObject öğesinin geçerli DependencyObjectile eşdeğer olup olmadığını belirler. (Devralındığı yer: DependencyObject)
Freeze()	Geçerli nesneyi değiştirilemez hale getirir ve özelliğini olarak IsFrozenayarlartrue. (Devralındığı yer: Freezable)
FreezeCore(Boolean)	Bunu Timeline değiştirilemez hale getirir veya değiştirilemez hale getirilip getirilemeyeceğini belirler.
GetAnimationBaseValue(DependencyProperty)	Belirtilen DependencyPropertyöğesinin animasyonsuz değerini döndürür. (Devralındığı yer: Animatable)
GetAsFrozen()	temel (animasyonsuz) özellik değerlerini kullanarak donmuş bir kopyasını Freezableoluşturur. Kopya dondurulacağından, dondurulan alt nesneler başvuruyla kopyalanır. (Devralındığı yer: Freezable)
GetAsFrozenCore(Freezable)	Bu örneği belirtilen Timeline nesnenin bir kopyası yapar.
GetCurrentValueAsFrozen()	Geçerli özellik değerlerini kullanarak donmuş Freezable bir kopyasını oluşturur. Kopya dondurulacağından, dondurulan alt nesneler başvuruyla kopyalanır. (Devralındığı yer: Freezable)
GetCurrentValueAsFrozenCore(Freezable)	Bu örneği, belirtilen Timelineöğesinin donmuş bir kopyası yapar. Kaynak başvuruları, veri bağlamaları ve animasyonlar kopyalanmaz, ancak geçerli değerleri kopyalanır.
GetDesiredFrameRate(Timeline)	Belirtilen Timelinedeğerinin istenen kare hızını alır.
GetHashCode()	Bu DependencyObjectiçin bir karma kodu alır. (Devralındığı yer: DependencyObject)
GetLocalValueEnumerator()	Hangi bağımlılık özelliklerinin bu DependencyObjectüzerinde yerel olarak ayarlı değerlere sahip olduğunu belirlemek için özel bir numaralandırıcı oluşturur. (Devralındığı yer: DependencyObject)
GetNaturalDuration(Clock)	Bu Timelineyinelemenin tek bir yinelemesinin uzunluğunu döndürür.
GetNaturalDurationCore(Clock)	Bu Timelineyinelemenin tek bir yinelemesinin uzunluğunu döndürür. Bu yöntem için GetNaturalDuration(Clock)uygulamasını sağlar.
GetValue(DependencyProperty)	Bir öğesinin bu örneğindeki bir bağımlılık özelliğinin DependencyObjectgeçerli etkin değerini döndürür. (Devralındığı yer: DependencyObject)
InvalidateProperty(DependencyProperty)	Belirtilen bağımlılık özelliği için geçerli değeri yeniden değerlendirir. (Devralındığı yer: DependencyObject)
OnChanged()	Geçerli Freezable nesne değiştirildiğinde çağrılır. (Devralındığı yer: Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)	Bu üye Windows Presentation Foundation (WPF) altyapısını destekler ve doğrudan kodunuzdan kullanılması amaçlanmamıştır. (Devralındığı yer: Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)	Yeni ayarlanmış bir DependencyObjectType veri üyesi için uygun bağlam işaretçilerinin oluşturulmasını sağlar. (Devralındığı yer: Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	türündeki DependencyObjectOnPropertyChanged(DependencyPropertyChangedEventArgs)değişen bağımlılık özelliğine yanıt olarak herhangi Changed bir işleyici çağırmak için uygulamasını Freezable geçersiz kılar. (Devralındığı yer: Freezable)
ReadLocalValue(DependencyProperty)	Varsa, bağımlılık özelliğinin yerel değerini döndürür. (Devralındığı yer: DependencyObject)
ReadPreamble()	Freezable geçerli bir iş parçacığından erişildiğinden emin olur. öğesinin Freezable devralanları, bağımlılık özellikleri olmayan veri üyelerini okuyan herhangi bir API'nin başında bu yöntemi çağırmalıdır. (Devralındığı yer: Freezable)
SetCurrentValue(DependencyProperty, Object)	Bir bağımlılık özelliğinin değerini, değer kaynağını değiştirmeden ayarlar. (Devralındığı yer: DependencyObject)
SetDesiredFrameRate(Timeline, Nullable<Int32>)	Belirtilen Timelineöğesinin istenen kare hızını ayarlar.
SetValue(DependencyProperty, Object)	Bağımlılık özelliği tanımlayıcısı tarafından belirtilen bir bağımlılık özelliğinin yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
SetValue(DependencyPropertyKey, Object)	Bağımlılık özelliğinin tanımlayıcısı tarafından belirtilen salt okunur bağımlılık özelliğinin DependencyPropertyKey yerel değerini ayarlar. (Devralındığı yer: DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Serileştirme işlemlerinin sağlanan bağımlılık özelliği için değeri serileştirmesi gerekip gerekmediğini gösteren bir değer döndürür. (Devralındığı yer: DependencyObject)
VerifyAccess()	Çağıran iş parçacığının bu DispatcherObjectöğesine erişmesini zorlar. (Devralındığı yer: DispatcherObject)
WritePostscript()	Changed için Freezable olayını oluşturur ve yöntemini çağırırOnChanged(). öğesinden Freezable türetilen sınıflar, bağımlılık özellikleri olarak depolanmayan sınıf üyelerini değiştiren herhangi bir API'nin sonunda bu yöntemi çağırmalıdır. (Devralındığı yer: Freezable)
WritePreamble()	öğesinin Freezable dondurulmadığını ve geçerli bir iş parçacığı bağlamından erişildiğini doğrular. Freezable devralanların, bağımlılık özellikleri olmayan veri üyelerine yazan herhangi bir API'nin başında bu yöntemi çağırması gerekir. (Devralındığı yer: Freezable)

Ekinlikler

Name	Description
Changed	veya içerdiği bir nesne değiştirildiğinde Freezable gerçekleşir. (Devralındığı yer: Freezable)
Completed	Bu zaman çizelgesinin yürütülmesi tamamen bittiğinde gerçekleşir: artık etkin dönemine girmeyecek.
CurrentGlobalSpeedInvalidated	Zaman çizelgesinin saatinin ilerleme hızı değiştiğinde gerçekleşir.
CurrentStateInvalidated	Zaman çizelgesinin CurrentStateClock özelliği güncelleştirildiğinde gerçekleşir.
CurrentTimeInvalidated	Zaman çizelgesinin CurrentTimeClock özelliği güncelleştirildiğinde gerçekleşir.
RemoveRequested	Bu zaman çizelgesi için oluşturulan saat veya üst zaman çizelgelerinden biri kaldırıldığında gerçekleşir.

Ayrıca bkz.

• Animasyon Zamanlama Davranışı Örneği