Clock Clock Clock Clock Class

Definition

Verwaltet den Laufzeitzustand der zeitlichen Steuerung für eine 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
Vererbung
Abgeleitet

Hinweise

Ein Timeline, sich eigentlich lediglich einen Zeitabschnitt beschreibt.A Timeline, by itself, doesn't actually do anything other than describe a segment of time. Die Zeitachse Clock -Objekt, das die eigentliche Arbeit: Es verwaltet die zeitbezogenen Laufzeitzustand für die Zeitachse.It's the timeline's Clock object that does the real work: it maintains timing-related run-time state for the timeline.

In den meisten Fällen wird eine Uhr automatisch für Ihre Zeitachse erstellt.In most cases, a clock is created automatically for your timeline. Wenn Sie Animationen mit einem Storyboard oder BeginAnimation -Methode, Uhren automatisch für die Zeitachsen und Animationen erstellt und auf deren Zieleigenschaften angewendet.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. Beispiele hierzu finden Sie unter Vorgehensweise: Animieren einer Eigenschaft unter Verwendung eines Storyboards und Vorgehensweise: Animieren einer Eigenschaft ohne Storyboard.For examples, see How to: Animate a Property by Using a Storyboard and How to: Animate a Property Without Using a Storyboard.

Sie können auch erstellen, eine Clock explizit durch Verwenden der CreateClock Methode.You can also create a Clock explicitly by using the CreateClock method. In rechenintensiven Szenarios, z. B. Animieren einer großen Anzahl ähnlicher Objekte verwalten Ihre eigenen Clock verwenden, kann Leistungsvorteile bieten.In performance-intensive scenarios, such as animating large numbers of similar objects, managing your own Clock use can provide performance benefits.

Uhren werden in Strukturen, die die Struktur der entsprechen angeordnet, dass die Timeline Objektstruktur, aus der sie erstellt werden.Clocks are arranged in trees that match the structure of the Timeline objects tree from which they are created. Die Stammuhr einer solchen Zeitstruktur kann interaktiv gesteuert werden (angehalten, fortgesetzt, beendet und so weiter) durch das Abrufen der Controller.The root clock of such a timing tree can be interactively manipulated (paused, resumed, stopped, and so on) by retrieving its Controller. Nicht-Root-Uhren können nicht direkt gesteuert werden.Non-root clocks cannot be directly controlled.

Sobald Sie erstellt haben, eine Uhr nicht geändert werden kann (aber kann bearbeitet werden kann).Once created, a clock cannot be modified (but it can be manipulated).

Verwenden eine Zeitachse als ZeitgeberUsing a Timeline as a Timer

Uhr einer Zeitachse wird nur ausgeführt, wenn ein Ereignishandler zugeordnet oder (im Fall von einem AnimationClock Objekt) eine Eigenschaft zugeordnet ist.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. Aus diesem Grund (und anderen), es wird nicht empfohlen, Sie verwenden eine Timeline als Zeitgeber.For this reason (and others), it's not recommended that you use a Timeline as a timer.

Hinweise für Vererber

Abgeleitete Klassen implementieren sollte GetCurrentTimeCore() bei Bedarf ändern, wie die Zeit für diese Uhr verläuft.Derived classes should implement GetCurrentTimeCore() if they want to modify how time flows for this clock. Abgeleitete Klassen können vorgenommen werden, um die weiteren Schritte erforderlich, wenn die Uhr wiederholt, überspringt, sucht, beginnt, wird angehalten, fortgesetzt wird oder durch Überschreiben beendet der DiscontinuousTimeMovement(), SpeedChanged(), und Stopped() Methoden.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.

Konstruktoren

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

Initialisiert eine neue Instanz der Clock-Klasse unter Verwendung der angegebenen Timeline als Vorlage.Initializes a new instance of the Clock class, using the specified Timeline as a template. Das neue Clock-Objekt verfügt über keine untergeordneten Elemente.The new Clock object has no children.

Eigenschaften

Controller Controller Controller Controller

Ruft einen ClockController ab, der zum Starten, Anhalten, Fortsetzen, Suchen, Überspringen, Beenden oder Entfernen dieser Clock verwendet werden kann.Gets a ClockController that can be used to start, pause, resume, seek, skip, stop, or remove this Clock.

CurrentGlobalSpeed CurrentGlobalSpeed CurrentGlobalSpeed CurrentGlobalSpeed

Ruft die Rate ab, mit der die Zeit einer Uhr gegenwärtig im Verhältnis zur tatsächlichen Zeit fortschreitet.Gets the rate at which the clock's time is currently progressing, compared to real-world time.

CurrentGlobalTime CurrentGlobalTime CurrentGlobalTime CurrentGlobalTime

