DisplayManager Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Gerencia a propriedade de um objeto Ou objetos DisplayTarget e fornece métodos para criar 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
- Herança
- Atributos
- Implementações
Requisitos do Windows
Família de dispositivos |
Windows 10, version 1809 (introduzida na 10.0.17763.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduzida na v7.0)
|
Comentários
Esse objeto implementaIDisposable IClosable/, que deve ser usado para revogar a propriedade de todos os objetos DisplayTarget depois que eles não estiverem mais sendo usados.
Métodos
Close() |
Revoga a propriedade de todos os objetos DisplayTarget pertencentes a esta instância displayManager . |
Create(DisplayManagerOptions) |
Cria uma instância displayManager com as opções especificadas. |
CreateDisplayDevice(DisplayAdapter) |
Cria um objeto DisplayDevice para o adaptador fornecido. O DisplayDevice pode ser usado para criar e apresentar conteúdo de tela inteira para destinos no adaptador especificado. |
CreateDisplayDeviceForIndirectAdapter(DisplayAdapter, DisplayAdapter) |
Gerencia a propriedade de um objeto Ou objetos DisplayTarget e fornece métodos para criar objetos DisplayState . |
Dispose() |
Realiza tarefas definidas pelo aplicativo associadas à liberação ou à redefinição de recursos não gerenciados. |
GetCurrentAdapters() |
Enumera o conjunto de adaptadores de exibição atualmente presentes no sistema. |
GetCurrentTargets() |
Enumera o conjunto de destinos de exibição atualmente presentes no sistema. |
ReleaseTarget(DisplayTarget) |
Libera a propriedade do destino de exibição especificado, permitindo que outros componentes no sistema adquiram a propriedade. |
Start() |
Inicia a escuta de todos os eventos DisplayManager atomicamente. Os eventos DisplayManager não são gerados até que você chame Start. |
Stop() |
Interrompe a escuta de todos os eventos DisplayManager atomicamente e dispara Desabilitado de forma síncrona. |
TryAcquireTarget(DisplayTarget) |
Tenta adquirir a propriedade exclusiva de um DisplayTarget. |
TryAcquireTargetsAndCreateEmptyState(IIterable<DisplayTarget>) |
Tenta adquirir a propriedade exclusiva de uma coleção de objetos DisplayTarget e cria um objeto DisplayState modificável vazio, que dá suporte à conexão de caminhos a esses destinos. |
TryAcquireTargetsAndCreateSubstate(DisplayState, IIterable<DisplayTarget>) |
Tenta adquirir a propriedade exclusiva de uma coleção de objetos DisplayTarget e esculpir um subconjunto de um determinado DisplayState somente para os destinos passados para esse método. O estado resultante pode ser modificado e aplicado. |
TryAcquireTargetsAndReadCurrentState(IIterable<DisplayTarget>) |
Tenta adquirir a propriedade exclusiva de uma coleção de objetos DisplayTarget e cria um DisplayState modificável preenchido com o estado atual dos destinos fornecidos. |
TryReadCurrentStateForAllTargets() |
Cria um objeto DisplayState somente leitura preenchido com todo o estado de exibição do sistema para todos os destinos. |
TryReadCurrentStateForModeQuery() |
Gerencia a propriedade de um objeto Ou objetos DisplayTarget e fornece métodos para criar objetos DisplayState . |
Eventos
Changed |
Um evento gerado quando o hardware de exibição do sistema é adicionado, removido ou modificado. Isso pode ocorrer sempre que as coleções DisplayAdapter ou DisplayTarget forem alteradas. Use esse evento para detectar essas alterações e chamar GetCurrentAdapters e/ou GetCurrentTargets para obter as coleções atualizadas. |
Disabled |
Um evento gerado sempre que a pilha de exibição da sessão atual é desabilitada e quando DisplayManager.Stop é chamado. Você pode desabilitar a pilha de exibição de sessão em vários casos, como alternar sessões de Serviços de Terminal ou se recuperar de falhas de driver. Recomendamos que os assinantes tentem limpo quando Desabilitado for invocado. A maioria das APIs de exibição falhará enquanto a pilha de exibição da sessão estiver desabilitada. |
Enabled |
Um evento gerado sempre que a pilha de exibição da sessão atual está habilitada e quando DisplayManager.Start é chamado. Você pode reabilitar a pilha de exibição de sessão em vários casos, como alternar sessões dos Serviços de Terminal ou se recuperar de falhas de driver. Recomendamos que os assinantes renumerem todos os destinos e estado nessa chamada, pois a pilha de exibição do sistema pode ser deixada em qualquer estado antes que esse evento seja gerado. |
PathsFailedOrInvalidated |
Um evento gerado sempre que um caminho de exibição é reprovado ou invalidado de forma assíncrona pelo sistema. Isso pode ocorrer devido à alteração dos requisitos de largura de banda de hardware ou devido a falhas de driver. Os assinantes desse evento devem chamar TryAcquireTargetsAndReadCurrentState para destinos que eles possuem e marcar se algum dos caminhos no objeto DisplayState resultante tem sua propriedade Status definida como FailedAsync ou InvalidatedAsync e tomar a ação recomendada. |