Informations d’affichage de l’appareil

Parcourir l’exemple

Cet article explique comment utiliser l’interface utilisateur de l’application multiplateforme .NET (.NET MAUI) IDeviceDisplay pour lire des informations sur les métriques d’écran de l’appareil. Cette interface peut être utilisée pour demander que l’écran reste éveillé pendant l’exécution de l’application.

L’implémentation par défaut de l’interface IDeviceDisplay est disponible via la DeviceDisplay.Current propriété. L’interface et DeviceDisplay la IDeviceDisplay classe sont contenues dans l’espace Microsoft.Maui.Devices de noms.

Informations d’affichage principales

La MainDisplayInfo propriété retourne des informations sur l’écran et l’orientation. L’exemple de code suivant utilise l’événement Loaded d’une page pour lire des informations sur l’écran actuel :

private void ReadDeviceDisplay()
{
    System.Text.StringBuilder sb = new System.Text.StringBuilder();

    sb.AppendLine($"Pixel width: {DeviceDisplay.Current.MainDisplayInfo.Width} / Pixel Height: {DeviceDisplay.Current.MainDisplayInfo.Height}");
    sb.AppendLine($"Density: {DeviceDisplay.Current.MainDisplayInfo.Density}");
    sb.AppendLine($"Orientation: {DeviceDisplay.Current.MainDisplayInfo.Orientation}");
    sb.AppendLine($"Rotation: {DeviceDisplay.Current.MainDisplayInfo.Rotation}");
    sb.AppendLine($"Refresh Rate: {DeviceDisplay.Current.MainDisplayInfo.RefreshRate}");

    DisplayDetailsLabel.Text = sb.ToString();
}

L’interface IDeviceDisplay fournit également l’événement MainDisplayInfoChanged déclenché lorsqu’une métrique d’écran change, par exemple lorsque l’orientation de l’appareil passe de DisplayOrientation.Landscape .DisplayOrientation.Portrait

Conserver l’écran sur

Vous pouvez également empêcher le verrouillage de l’appareil ou l’écran désactivé en définissant la KeepScreenOn propriété truesur . L’exemple de code suivant bascule le verrou d’écran chaque fois que le contrôle de commutateur est enfoncé :

private void AlwaysOnSwitch_Toggled(object sender, ToggledEventArgs e) =>
    DeviceDisplay.Current.KeepScreenOn = AlwaysOnSwitch.IsToggled;

Différences de plateforme

Cette section décrit les différences spécifiques à la plateforme avec l’affichage de l’appareil.