Compartilhar via


DisplayManager Classe

Definição

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
Object Platform::Object IInspectable DisplayManager
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.

Aplica-se a