DispatcherTimer 클래스

정의

네임스페이스:

Microsoft.UI.Xaml

지정된 시간 간격 및 지정된 우선 순위로 처리되는 Dispatcher 큐에 통합된 타이머를 제공합니다.

/// [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

예제

이 예제 코드는 라는 TimerLogTextBlock에 데이터를 쓰는 간단한 콘솔 스타일 타이머를 구현합니다TimerLog(정의하는 XAML은 표시되지 않음). Interval 값은 1로 설정되고 로그는 각 틱에 대한 실제 경과 시간을 표시합니다.

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 지정된 시간이 경과한 후에 발생합니다. TickStop 메서드가 호출되거나, 앱이 종료되거나, 앱이 일시 중단될 때까지 계속 실행됩니다Interval.

한 DispatcherTimer 가지 시나리오는 센서 값의 변경 내용이 순전히 이벤트 기반이 아니거나 이벤트가 원하는 세분성을 제공하지 않는 센서의 속성을 검사 것입니다. 가속도계 샘플에서 이를 확인할 수 있습니다.

다른 시나리오 DispatcherTimer 에는 관련 이벤트가 없는 상태 변경 내용 확인 또는 스토리보드 애니메이션 또는 양방향 바인딩을 사용할 수 없는 정기적인 UI 업데이트가 포함됩니다.

생성자

DispatcherTimer()

DispatcherTimer 클래스의 새 instance 초기화합니다.

속성

Interval	타이머 틱 사이의 시간을 가져오거나 설정합니다.
IsEnabled	타이머가 실행 중인지 여부를 나타내는 값을 가져옵니다.

메서드

Start()	DispatcherTimer를 시작합니다.
Stop()	DispatcherTimer를 중지합니다.

이벤트

Tick	타이머 간격이 경과되면 발생합니다.

추가 정보

• CoreDispatcher
• ThreadPoolTimer