DisplayInformation Classe

  • Référence

Définition

Espace de noms:
Windows.Graphics.Display
Modifier

Surveille et contrôle les informations relatives à une vue d’application. La classe fournit des événements pour permettre aux clients de surveiller les modifications apportées à l’affichage de l’application affectant les affichages sur lesquels réside l’affichage, ainsi que les modifications apportées aux affichages qui peuvent affecter l’affichage de l’application.

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
Héritage
Object Platform::Object IInspectable DisplayInformation
Attributs
ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Une instance DisplayInformation ne mappe pas à un affichage spécifique, mais effectue le suivi des informations relatives à l’affichage quel que soit l’emplacement de l’affichage de l’application. L’appel de GetForCurrentView retourne toujours l’instance unique du CoreApplicationView du thread actuel. Une instance de DisplayInformation ne peut être utilisée qu’à partir du thread sur lequel elle a été créée.

Pour gérer les événements DisplayInformation, utilisez un gestionnaire d’événements pour l’événement spécifique. Par exemple, pour DisplayInformation.DpiChanged, utilisez « TypedEventHandler<DisplayInformation, Object> DpiChanged ».

Tout événement de modification de propriété de DisplayInformation peut se déclencher si votre application est déplacée d’un moniteur vers un autre. ColorProfileChanged est déclenché lorsque le profil de couleur de l’affichage change. DpiChanged est déclenché lorsque les propriétés LogicalDpi, ResolutionScale et RawPixelsPerViewPixel changent parce qu’un utilisateur a sélectionné un autre niveau de zoom ou modifié la résolution de l’écran. OrientationChanged est déclenché si un utilisateur modifie l’orientation de l’écran.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1511 10586 DiagonalsizeInInches
1607 14393 ScreenHeightInRawPixels
1607 14393 ScreenWidthInRawPixels
1803 17134 AdvancedColorInfoChanged
1803 17134 GetAdvancedColorInfo

Propriétés

AutoRotationPreferences

Obtient et définit l’orientation préférée de l’application.
CurrentOrientation

Obtient l’orientation actuelle d’un moniteur rectangulaire.
DiagonalSizeInInches

Taille diagonale de l’affichage en pouces.
LogicalDpi

Obtient les pixels par pouce logique de l’environnement actuel.
NativeOrientation

Obtient l’orientation native du moniteur d’affichage, qui est généralement l’orientation où les boutons de l’appareil correspondent à l’orientation du moniteur.
RawDpiX

Obtient les points bruts par pouce (PPP) le long de l’axe X du moniteur d’affichage.
RawDpiY

Obtient les points bruts par pouce (PPP) le long de l’axe y du moniteur d’affichage.
RawPixelsPerViewPixel

Obtient une valeur représentant le nombre de pixels bruts (physiques) pour chaque pixel d’affichage (disposition).
ResolutionScale

Obtient le facteur d’échelle de la fenêtre d’application.
ScreenHeightInRawPixels

Retourne la résolution de hauteur actuelle du moniteur logique.
ScreenWidthInRawPixels

Retourne la résolution de largeur actuelle du moniteur logique.
StereoEnabled

Obtient une valeur qui indique si l’appareil prend en charge la 3D stéréoscopique.

Méthodes

GetAdvancedColorInfo()

Récupère les informations de couleur avancée.
GetColorProfileAsync()

Obtient de manière asynchrone le profil de couleur ICC (International Color Consortium) par défaut associé à l’affichage physique.
GetForCurrentView()

Obtient le instance DisplayInformation associé au CoreApplicationView du thread actif. Cette instance DisplayInformation est liée à la vue et ne peut pas être utilisée à partir d’autres threads.

Événements

AdvancedColorInfoChanged

Déclenché lorsque les informations de couleur avancées sont modifiées.
ColorProfileChanged

Se produit lorsque le profil de couleur de l’affichage physique change.
DisplayContentsInvalidated

Se produit lorsque l’affichage nécessite un redessinage.
DpiChanged

Se produit lorsque la propriété LogicalDpi change, car les pixels par pouce (PPI) de l’affichage changent.
OrientationChanged

Se produit lorsque la propriété CurrentOrientation ou NativeOrientation change en raison d’un changement de mode ou d’un changement de moniteur.
StereoEnabledChanged

Se produit lorsque la propriété StereoEnabled change en raison de la prise en charge des modifications 3D stéréoscopiques.

S’applique à

Voir aussi