MediaTimeline Класс

Определение

Предоставляет Timeline для содержимого мультимедиа.Provides a Timeline for media content.

public ref class MediaTimeline : System::Windows::Media::Animation::Timeline, System::Windows::Markup::IUriContext
public class MediaTimeline : System.Windows.Media.Animation.Timeline, System.Windows.Markup.IUriContext
type MediaTimeline = class
    inherit Timeline
    interface IUriContext
Public Class MediaTimeline
Inherits Timeline
Implements IUriContext
Наследование
Реализации

Комментарии

MediaTimeline — Это Timeline объект, который обеспечивает контроль над синхронизацией мультимедиа таким же образом, как анимация объектов управления временной шкалой.MediaTimeline is a Timeline object which provides control over media timing in the same way that animation timeline objects control animations. Например, MediaTimeline у есть связанные Duration Свойства и, BeginTime которые можно использовать для указания времени начала и продолжительности воспроизведения мультимедиа.For example, a MediaTimeline has associated Duration and BeginTime properties can be used to specify when media begins and how long it plays. Дополнительные сведения о шкалах времени анимации см. в разделе Общие сведения об анимации .See Animation Overview for more information on animation timelines.

Существует два способа связать объект с Timeline MediaElement с помощью MediaTimeline .There are two ways to associate a Timeline to a MediaElement using a MediaTimeline.

  1. Внутри Storyboard , когда объект MediaTimeline имеет целевой объект MediaElement , MediaClock будет создан и назначен MediaElement связанному проигрывателю.Inside of a Storyboard, when a MediaTimeline is targets a MediaElement, a MediaClock will be created and assigned to the MediaElement's associated player. См. раздел как управлять элементом MediaElement с помощью раскадровки для примера.See How to: Control a MediaElement by Using a Storyboard for an example;

  2. Путем явного создания MediaClock из MediaTimeline и назначения его в MediaElement .By explicitly creating a MediaClock from a MediaTimeline and assigning it to a MediaElement.

Если параметру Duration MediaTimeline присвоено значение Automatic (по умолчанию), то длительность MediaTimeline — это естественная длительность источника мультимедиа.If the Duration of the MediaTimeline is set to Automatic (default), the duration of MediaTimeline is the natural duration of the media source. Чтобы определить естественную длительность источника мультимедиа программным способом, запросите NaturalDuration свойство объекта MediaElement .To find the natural duration of the media source programmatically, query the NaturalDuration property of the MediaElement.

Конструкторы

MediaTimeline()

Инициализирует новый экземпляр класса MediaTimeline.Initializes a new instance of the MediaTimeline class.

MediaTimeline(Nullable<TimeSpan>)

Инициализирует новый экземпляр класса MediaTimeline, начинающий воспроизведение в указанное время.Initializes a new instance of the MediaTimeline that begins at the specified time.

MediaTimeline(Nullable<TimeSpan>, Duration)

Инициализирует новый экземпляр класса MediaTimeline, который начинается в заданной время и длиться в течение заданной длительности.Initializes a new instance of the MediaTimeline that begins at the specified time and lasts for the specified duration.

MediaTimeline(Nullable<TimeSpan>, Duration, RepeatBehavior)

Инициализирует новый экземпляр класса MediaTimeline, который начинается в указанное время, длится указанное время и имеет заданное поведение повторения.Initializes a new instance of the MediaTimeline class that begins at the specified time over the specified time and has the specified repeat behavior.

MediaTimeline(Uri)

Инициализирует новый экземпляр класса MediaTimeline, используя заданный универсальный код ресурса (URI) как источник мультимедиа.Initializes a new instance of a MediaTimeline class using the supplied Uri as the media source.

Поля

SourceProperty

Идентифицирует свойство зависимостей Source.Identifies the Source dependency property.

Свойства

AccelerationRatio

