DispatcherTimer 類別

定義

命名空間:

Microsoft.UI.Xaml

提供已整合至 發送器 佇列的計時器，它會在指定的時間間隔和指定優先順序進行處理。

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DispatcherTimer

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class DispatcherTimer

Public Class DispatcherTimer

繼承

Object IInspectable DispatcherTimer

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

範例

此範例程式碼會實作簡單的主控台樣式計時器，該計時器會將資料寫入名為 TimerLog (XAML TimerLog 的TextBlock，但未顯示) 。 Interval值設定為 1，而記錄檔會顯示每個Tick的實際經過時間。

DispatcherTimer dispatcherTimer;
DateTimeOffset startTime;
DateTimeOffset lastTime;
DateTimeOffset stopTime;
int timesTicked = 1;
int timesToTick = 10;

public void DispatcherTimerSetup()
{
    dispatcherTimer = new DispatcherTimer();
    dispatcherTimer.Tick += dispatcherTimer_Tick;
    dispatcherTimer.Interval = new TimeSpan(0, 0, 1);
    //IsEnabled defaults to false
    TimerLog.Text += "dispatcherTimer.IsEnabled = " + dispatcherTimer.IsEnabled + "\n";
    startTime = DateTimeOffset.Now;
    lastTime = startTime;
    TimerLog.Text += "Calling dispatcherTimer.Start()\n";
    dispatcherTimer.Start();
    //IsEnabled should now be true after calling start
    TimerLog.Text += "dispatcherTimer.IsEnabled = " + dispatcherTimer.IsEnabled + "\n";
}

void dispatcherTimer_Tick(object sender, object e)
{
    DateTimeOffset time = DateTimeOffset.Now;
    TimeSpan span = time - lastTime;
    lastTime = time;
    //Time since last tick should be very very close to Interval
    TimerLog.Text += timesTicked + "\t time since last tick: " + span.ToString() + "\n";
    timesTicked++;
    if (timesTicked > timesToTick)
    {
        stopTime = time;
        TimerLog.Text += "Calling dispatcherTimer.Stop()\n";
        dispatcherTimer.Stop();
        //IsEnabled should now be false after calling stop
        TimerLog.Text += "dispatcherTimer.IsEnabled = " + dispatcherTimer.IsEnabled + "\n";
        span = stopTime - startTime;
        TimerLog.Text += "Total Time Start-Stop: " + span.ToString() + "\n";
    }
}
private void Page_Loaded_1(object sender, RoutedEventArgs e)
{
    DispatcherTimerSetup();
}

// MainPage.cpp
...
#include <chrono>
...
void MainPage::StartTimerAndRegisterHandler()
{
    Windows::UI::Xaml::DispatcherTimer timer;
    timer.Interval(std::chrono::milliseconds{ 500 });
    auto registrationtoken = timer.Tick({this, &MainPage::OnTick });
    timer.Start();
}

void MainPage::OnTick(Windows::Foundation::IInspectable const& /* sender */,
    Windows::Foundation::IInspectable const& /* e */)
{
    // do something on each tick here ...
}

備註

DispatcherTimer可用來在產生 UI 執行緒的相同執行緒上執行程式碼。 在此執行緒上執行的程式碼有權建立和修改只能在 UI 執行緒上建立和修改的物件。 若要指定程式碼應該在 UI 執行緒上執行，請設定 Interval 屬性，然後呼叫 Start 方法。 Tick事件會在 中指定的 Interval 時間經過之後引發。 Tick 會繼續以相同的 Interval 方式引發，直到呼叫 Stop 方法、應用程式終止或應用程式暫停為止。

的其中一個案例 DispatcherTimer 是檢查感應器上的屬性，其中感應器值的變更並非純事件驅動，或事件不會提供您想要的資料細微性。 您可以在 加速計範例中看到這一點。

其他案例 DispatcherTimer 包括檢查沒有相關事件的狀態變更，或是無法使用分鏡腳本動畫或雙向系結的定期 UI 更新。

建構函式

DispatcherTimer()

初始化 DispatcherTimer 類別的新實例。

屬性

Interval	取得或設定計時器刻度之間的時間量。
IsEnabled	取得值，指出計時器是否正在執行。

方法

Start()	啟動 DispatcherTimer。
Stop()	停止 DispatcherTimer。

事件

Tick	發生於計時器間隔已耗用時。

另請參閱

• CoreDispatcher
• ThreadPoolTimer