Partilhar via


DisplayInformation Classe

Definição

Monitora e controla informações relacionadas à exibição de um aplicativo. A classe fornece eventos para permitir que os clientes monitorem alterações na exibição do aplicativo que afetam em quais exibições a exibição reside, bem como alterações em exibições que podem afetar a exibição do aplicativo.

public ref class DisplayInformation sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DisplayInformation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DisplayInformation
Public NotInheritable Class DisplayInformation
Herança
Object Platform::Object IInspectable DisplayInformation
Atributos

Requisitos do Windows

Família de dispositivos
Windows 10 (introduzida na 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

Uma instância DisplayInformation não é mapeada para uma exibição específica, mas controla informações relacionadas à exibição para onde quer que a exibição do aplicativo seja colocada. Chamar GetForCurrentView sempre retornará a instância única do CoreApplicationView do thread atual. Uma instância de DisplayInformation só pode ser usada do thread no qual foi criada.

Para manipular eventos DisplayInformation, use um manipulador de eventos para o evento específico. Por exemplo, para DisplayInformation.DpiChanged, use "TypedEventHandler<DisplayInformation, Object> DpiChanged".

Qualquer evento de alteração de propriedade de DisplayInformation poderá ser disparado se o aplicativo for movido de um monitor para outro monitor. ColorProfileChanged é disparado quando o perfil de cor do vídeo é alterado. DpiChanged é disparado quando as propriedades LogicalDpi, ResolutionScale e RawPixelsPerViewPixel são alteradas porque um usuário selecionou um nível de zoom diferente ou alterou a resolução da tela. OrientationChanged será disparado se um usuário alterar a orientação da tela.

Histórico de versão

Versão do Windows Versão do SDK Valor adicionado
1511 10586 DiagonalSizeInInches
1607 14393 ScreenHeightInRawPixels
1607 14393 ScreenWidthInRawPixels
1803 17134 AdvancedColorInfoChanged
1803 17134 GetAdvancedColorInfo

Propriedades

AutoRotationPreferences

Obtém e define a orientação preferencial do aplicativo.

CurrentOrientation

Obtém a orientação atual de um monitor retangular.

DiagonalSizeInInches

Tamanho diagonal da tela em polegadas.

LogicalDpi

Obtém os pixels por polegada lógica do ambiente atual.

NativeOrientation

Obtém a orientação nativa do monitor de exibição, que normalmente é a orientação em que os botões no dispositivo correspondem à orientação do monitor.

RawDpiX

Obtém os pontos brutos por polegada (DPI) ao longo do eixo x do monitor de exibição.

RawDpiY

Obtém os pontos brutos por polegada (DPI) ao longo do eixo y do monitor de exibição.

RawPixelsPerViewPixel

Obtém um valor que representa o número de pixels brutos (físicos) para cada pixel de exibição (layout).

ResolutionScale

Obtém o fator de escala da janela do aplicativo.

ScreenHeightInRawPixels

Retorna a resolução de altura atual do monitor lógico.

ScreenWidthInRawPixels

Retorna a resolução de largura atual do monitor lógico.

StereoEnabled

Obtém um valor que indica se o dispositivo dá suporte a 3D estereoscópico.

Métodos

GetAdvancedColorInfo()

Recupera as informações de Cor Avançada.

GetColorProfileAsync()

Obtém de forma assíncrona o perfil de cor padrão do ICC (International Color Consortium) associado à exibição física.

GetForCurrentView()

Obtém a instância DisplayInformation associada ao CoreApplicationView do thread atual. Essa instância DisplayInformation está vinculada à exibição e não pode ser usada de outros threads.

Eventos

AdvancedColorInfoChanged

Gerado quando as informações de cor avançadas são alteradas.

ColorProfileChanged

Ocorre quando o perfil de cor da exibição física é alterado.

DisplayContentsInvalidated

Ocorre quando a exibição requer redesenho.

DpiChanged

Ocorre quando a propriedade LogicalDpi é alterada porque os pixels por polegada (PPI) da exibição são alterados.

OrientationChanged

Ocorre quando a propriedade CurrentOrientation ou NativeOrientation é alterada devido a uma alteração de modo ou uma alteração de monitor.

StereoEnabledChanged

Ocorre quando a propriedade StereoEnabled é alterada porque o suporte para alterações 3D estereoscópicas.

Aplica-se a

Confira também