共用方式為

計時事件概觀

  • 發行項

更新：2007 年 11 月

本主題說明如何使用 Timeline 和 Clock 物件上可用的五種計時事件。

必要條件

若要了解本主題，您應該了解如何建立及使用動畫。若要開始使用動畫，請參閱動畫概觀。

有幾種方式可以在 WPF 中將屬性做成動畫：

因為您可以用標記和程式碼使用這些方法，所以本概觀中的範例會使用 Storyboard 物件。但是，這裡所述的概念也適用於其他建立屬性動畫的方法。

什麼是時鐘？

除了描述時間區段之外，時刻表本身實際並不會執行任何動作。真正在執行工作的是時刻表的 Clock 物件：它會替時刻表維護與計時相關的執行時期狀態。在大部分情況下 (例如使用腳本時)，系統會自動為時刻表建立時鐘。您也可以使用 CreateClock 方法來明確建立 Clock。如需 Clock 物件的詳細資訊，請參閱動畫和計時系統概觀。

使用事件的原因？

所有互動計時作業都是非同步的，只有一個例外 (與最後一個刻度對齊)。您無法得知事件執行的確切時間。若您有其他程式碼必須依賴您的計時作業，這就會是個問題。假設您想要停止會將矩形顯示為動畫的時刻表。而在時刻表停止後，您想要變更矩形的色彩。

myStoryboard.Stop(myRectangle);

// This statement might execute
// before the storyboard has stopped.
myRectangle.Fill = Brushes.Blue;

在上述範例中，程式碼的第二行可能會在腳本停止之前就執行，這是因為停止動作是屬於非同步作業。告訴時刻表或時鐘停止，就會建立一種「停止要求」，而這種要求要等到計時引擎跳到下一個時間後才會處理。

若要在時刻表完成後執行命令，請使用計時事件。下列範例會在腳本停止播放後，用事件處理常式變更矩形的色彩。

// Change the rectangle's color after the storyboard stops. 
void myStoryboard_CurrentStateInvalidated(object sender, EventArgs e)
{
    Clock myStoryboardClock = (Clock)sender;
    if (myStoryboardClock.CurrentState == ClockState.Stopped)
    {
        myRectangle.Fill = Brushes.Blue;
    }
}


...


// Register for the CurrentStateInvalidated timing event.
myStoryboard.CurrentStateInvalidated += new EventHandler(myStoryboard_CurrentStateInvalidated);

如需更完整的範例，請參閱 HOW TO：時鐘的狀態變更時接收通知。

公用事件

Timeline 和 Clock 類別都提供五種計時事件。下表列出這些事件和其觸發條件。

事件

觸發互動作業

其他觸發程序

Completed

跳至填滿

時鐘完成。

CurrentGlobalSpeedInvalidated

暫停、繼續、搜尋、設定速率、跳至填滿、停止

時鐘倒轉、加速、開始或停止。

CurrentStateInvalidated

開始、跳至填滿、停止

時鐘開始、停止或填滿。

CurrentTimeInvalidated

開始、搜尋、跳至填滿、停止

時鐘進行中。

RemoveRequested

移除

跳動和事件的合併

當您在 WPF 中顯示物件動畫時，實際上是計時引擎在管理您的動畫。計時引擎會追蹤時間的進度，並計算每個動畫的狀態。它會在一秒內進行許多這類評估活動。這類評估活動稱為「跳動」。

雖然跳動發生次數很頻繁，但每次跳動之間仍可能發生許多事情。例如，時刻表可能已停止、又啟動，然後又再度停止，在這個情況下，它的狀態已經變更三次。理論上，一次跳動可以引發事件許多次；但是時間引擎會合併事件，使得每一次跳動最多只會引發每種事件一次。

註冊事件

有兩種方式可以註冊以取得計時事件：您可以使用時刻表註冊或使用時刻表建立的時鐘註冊。雖然直接使用時鐘註冊事件只能利用程式碼完成，但這是比較容易的做法。您可以使用標記或程式碼向時刻表註冊事件。下節說明如何使用時刻表註冊時鐘事件。

使用時刻表註冊時鐘事件

雖然時刻表的 Completed、CurrentGlobalSpeedInvalidated、CurrentStateInvalidated、CurrentTimeInvalidated 和 RemoveRequested 事件表面上與時刻表有關，但註冊這些事件實際上會使事件處理常式與為該時刻表建立的 Clock 產生關聯。

例如，當您在時刻表上註冊 Completed 事件時，實際上就是在告訴系統註冊為該時刻表而建立之每個時鐘的 Completed 事件。在程式碼中，您必須在為這個此時刻表建立 Clock 之前註冊這個事件，否則您就不會收到通知。這在 XAML 中會自動發生，剖析器 (Parser) 會在建立 Clock 之前自動註冊事件。

請參閱

概念

動畫和計時系統概觀

動畫概觀

計時行為概觀

其他資源

動畫和計時範例