Clock Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Verwaltet den Laufzeitdauerzustand für ein 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
A Timeline, selbst, tut nichts anderes als ein Segment der Zeit zu beschreiben. Es ist das Objekt der Zeitachse Clock , das die eigentliche Arbeit ausführt: Es behält den zeitgesteuerten Laufzeitzustand für die Zeitachse bei.
In den meisten Fällen wird automatisch eine Uhr für Ihre Zeitachse erstellt. Wenn Sie mithilfe einer Storyboard oder der BeginAnimation Methode animieren, werden Uhren automatisch für Ihre Zeitachsen und Animationen erstellt und auf ihre zielbezogenen Eigenschaften angewendet. Beispiele finden Sie unter How to: Animate a Property by Using a Storyboard and How to: Animate a Property Without Using a Storyboard.
Sie können auch mithilfe der CreateClock Methode eine Clock explizite Erstellung erstellen. In leistungsintensiven Szenarien, z. B. das Animieren einer großen Anzahl ähnlicher Objekte, kann die Verwaltung Ihrer eigenen Clock Verwendung Leistungsvorteile bieten.
Uhren werden in Bäumen angeordnet, die der Struktur der Objektstruktur entsprechen, aus der Timeline sie erstellt werden. Die Stammuhr einer solchen Zeitstruktur kann interaktiv bearbeitet werden (angehalten, fortgesetzt, angehalten, angehalten usw.), indem sie die ControllerStruktur abruft. Nicht-Stammuhren können nicht direkt gesteuert werden.
Nach der Erstellung kann eine Uhr nicht mehr geändert werden (aber sie kann bearbeitet werden).
Verwenden einer Zeitachse als Timer
Die Uhr einer Zeitachse wird nur ausgeführt, wenn ein Ereignishandler damit verknüpft ist oder (im Fall eines AnimationClock Objekts) eine Eigenschaft zugeordnet ist. Aus diesem Grund (und andere) wird nicht empfohlen, einen Timeline Timer als Zeitgeber zu verwenden.
Hinweise für Vererber
Abgeleitete Klassen sollten implementiert werden GetCurrentTimeCore() , wenn sie die Zeitflüsse für diese Uhr ändern möchten. Abgeleitete Klassen können vorgenommen werden, um zusätzliche Aufgaben durchzuführen, wenn die Uhr wiederholt, überspringt, sucht, beginnt, anhält, anhält, fortgesetzt oder beendet wird, indem die DiscontinuousTimeMovement()Methoden SpeedChanged()Stopped() und Methoden überschrieben werden.
Konstruktoren
| Name | Beschreibung |
|---|---|
| Clock(Timeline) |
Initialisiert eine neue Instanz der Clock Klasse, wobei die angegebene Als Vorlage verwendet Timeline wird. Das neue Clock Objekt hat keine untergeordneten Elemente. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Controller |
Ruft ein ClockController , das zum Starten, Anhalten, Fortsetzen, Suchen, Überspringen, Beenden oder Entfernen verwendet Clockwerden kann. |
| CurrentGlobalSpeed |
Ruft die Rate ab, mit der die Zeit der Uhr im Vergleich zur Realen Zeit voranschreitet. |
| CurrentGlobalTime |
Ruft die aktuelle globale Zeit ab, wie vom WPF-Timing-System festgelegt. |
| CurrentIteration |
Rufen Sie die aktuelle Iteration dieser Uhr ab. |
| CurrentProgress |
Ruft den aktuellen Fortschritt dieser Clock Innerhalb der aktuellen Iteration ab. |
| CurrentState |
Ruft einen Wert ab, der angibt, ob die Uhr aktuell Activeist, Fillingoder Stopped. |
| CurrentTime |
Ruft die aktuelle Zeit dieser Uhr innerhalb der aktuellen Iteration ab. |
| Dispatcher |
Ruft dies Dispatcher ab, dem dies DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject) |
| HasControllableRoot |
Ruft einen Wert ab, der angibt, ob dies Clock Teil einer steuerbaren Uhrstruktur ist. |
| IsPaused |
Ruft einen Wert ab, der angibt, ob dies Clockoder eines der übergeordneten Elemente angehalten wird. |
| NaturalDuration |
Ruft die natürliche Dauer dieser Uhr ab Timeline. |
| Parent |
Ruft die Uhr ab, die das übergeordnete Element dieser Uhr ist. |
| Timeline |
Methoden
| Name | Beschreibung |
|---|---|
| CheckAccess() |
Bestimmt, ob der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject) |
| DiscontinuousTimeMovement() |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird jedes Mal aufgerufen, wenn eine Uhr wiederholt, überspringt oder sucht. |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetCanSlip() |
Gibt zurück, ob die Clock eigene externe Zeitquelle vorhanden ist, die möglicherweise eine Synchronisierung mit dem Timing-System erfordert. |
| GetCurrentTimeCore() |
Ruft die aktuelle Zeit dieser Uhr innerhalb der aktuellen Iteration ab. |
| GetHashCode() |
Dient als die Standard-Hashfunktion (Geerbt von Object) |
| GetType() |
Ruft die Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| SpeedChanged() |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird immer dann aufgerufen, wenn eine Uhr beginnt, überspringt, angehalten, fortgesetzt wird oder wenn die Uhr SpeedRatio geändert wird. |
| Stopped() |
Wenn sie in einer abgeleiteten Klasse implementiert wird, wird jedes Mal aufgerufen, wenn eine Uhr mit der Stop() Methode beendet wird. |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
| VerifyAccess() |
Erzwingt, dass der aufrufende Thread Zugriff auf diesen DispatcherObjectThread hat. (Geerbt von DispatcherObject) |
Ereignisse
| Name | Beschreibung |
|---|---|
| Completed |
Tritt auf, wenn die Wiedergabe dieser Uhr vollständig abgeschlossen ist. |
| CurrentGlobalSpeedInvalidated |
Tritt auf, wenn die Taktgeschwindigkeit aktualisiert wird. |
| CurrentStateInvalidated |
Tritt auf, wenn die Eigenschaft der CurrentState Uhr aktualisiert wird. |
| CurrentTimeInvalidated |
Tritt auf, wenn diese Uhr CurrentTime ungültig wird. |
| RemoveRequested |
Tritt auf, wenn die Remove() Methode für diese Clock oder eine der übergeordneten Uhren aufgerufen wird. |