DisplayManager Clase

Definición

Espacio de nombres:

Windows.Devices.Display.Core

Administra la propiedad de un objeto o objetos DisplayTarget y proporciona métodos para crear objetos DisplayState .

public ref class DisplayManager sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DisplayManager final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DisplayManager : System.IDisposable

Public NotInheritable Class DisplayManager
Implements IDisposable

Herencia

Object Platform::Object IInspectable DisplayManager

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IClosable IDisposable

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)

Comentarios

Este objeto implementa IDisposable IClosable/, que se debe usar para revocar la propiedad de todos los objetos DisplayTarget una vez que ya no se usen.

Métodos

Close()	Revoca la propiedad de todos los objetos DisplayTarget que pertenecen a esta instancia de DisplayManager .
Create(DisplayManagerOptions)	Crea una instancia de DisplayManager con las opciones especificadas.
CreateDisplayDevice(DisplayAdapter)	Crea un objeto DisplayDevice para el adaptador especificado. DisplayDevice se puede usar para crear y presentar contenido de pantalla completa a destinos en el adaptador determinado.
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados.
GetCurrentAdapters()	Enumera el conjunto de adaptadores de pantalla presentes actualmente en el sistema.
GetCurrentTargets()	Enumera el conjunto de destinos de visualización presentes actualmente en el sistema.
ReleaseTarget(DisplayTarget)	Libera la propiedad del destino de presentación especificado, lo que permite que otros componentes del sistema adquieran propiedad.
Start()	Comienza a escuchar todos los eventos de DisplayManager de forma atómica. Los eventos displayManager no se generan hasta que se llama a Start.
Stop()	Deja de escuchar todos los eventos de DisplayManager de forma atómica y desencadena Deshabilitado de forma sincrónica.
TryAcquireTarget(DisplayTarget)	Intenta adquirir la propiedad exclusiva de un displayTarget.
TryAcquireTargetsAndCreateEmptyState(IIterable<DisplayTarget>)	Intenta adquirir la propiedad exclusiva de una colección de objetos DisplayTarget y crea un objeto DisplayState modificable vacío, que admite la conexión de rutas de acceso a estos destinos.
TryAcquireTargetsAndCreateSubstate(DisplayState, IIterable<DisplayTarget>)	Intenta adquirir la propiedad exclusiva de una colección de objetos DisplayTarget y elimina un subconjunto de un displayState determinado solo para los destinos pasados a este método. El estado resultante se puede modificar y aplicar.
TryAcquireTargetsAndReadCurrentState(IIterable<DisplayTarget>)	Intenta adquirir la propiedad exclusiva de una colección de objetos DisplayTarget y crea un DisplayState modificable rellenado con el estado actual de los destinos proporcionados.
TryReadCurrentStateForAllTargets()	Crea un objeto DisplayState de solo lectura rellenado con todo el estado de visualización del sistema para todos los destinos.

Eventos

Changed	Evento que se genera cuando se agrega, quita o modifica el hardware de visualización del sistema. Esto puede ocurrir siempre que cambien las colecciones DisplayAdapter o DisplayTarget . Use este evento para detectar estos cambios y llamar a GetCurrentAdapters o GetCurrentTargets para obtener las colecciones actualizadas.
Disabled	Evento generado cada vez que se deshabilita la pila de visualización de la sesión actual y cuando se llama a DisplayManager.Stop . Puede deshabilitar la pila de visualización de sesión en varios casos, como cambiar las sesiones de Terminal Services o recuperarse de errores de controladores. Se recomienda que los suscriptores intenten limpiar cuando se invoque Disabled . Se producirá un error en la mayoría de las API de visualización mientras la pila de visualización de la sesión está deshabilitada.
Enabled	Evento generado cada vez que se habilita la pila de visualización de la sesión actual y cuando se llama a DisplayManager.Start . Puede volver a habilitar la pila de visualización de sesión en varios casos, como cambiar las sesiones de Terminal Services o recuperarse de errores de controladores. Se recomienda que los suscriptores vuelvan a enumerar todos los destinos y el estado de esta llamada, ya que la pila de visualización del sistema podría dejarse en cualquier estado antes de que se genere este evento.
PathsFailedOrInvalidated	Evento que se genera cada vez que el sistema produce un error o invalida una ruta de acceso de presentación. Esto puede deberse a cambios en los requisitos de ancho de banda de hardware o debido a errores de controladores. Los suscriptores a este evento deben llamar a TryAcquireTargetsAndReadCurrentState para los destinos que poseen y comprobar si alguna de las rutas de acceso del objeto DisplayState resultante tiene su propiedad Status establecida en FailedAsync o InvalidatedAsync, y realizar la acción recomendada.