Получает или задает значение, указывающее процент значения свойства Duration временной шкалы, за который выполняется ускорение времени от нулевой до максимальной скорости.Gets or sets a value specifying the percentage of the timeline's Duration spent accelerating the passage of time from zero to its maximum rate.

(Унаследовано от Timeline)
AutoReverse

Получает или задает значение, указывающее, воспроизводится ли временная шкала в обратном направлении после завершения прямой итерации.Gets or sets a value that indicates whether the timeline plays in reverse after it completes a forward iteration.

(Унаследовано от Timeline)
BeginTime

Получает или задает время начала Timeline.Gets or sets the time at which this Timeline should begin.

(Унаследовано от Timeline)
CanFreeze

Возвращает значение, которое указывает, можно ли сделать объект неизменяемым.Gets a value that indicates whether the object can be made unmodifiable.

(Унаследовано от Freezable)
DecelerationRatio

Получает или задает значение, указывающее процент значения свойства Duration временной шкалы, за который выполняется замедление течения времени от максимальной скорости до нуля.Gets or sets a value specifying the percentage of the timeline's Duration spent decelerating the passage of time from its maximum rate to zero.

(Унаследовано от Timeline)
DependencyObjectType

Возвращает объект DependencyObjectType , который заключает в оболочку тип CLR данного экземпляра.Gets the DependencyObjectType that wraps the CLR type of this instance.

(Унаследовано от DependencyObject)
Dispatcher

Возвращает объект Dispatcher, с которым связан этот объект DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Унаследовано от DispatcherObject)
Duration

Получает или задает продолжительность воспроизведения шкалы времени без учета повторов.Gets or sets the length of time for which this timeline plays, not counting repetitions.

(Унаследовано от Timeline)
FillBehavior

Получает или задает значение, указывающее, как Timeline ведет себя по достижении конца активного периода.Gets or sets a value that specifies how the Timeline behaves after it reaches the end of its active period.

(Унаследовано от Timeline)
HasAnimatedProperties

Возвращает значение, которое указывает, сопоставлены ли один или несколько объектов AnimationClock любому из свойств зависимостей этого объекта.Gets a value that indicates whether one or more AnimationClock objects is associated with any of this object's dependency properties.

(Унаследовано от Animatable)
IsFrozen

Получает значение, указывающее, доступен ли объект для изменения в настоящее время.Gets a value that indicates whether the object is currently modifiable.

(Унаследовано от Freezable)
IsSealed

Получает значение, указывающее, является ли этот экземпляр в данный момент запечатанным (доступным только для чтения).Gets a value that indicates whether this instance is currently sealed (read-only).

(Унаследовано от DependencyObject)
Name

Получает или задает имя данного объекта Timeline.Gets or sets the name of this Timeline.

(Унаследовано от Timeline)
RepeatBehavior

Получает или задает поведение этой временной шкалы при повторе.Gets or sets the repeating behavior of this timeline.

(Унаследовано от Timeline)
Source

Получает или задает источник мультимедиа, связанный с временной шкалой.Gets or sets the media source associated with the timeline.

SpeedRatio

Получает или задает скорость течения времени этого объекта Timeline относительно родительского объекта.Gets or sets the rate, relative to its parent, at which time progresses for this Timeline.

(Унаследовано от Timeline)

Методы

AllocateClock()

Создает MediaClock для этой временной шкалы.Creates a MediaClock for this timeline.

ApplyAnimationClock(DependencyProperty, AnimationClock)

Применяет AnimationClock к заданному DependencyProperty.Applies an AnimationClock to the specified DependencyProperty. Если свойство уже анимировано, используется эстафетное поведение SnapshotAndReplace.If the property is already animated, the SnapshotAndReplace handoff behavior is used.

(Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)

Применяет AnimationClock к заданному DependencyProperty.Applies an AnimationClock to the specified DependencyProperty. Если свойство уже является анимированным, используется указанное поведение HandoffBehavior.If the property is already animated, the specified HandoffBehavior is used.

(Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline)

Применяет анимацию к указанному DependencyProperty.Applies an animation to the specified DependencyProperty. Анимация начинается при отрисовке следующего кадра.The animation is started when the next frame is rendered. Если указанное свойство уже анимировано, используется поведение перемещения SnapshotAndReplace.If the specified property is already animated, the SnapshotAndReplace handoff behavior is used.

(Унаследовано от Animatable)
BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior)

Применяет анимацию к указанному DependencyProperty.Applies an animation to the specified DependencyProperty. Анимация начинается при отрисовке следующего кадра.The animation is started when the next frame is rendered. Если указанное свойство уже является анимированным, используется указанное поведение HandoffBehavior.If the specified property is already animated, the specified HandoffBehavior is used.

(Унаследовано от Animatable)
CheckAccess()

Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)
ClearValue(DependencyProperty)

Очищает локальное значение свойства.Clears the local value of a property. Очищаемое свойство задается идентификатором DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Унаследовано от DependencyObject)
ClearValue(DependencyPropertyKey)

Очищает локальное значение доступного только для чтения свойства.Clears the local value of a read-only property. Очищаемое свойство задается ключом DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Унаследовано от DependencyObject)
Clone()

Создает изменяемый клон данного объекта MediaTimeline, делая глубокие копии значений этого объекта.Creates a modifiable clone of this MediaTimeline, making deep copies of this object's values. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (которые могут уже не быть разрешимыми), но не копирует анимации и их текущие значения.When copying dependency properties, this method copies resource references and data bindings (but they might no longer resolve) but not animations or their current values.

CloneCore(Freezable)

Делает этот экземпляр глубокой копией указанного объекта MediaTimeline.Makes this instance a deep copy of the specified MediaTimeline. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (которые могут уже не быть разрешимыми), но не копирует анимации и их текущие значения.When copying dependency properties, this method copies resource references and data bindings (but they might no longer resolve) but not animations or their current values.

CloneCurrentValue()

Создает модифицируемый клон данного объекта MediaTimeline, делая глубокие копии текущих значений этого объекта.Creates a modifiable clone of this MediaTimeline object, making deep copies of this object's current values. Ссылки на ресурсы, привязки данных и анимации не копируются, но копируются их текущие значения.Resource references, data bindings, and animations are not copied, but their current values are.

CloneCurrentValueCore(Freezable)

Делает этот экземпляр изменяемой глубокой копией указанной коллекции MediaTimeline с использованием текущих значений свойств.Makes this instance a modifiable deep copy of the specified MediaTimeline using current property values. Ссылки на ресурсы, привязки данных и анимации не копируются, но копируются их текущие значения.Resource references, data bindings, and animations are not copied, but their current values are.

CoerceValue(DependencyProperty)

Приводит значение указанного свойства зависимостей.Coerces the value of the specified dependency property. Это осуществляется путем вызова какой-либо функции CoerceValueCallback, указанной в метаданных свойства зависимостей, которое существует в вызывающем объекте DependencyObject.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Унаследовано от DependencyObject)
CreateClock()

Создает новый MediaClock, связанный с MediaTimeline.Creates a new MediaClock associated with the MediaTimeline.

CreateClock(Boolean)

Создает новый объект Clock на основе этого объекта Timeline и определяет, является ли новый объект Clock управляемым.Creates a new Clock from this Timeline and specifies whether the new Clock is controllable. Если данный объект Timeline имеет дочерние элементы, создается дерево таймеров с этим объектом Timeline в качестве корня.If this Timeline has children, a tree of clocks is created with this Timeline as the root.

(Унаследовано от Timeline)
CreateInstance()

Инициализирует новый экземпляр класса Freezable.Initializes a new instance of the Freezable class.

(Унаследовано от Freezable)
CreateInstanceCore()

Создает новый экземпляр класса MediaTimeline.Creates a new instance of the MediaTimeline.

Equals(Object)

Определяет, является ли указанный DependencyObject эквивалентом текущего DependencyObject.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Унаследовано от DependencyObject)
Freeze()

Делает текущий объект неизменяемым и присваивает его свойству IsFrozen значение true.Makes the current object unmodifiable and sets its IsFrozen property to true.

(Унаследовано от Freezable)
FreezeCore(Boolean)

Делает данный экземпляр MediaTimeline неизменяемым или определяет, может ли он быть сделан неизменяемым.Makes this instance of MediaTimeline unmodifiable or determines whether it can be made unmodifiable.

GetAnimationBaseValue(DependencyProperty)

Возвращает не анимированное значение указанного объекта DependencyProperty.Returns the non-animated value of the specified DependencyProperty.

(Унаследовано от Animatable)
GetAsFrozen()

Создает фиксированную копию объекта Freezable, используя базовые (не анимационные) значения свойств.Creates a frozen copy of the Freezable, using base (non-animated) property values. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Унаследовано от Freezable)
GetAsFrozenCore(Freezable)

Делает этот экземпляр клоном указанного объекта MediaTimeline.Makes this instance a clone of the specified MediaTimeline object.

GetCurrentValueAsFrozen()

Создает фиксированную копию объекта Freezable с использованием текущих значений свойств.Creates a frozen copy of the Freezable using current property values. Так как копия является фиксированной, копируются только ссылки на фиксированные вложенные объекты.Because the copy is frozen, any frozen sub-objects are copied by reference.

(Унаследовано от Freezable)
GetCurrentValueAsFrozenCore(Freezable)

Делает этот экземпляр зафиксированным клоном указанного объекта MediaTimeline.Makes this instance a frozen clone of the specified MediaTimeline. Ссылки на ресурсы, привязки данных и анимации не копируются, но копируются их текущие значения.Resource references, data bindings, and animations are not copied, but their current values are.

GetHashCode()

Возвращает хэш-код для данного объекта DependencyObject.Gets a hash code for this DependencyObject.

(Унаследовано от DependencyObject)
GetLocalValueEnumerator()

Создает специализированный перечислитель для определения свойств зависимостей, которые локально установили значения для данного DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Унаследовано от DependencyObject)
GetNaturalDuration(Clock)

Возвращает продолжительность отдельной итерации этого объекта Timeline.Returns the length of a single iteration of this Timeline.

(Унаследовано от Timeline)
GetNaturalDurationCore(Clock)

Извлекает Duration из заданных часов.Retrieves the Duration from a specified clock.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
GetValue(DependencyProperty)

Возвращает текущее действующее значение свойства зависимостей в этом экземпляре DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Унаследовано от DependencyObject)
InvalidateProperty(DependencyProperty)

Повторно вычисляет действующее значение для указанного свойства зависимостей.Re-evaluates the effective value for the specified dependency property.

(Унаследовано от DependencyObject)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnChanged()

Вызывается при изменении текущего объекта Freezable.Called when the current Freezable object is modified.

(Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject)

Обеспечивает создание соответствующих указателей контекста для элемента данных типа DependencyObjectType, который был только что задан.Ensures that appropriate context pointers are established for a DependencyObjectType data member that has just been set.

(Унаследовано от Freezable)
OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty)

Этот элемент поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для непосредственного использования из кода.This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

(Унаследовано от Freezable)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Переопределяет реализацию DependencyObject для OnPropertyChanged(DependencyPropertyChangedEventArgs), чтобы также вызвать любой обработчик Changed в ответ на изменение свойства зависимостей типа Freezable.Overrides the DependencyObject implementation of OnPropertyChanged(DependencyPropertyChangedEventArgs) to also invoke any Changed handlers in response to a changing dependency property of type Freezable.

(Унаследовано от Freezable)
ReadLocalValue(DependencyProperty)

