Partager via


Xamarin.Essentials: Informations d’affichage de l’appareil

La classe DeviceDisplay fournit des informations sur les métriques d’écran de l’appareil où s’exécute l’application et peut demander d’empêcher l’écran de se mettre en veille quand l’application est en cours d’exécution.

Démarrage

Pour commencer à utiliser cette API, lisez le guide de prise en main pour Xamarin.Essentials vous assurer que la bibliothèque est correctement installée et configurée dans vos projets.

Utilisation de DeviceDisplay

Ajoutez une référence à Xamarin.Essentials votre classe :

using Xamarin.Essentials;

Informations principales sur l’écran

En plus des informations de base relatives à l’appareil, la classe DeviceDisplay contient des informations sur l’écran et l’orientation de l’appareil.

// Get Metrics
var mainDisplayInfo = DeviceDisplay.MainDisplayInfo;

// Orientation (Landscape, Portrait, Square, Unknown)
var orientation = mainDisplayInfo.Orientation;

// Rotation (0, 90, 180, 270)
var rotation = mainDisplayInfo.Rotation;

// Width (in pixels)
var width = mainDisplayInfo.Width;

// Height (in pixels)
var height = mainDisplayInfo.Height;

// Screen density
var density = mainDisplayInfo.Density;

La classe DeviceDisplay expose également un événement auquel il est possible de s’abonner, et qui se déclenche chaque fois qu’une métrique d’écran change :

public class DisplayInfoTest
{
    public DisplayInfoTest()
    {
        // Subscribe to changes of screen metrics
        DeviceDisplay.MainDisplayInfoChanged += OnMainDisplayInfoChanged;
    }

    void OnMainDisplayInfoChanged(object sender, DisplayInfoChangedEventArgs  e)
    {
        // Process changes
        var displayInfo = e.DisplayInfo;
    }
}

Conserver l’écran sur

La classe DeviceDisplay expose une propriété bool appelée KeepScreenOn qui peut être définie pour tenter d’empêcher la désactivation ou le verrouillage de l’écran de l’appareil.

public class KeepScreenOnTest
{
    public void ToggleScreenLock()
    {
        DeviceDisplay.KeepScreenOn = !DeviceDisplay.KeepScreenOn;
    }
}

Différences entre les plateformes

Aucune différence.

API

Retrouvez d’autres vidéos Xamarin sur Channel 9 et YouTube.