Ruft die aktuelle globale Zeit ab, wie vom WPFWPF-Zeitsteuerungssystem eingerichtet.Gets the current global time, as established by the WPFWPF timing system.

CurrentIteration CurrentIteration CurrentIteration CurrentIteration

Ruft die aktuelle Iteration dieser Uhr ab.Get the current iteration of this clock.

CurrentProgress CurrentProgress CurrentProgress CurrentProgress

Ruft den aktuellen Status dieser Clock innerhalb der aktuellen Iteration ab.Gets the current progress of this Clock within its current iteration.

CurrentState CurrentState CurrentState CurrentState

Ruft einen Wert ab, der angibt, ob die Uhr aktuell Active, Filling oder Stopped ist.Gets a value indicating whether the clock is currently Active, Filling, or Stopped.

CurrentTime CurrentTime CurrentTime CurrentTime

Ruft die aktuelle Zeit dieser Uhr für die aktuelle Iteration ab.Gets this clock's current time within its current iteration.

Dispatcher Dispatcher Dispatcher Dispatcher

Ruft die Dispatcher dies DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Inherited from DispatcherObject)
HasControllableRoot HasControllableRoot HasControllableRoot HasControllableRoot

Ruft einen Wert ab, der angibt, ob diese Clock Teil einer steuerbaren Uhrenstruktur ist.Gets a value that indicates whether this Clock is part of a controllable clock tree.

IsPaused IsPaused IsPaused IsPaused

Ruft einen Wert ab, der angibt, ob diese Clock oder eines ihrer übergeordneten Elemente angehalten wurde.Gets a value that indicates whether this Clock, or any of its parents, is paused.

NaturalDuration NaturalDuration NaturalDuration NaturalDuration

Ruft die interne Dauer der Timeline dieser Uhr ab.Gets the natural duration of this clock's Timeline.

Parent Parent Parent Parent

Ruft die Uhr ab, die das übergeordnete Element dieser Uhr bildet.Gets the clock that is the parent of this clock.

Timeline Timeline Timeline Timeline

Ruft die Timeline ab, aus der diese Clock erstellt wurde.Gets the Timeline from which this Clock was created.

Methoden

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

Bestimmt, ob der aufrufende Thread den Zugriff auf diese kann DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

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

Wird stets beim Implementieren in einer abgeleiteten Klasse aufgerufen, wenn eine Uhr wiederholt, übersprungen oder gesucht wird.When implemented in a derived class, will be invoked whenever a clock repeats, skips, or seeks.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Gibt zurück, ob die Clock eine eigene externe Zeitquelle besitzt. In diesem Fall ist möglicherweise eine Synchronisierung mit dem Zeitsteuerungssystem erforderlich.Returns whether the Clock has its own external time source, which may require synchronization with the timing system.

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

Ruft die aktuelle Zeit dieser Uhr für die aktuelle Iteration ab.Gets this clock's current time within its current iteration.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Wird stets beim Implementieren in einer abgeleiteten Klasse aufgerufen, wenn eine Uhr gestartet, übersprungen, angehalten oder wieder aufgenommen oder wenn die SpeedRatio der Uhr bearbeitet wird.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()

Wird stets beim Implementieren in einer abgeleiteten Klasse aufgerufen, wenn eine Uhr mit der Stop()-Methode beendet wird.When implemented in a derived class, will be invoked whenever a clock is stopped using the Stop() method.

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

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

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

Erzwingt, dass der aufrufende Thread den Zugriff auf diese DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Inherited from DispatcherObject)

Ereignisse

Completed Completed Completed Completed

Tritt auf, wenn das Ausführen dieser Uhr vollständig beendet wurde.Occurs when this clock has completely finished playing.

CurrentGlobalSpeedInvalidated CurrentGlobalSpeedInvalidated CurrentGlobalSpeedInvalidated CurrentGlobalSpeedInvalidated

Tritt auf, wenn die Taktfrequenz aktualisiert wird.Occurs when the clock's speed is updated.

CurrentStateInvalidated CurrentStateInvalidated CurrentStateInvalidated CurrentStateInvalidated

Tritt auf, wenn die CurrentState-Eigenschaft der Uhr aktualisiert wird.Occurs when the clock's CurrentState property is updated.

CurrentTimeInvalidated CurrentTimeInvalidated CurrentTimeInvalidated CurrentTimeInvalidated

Tritt auf, wenn die CurrentTime dieser Uhr ungültig wird.Occurs when this clock's CurrentTime becomes invalid.

RemoveRequested RemoveRequested RemoveRequested RemoveRequested

Tritt auf, wenn für diese Remove() oder eine ihrer übergeordneten Uhren die Clock-Methode aufgerufen wird.Occurs when the Remove() method is called on this Clock or one of its parent clocks.

Gilt für: