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. Es ist das- Clock Objekt der Zeitachse, das die eigentliche Arbeit erledigt: Es verwaltet den Zeit steuerungsbezogenen Lauf Zeit Zustand 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 automatisch eine Uhr für die Zeitachse erstellt.In most cases, a clock is created automatically for your timeline. Wenn Sie mit Storyboard der-Methode oder der BeginAnimation -Methode animieren, werden Uhren automatisch für Ihre Zeitachsen und Animationen erstellt und auf Ihre 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 mithilfe eines Storyboards und Gewusst wie: 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 Clock explizit mit der CreateClock -Methode erstellen.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 angeordnet, die der Struktur der Timeline Objektstruktur entsprechen, von 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 Zeit Steuerungsstruktur kann interaktiv manipuliert (angehalten, fortgesetzt, beendet usw Controller.) werden, indem die-Struktur abgerufen wird.The root clock of such a timing tree can be interactively manipulated (paused, resumed, stopped, and so on) by retrieving its Controller. Nicht-Stamm-Uhren können nicht direkt gesteuert werden.Non-root clocks cannot be directly controlled.

Nach der Erstellung kann eine Uhr nicht geändert werden (Sie kann jedoch bearbeitet werden).Once created, a clock cannot be modified (but it can be manipulated).

Verwenden einer Zeitachse als TimerUsing a Timeline as a Timer

Die Uhr einer Zeitachse wird nur fortgesetzt, wenn ein Ereignishandler zugeordnet ist, oder (im Fall eines AnimationClock Objekts) ist Sie einer Eigenschaft zugeordnet.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) ist es nicht empfehlenswert, einen Timeline als Timer zu verwenden.For this reason (and others), it's not recommended that you use a Timeline as a timer.

Hinweise für Vererber

Abgeleitete Klassen sollten GetCurrentTimeCore() implementieren, wenn Sie die Zeit Flüsse für diese Uhr ändern möchten.Derived classes should implement GetCurrentTimeCore() if they want to modify how time flows for this clock. Abgeleitete Klassen können dazu verwendet werden, zusätzliche Aufgaben durchzuführen, wenn die Uhr wiederholt, durchsucht, gestartet, angehalten, fortgesetzt oder angehalten DiscontinuousTimeMovement()wird SpeedChanged(), indem Stopped() die Methoden, und überschrieben werden.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 den Dispatcher ab, der diesem 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 auf dieses DispatcherObject zugreifen kann.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 auf dieses DispatcherObject zugreifen kann.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: