Clock Clock Clock Clock Class

Определение

Обеспечивает расчет времени для объекта Timeline во время выполнения.Maintains run-time timing state for a Timeline.

public ref class Clock : System::Windows::Threading::DispatcherObject
public class Clock : System.Windows.Threading.DispatcherObject
type Clock = class
    inherit DispatcherObject
Public Class Clock
Inherits DispatcherObject
Наследование
Производный

Комментарии

Объект Timeline, сама по себе фактически ничего не делает просто описывает сегмент времени.A Timeline, by itself, doesn't actually do anything other than describe a segment of time. Он является временной шкалы Clock объект, который не работает: он обеспечивает связана со временем состояние времени выполнения для временной шкалы.It's the timeline's Clock object that does the real work: it maintains timing-related run-time state for the timeline.

В большинстве случаев часы создаются автоматически для временной шкалы.In most cases, a clock is created automatically for your timeline. При анимации с помощью Storyboard или BeginAnimation метод, часы автоматически создаются для временной шкалы и анимации и применить к их целевым свойствам.When you animate by using a Storyboard or the BeginAnimation method, clocks are automatically created for your timelines and animations and applied to their targeted properties. Примеры см. в разделах Практическое руководство. Анимация свойства с помощью раскадровки и как: Анимация свойства без раскадровки.For examples, see How to: Animate a Property by Using a Storyboard and How to: Animate a Property Without Using a Storyboard.

Вы также можете создать Clock явным образом с помощью CreateClock метод.You can also create a Clock explicitly by using the CreateClock method. В сценариях с высокой нагрузкой, например при анимации большого количества сходных объектов, управление использованием Clock использования может дать выигрыш в производительности.In performance-intensive scenarios, such as animating large numbers of similar objects, managing your own Clock use can provide performance benefits.

Часы упорядочиваются в деревья, которые соответствуют структуре Timeline дерева объектов, из которой они созданы.Clocks are arranged in trees that match the structure of the Timeline objects tree from which they are created. Корневые часы дерево временной шкалы можно интерактивно управлять (приостановлена, возобновлен, остановлена и т. д.), получив его Controller.The root clock of such a timing tree can be interactively manipulated (paused, resumed, stopped, and so on) by retrieving its Controller. Прямое управление часами некорневых.Non-root clocks cannot be directly controlled.

После создания невозможно изменить часов (но ими можно управлять).Once created, a clock cannot be modified (but it can be manipulated).

С помощью временной шкалы в качестве таймераUsing a Timeline as a Timer

При отсутствии обработчиков событий, связанных с ним только развивается временной шкалы времени или (в случае использования AnimationClock объекта) он связан со свойством.A timeline's clock will only progress when there's an event handler associated with it or (in the case of an AnimationClock object) it is associated with a property. По этой причине (и других), его не рекомендуется использовать Timeline качестве таймера.For this reason (and others), it's not recommended that you use a Timeline as a timer.

Примечания для тех, кто наследует этот метод

Производные классы должны реализовывать GetCurrentTimeCore() при необходимости изменить, как проходит время для часов.Derived classes should implement GetCurrentTimeCore() if they want to modify how time flows for this clock. Производные классы могут выполняться выполнить дополнительную работу при часы повторяется, пропускает, операции поиска, начинает, приостанавливает, возобновляет или остановке путем переопределения DiscontinuousTimeMovement(), SpeedChanged(), и Stopped() методы.Derived classes can be made to do additional work when the clock repeats, skips, seeks, begins, pauses, resumes, or stops by overriding the DiscontinuousTimeMovement(), SpeedChanged(), and Stopped() methods.

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

Clock(Timeline) Clock(Timeline) Clock(Timeline) Clock(Timeline)

Выполняет инициализацию нового экземпляра класса Clock с использованием указанного объекта Timeline в качестве шаблона.Initializes a new instance of the Clock class, using the specified Timeline as a template. Новый объект Clock не имеет дочерних объектов.The new Clock object has no children.

Свойства

Controller Controller Controller Controller

Возвращает объект ClockController, который можно использовать для запуска, приостановки, возобновления, поиска, перехода, останова или удаления этого объекта Clock.Gets a ClockController that can be used to start, pause, resume, seek, skip, stop, or remove this Clock.

CurrentGlobalSpeed CurrentGlobalSpeed CurrentGlobalSpeed CurrentGlobalSpeed

Получает текущую скорость хода часов по сравнению с реальным временем.Gets the rate at which the clock's time is currently progressing, compared to real-world time.

CurrentGlobalTime CurrentGlobalTime CurrentGlobalTime CurrentGlobalTime

Возвращает текущее глобальное время, установленное системой расчета времени WPFWPF.Gets the current global time, as established by the WPFWPF timing system.

CurrentIteration CurrentIteration CurrentIteration CurrentIteration

Возвращает текущую итерацию часов.Get the current iteration of this clock.

CurrentProgress CurrentProgress CurrentProgress CurrentProgress

Возвращает текущее положение объекта Clock в текущей итерации.Gets the current progress of this Clock within its current iteration.

CurrentState CurrentState CurrentState CurrentState

Получает значение, указывающее текущее состояние таймера: Active, Filling или Stopped.Gets a value indicating whether the clock is currently Active, Filling, or Stopped.

CurrentTime CurrentTime CurrentTime CurrentTime

Возвращает текущее время часов в текущей итерации.Gets this clock's current time within its current iteration.

Dispatcher Dispatcher Dispatcher Dispatcher

Получает Dispatcher это DispatcherObject связан.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
HasControllableRoot HasControllableRoot HasControllableRoot HasControllableRoot

Возвращает значение, которое указывает, является ли объект Clock частью управляемого дерева часов.Gets a value that indicates whether this Clock is part of a controllable clock tree.

IsPaused IsPaused IsPaused IsPaused

Возвращает значение, которое указывает, приостановлен ли объект Clock или любой из его родительских объектов.Gets a value that indicates whether this Clock, or any of its parents, is paused.

NaturalDuration NaturalDuration NaturalDuration NaturalDuration

Возвращает естественную длительность объекта Timeline часов.Gets the natural duration of this clock's Timeline.

Parent Parent Parent Parent

Возвращает объект часов, являющийся родительским для данного объекта.Gets the clock that is the parent of this clock.

Timeline Timeline Timeline Timeline

Возвращает объект Timeline, на основе которого был создан данный объект Clock.Gets the Timeline from which this Clock was created.

Методы

CheckAccess() CheckAccess() CheckAccess() CheckAccess()

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

(Inherited from DispatcherObject)
DiscontinuousTimeMovement() DiscontinuousTimeMovement() DiscontinuousTimeMovement() DiscontinuousTimeMovement()

При реализации в производном классе этот метод вызывается при повторении, пропуске или поиске часов.When implemented in a derived class, will be invoked whenever a clock repeats, skips, or seeks.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetCanSlip() GetCanSlip() GetCanSlip() GetCanSlip()

Возвращает значение, указывающее, имеет ли объект Clock собственный внешний источник времени, для которого может потребоваться синхронизация с системой расчета времени.Returns whether the Clock has its own external time source, which may require synchronization with the timing system.

GetCurrentTimeCore() GetCurrentTimeCore() GetCurrentTimeCore() GetCurrentTimeCore()

Возвращает текущее время часов в текущей итерации.Gets this clock's current time within its current iteration.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
SpeedChanged() SpeedChanged() SpeedChanged() SpeedChanged()

При реализации в производном классе вызывается при запуске, переходе, приостановке и возобновлении часов, а также при изменении объекта SpeedRatio часов.When implemented in a derived class, will be invoked whenever a clock begins, skips, pauses, resumes, or when the clock's SpeedRatio is modified.

Stopped() Stopped() Stopped() Stopped()

При реализации в производном классе вызывается при останове часов с использованием метода Stop().When implemented in a derived class, will be invoked whenever a clock is stopped using the Stop() method.

ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)
VerifyAccess() VerifyAccess() VerifyAccess() VerifyAccess()

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

(Inherited from DispatcherObject)

События

Completed Completed Completed Completed

Происходит при полной остановке воспроизведения часов.Occurs when this clock has completely finished playing.

CurrentGlobalSpeedInvalidated CurrentGlobalSpeedInvalidated CurrentGlobalSpeedInvalidated CurrentGlobalSpeedInvalidated

Происходит при обновлении скорости хода часов.Occurs when the clock's speed is updated.

CurrentStateInvalidated CurrentStateInvalidated CurrentStateInvalidated CurrentStateInvalidated

Возникает при обновлении свойства часов CurrentState.Occurs when the clock's CurrentState property is updated.

CurrentTimeInvalidated CurrentTimeInvalidated CurrentTimeInvalidated CurrentTimeInvalidated

Происходит в момент, когда параметр CurrentTime часов становится недействительным.Occurs when this clock's CurrentTime becomes invalid.

RemoveRequested RemoveRequested RemoveRequested RemoveRequested

Происходит при вызове метода Remove() в объекте Clock или одном из его родительских объектов.Occurs when the Remove() method is called on this Clock or one of its parent clocks.

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