CoreDispatcher Класс

Определение

Предоставляет диспетчер сообщений об основных событиях среда выполнения Windows. Экземпляры этого типа отвечают за обработку сообщений окна и отправку событий клиенту.

public ref class CoreDispatcher sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreDispatcher final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class CoreDispatcher
Public NotInheritable Class CoreDispatcher
Наследование
Object IInspectable CoreDispatcher
Атрибуты
Реализации

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Экземпляры этого типа можно получить из свойства CoreWindow.Dispatcher. Текущий экземпляр CoreWindow можно получить путем вызова CoreWindow.GetForCurrentThread.

// App.cpp
...
// An implementation of IFrameworkView::Run.
void Run()
{
    CoreWindow window{ CoreWindow::GetForCurrentThread() };
    window.Activate();

    CoreDispatcher dispatcher{ window.Dispatcher() };
    dispatcher.ProcessEvents(CoreProcessEventsOption::ProcessUntilQuit);
}

// The CoreApplication::Run call indirectly calls the App::Run function above.
int __stdcall wWinMain(HINSTANCE, HINSTANCE, PWSTR, int)
{
    CoreApplication::Run(App());
}
void MyCoreWindowEvents::Run() // this is an implementation of IFrameworkView::Run() used to show context. It is called by CoreApplication::Run().
{
    CoreWindow::GetForCurrentThread()->Activate();

    //...

    CoreWindow::GetForCurrentThread()->Dispatcher->ProcessEvents(CoreProcessEventsOption::ProcessUntilQuit);
}

Свойства

CurrentPriority

Возвращает и задает приоритет текущей задачи.

HasThreadAccess

Возвращает значение, указывающее, имеет ли диспетчер событий, предоставленный этим экземпляром CoreWindow , доступ к текущему потоку или нет.

Методы

ProcessEvents(CoreProcessEventsOption)

Запускает диспетчер, обрабатывая очередь входных событий для этого экземпляра CoreWindow.

RunAsync(CoreDispatcherPriority, DispatchedHandler)

Планирует предоставленный обратный вызов в потоке пользовательского интерфейса из рабочего потока и возвращает результаты асинхронно.

RunIdleAsync(IdleDispatchedHandler)

Планирует обратный вызов в потоке пользовательского интерфейса из рабочего потока с приоритетом простоя и возвращает результаты асинхронно.

ShouldYield()

Запрашивает, должен ли вызывающий объект возвращать элементы в очереди задач с более высоким приоритетом, чем текущая задача.

ShouldYield(CoreDispatcherPriority)

Запрашивает, должен ли вызывающий объект возвращать элементы в очереди задач указанного приоритета или выше.

StopProcessEvents()

Запрещает диспетчеру обрабатывать все события в очереди.

TryRunAsync(CoreDispatcherPriority, DispatchedHandler)

Пытается запланировать указанный обратный вызов в потоке пользовательского интерфейса из рабочего потока и возвращает результаты асинхронно.

TryRunIdleAsync(IdleDispatchedHandler)

Пытается запланировать обратный вызов в потоке пользовательского интерфейса из рабочего потока с неактивным приоритетом и возвращает результаты асинхронно.

События

AcceleratorKeyActivated

Возникает при активации клавиши ускорителя (нажатой или удерживаемой).

Применяется к