DisplayPropertiesEventHandler Delegado

Definición

Espacio de nombres:

Windows.Graphics.Display

Nota:

El tipo DisplayProperties y los controladores de eventos relacionados se pueden modificar o no estar disponibles para las versiones después de Windows 8.1. En su lugar, use DisplayInformation.

Representa un método que controla los eventos de propiedad de visualización.

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)

Parámetros

sender

Object

Platform::Object

IInspectable

El objeto que ha generado el evento.

Atributos

ContractVersionAttribute DeprecatedAttribute GuidAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

#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();
}

Comentarios

Se recomienda que las aplicaciones usen un único delegado para controlar la mayoría de los eventos de visualización porque, en la mayoría de los casos, el cambio en cada propiedad de presentación requiere que la aplicación vuelva a dibujarse. Además, muchos cambios de propiedad resultan de un único cambio de modo que afecta a todo el sistema operativo.

El ejemplo de Direct3D 11.1 Simple Estéreo 3D muestra cómo controlar los cambios estéreo del sistema.