DisplayPropertiesEventHandler Делегат

Определение

Пространство имен:

Windows.Graphics.Display

Примечание

Тип DisplayProperties и связанные обработчики событий могут быть изменены или недоступны для выпусков после Windows 8.1. Вместо этого используйте DisplayInformation.

Представляет метод, обрабатывающий события свойства отображения.

public delegate void DisplayPropertiesEventHandler(Platform::Object ^ sender);

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3688729345, 61857, 18129, 158, 227, 84, 59, 204, 153, 89, 128)]
/// [Windows.Foundation.Metadata.Deprecated("DisplayProperties may be altered or unavailable for releases after Windows Phone 8.1. Instead, use DisplayInformation.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
class DisplayPropertiesEventHandler : MulticastDelegate

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(3688729345, 61857, 18129, 158, 227, 84, 59, 204, 153, 89, 128)]
[Windows.Foundation.Metadata.Deprecated("DisplayProperties may be altered or unavailable for releases after Windows Phone 8.1. Instead, use DisplayInformation.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Foundation.UniversalApiContract")]
public delegate void DisplayPropertiesEventHandler(object sender);

var displayPropertiesEventHandlerHandler = function(sender){
/* Your code */
}

Public Delegate Sub DisplayPropertiesEventHandler(sender As Object)

Параметры

sender

Object

Platform::Object

IInspectable

Объект, вызвавший событие.

Атрибуты

ContractVersionAttribute DeprecatedAttribute GuidAttribute

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

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

Примеры

#include <winrt/Windows.Graphics.Display.h>
using namespace winrt;
using namespace Windows::Graphics::Display;
...
void GameRenderer::Initialize()
{
    DisplayProperties::StereoEnabledChanged({ this, &GameRenderer::OnStereoEnableChanged });
}

void GameRenderer::OnStereoEnableChanged(winrt::Windows::Foundation::IInspectable const& sender)
{
    UpdateForStereoChange();
}

void GameRenderer::Initialize()
{
    DisplayProperties::StereoEnabledChanged += 
        ref new DisplayPropertiesEventHandler(this, &GameRenderer::OnStereoEnableChanged);
}

void GameRenderer::OnStereoEnableChanged(_In_ Platform::Object^ sender)
{
    UpdateForStereoChange();
}

Комментарии

Рекомендуется, чтобы приложения использовали один делегат для обработки большинства событий отображения, так как в большинстве случаев для изменения каждого свойства отображения требуется, чтобы приложение перерисовывало себя. Кроме того, многие изменения свойств возникают в результате изменения одного режима, которое влияет на всю операционную систему.

В примере Direct3D 11.1 Simple Stereo 3D показано, как обрабатывать изменения стерео системы.