Возвращает локальное значение свойства зависимостей, если таковое существует.Returns the local value of a dependency property, if it exists.

(Унаследовано от DependencyObject)
ReadPreamble()

Обеспечивает доступ к Freezable из допустимого потока.Ensures that the Freezable is being accessed from a valid thread. Наследники объекта Freezable должны вызывать данный метод в начале любого API, который считывает элементы данных, не являющиеся свойствами зависимостей.Inheritors of Freezable must call this method at the beginning of any API that reads data members that are not dependency properties.

(Унаследовано от Freezable)
SetCurrentValue(DependencyProperty, Object)

Задает значение свойства зависимостей, не меняя источник значения.Sets the value of a dependency property without changing its value source.

(Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)

Задает локальное значение свойства зависимостей, указанного идентификатором этого свойства.Sets the local value of a dependency property, specified by its dependency property identifier.

(Унаследовано от DependencyObject)
SetValue(DependencyPropertyKey, Object)

Задает локальное значение свойства зависимости только для чтения, определяемое идентификатором DependencyPropertyKey свойства зависимостей.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Унаследовано от DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Возвращает значение, которое указывает, следует ли процессам сериализации выполнять сериализацию значения для предоставленного свойства зависимостей.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Унаследовано от DependencyObject)
ToString()

Возвращает строку, представляющую источник мультимедиа.Returns the string that represents the media source.

VerifyAccess()

Обеспечивает наличие у вызывающего потока доступ к этому DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Унаследовано от DispatcherObject)
WritePostscript()

Вызывает событие Changed для объекта Freezable и вызывает его метод OnChanged().Raises the Changed event for the Freezable and invokes its OnChanged() method. Классы, производные от Freezable, должны вызывать этот метод в конце любого API, который изменяет члены класса, не сохраненные в виде свойств зависимостей.Classes that derive from Freezable should call this method at the end of any API that modifies class members that are not stored as dependency properties.

(Унаследовано от Freezable)
WritePreamble()

Проверяет, что объект Freezable не заморожен и доступ к нему осуществляется из допустимого контекста потока.Verifies that the Freezable is not frozen and that it is being accessed from a valid threading context. Наследники объекта Freezable должны вызывать данный метод в начале любого API, который выполняет запись в элементах данных, не являющихся свойствами зависимостей.Freezable inheritors should call this method at the beginning of any API that writes to data members that are not dependency properties.

(Унаследовано от Freezable)

События

Changed

Происходит, когда изменяется класс Freezable или объект, который входит в его состав.Occurs when the Freezable or an object it contains is modified.

(Унаследовано от Freezable)
Completed

Происходит, когда воспроизведение шкалы времени полностью завершено: шкала времени больше не входит в активный период.Occurs when this timeline has completely finished playing: it will no longer enter its active period.

(Унаследовано от Timeline)
CurrentGlobalSpeedInvalidated

Происходит при изменении скорости течения времени для часов шкалы времени.Occurs when the rate at which time progresses for the timeline's clock changes.

(Унаследовано от Timeline)
CurrentStateInvalidated

Происходит при обновлении свойства CurrentState объекта Clock временной шкалы.Occurs when the CurrentState property of the timeline's Clock is updated.

(Унаследовано от Timeline)
CurrentTimeInvalidated

Происходит при обновлении свойства CurrentTime объекта Clock временной шкалы.Occurs when the CurrentTime property of the timeline's Clock is updated.

(Унаследовано от Timeline)
RemoveRequested

Происходит при удалении часов, созданных для этой шкалы времени или одной из ее родительских шкал времени.Occurs when the clock created for this timeline or one of its parent timelines is removed.

(Унаследовано от Timeline)

Явные реализации интерфейса

IUriContext.BaseUri

Возвращает или задает базовый универсальный идентификатор ресурса (URI) текущего контекста приложения.Gets or sets the base URI of the current application context.

Применяется к