DisplayInformation Classe

Définition

Espace de noms:

Windows.Graphics.Display

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.

Voir aussi

• Exemple d’orientation d’affichage (Windows 10)
• Mise à l’échelle en fonction de l’exemple DPI (Windows 10)
• Exemple d’image d’aperçu de l’appareil photo (Windows 10)
• Exemple d’application caméra de base (Windows 10)
• Exemple de stabilisation vidéo (Windows 10)
• Exemple de détection de visage de caméra (Windows 10)
• Exemple de contrôles de caméra manuels (Windows 10)
• Exemple de plage dynamique élevée (Windows 10)
• Exemple de capture avancée de caméra