Freigeben über

Geräteanzeigeinformationen

  • Artikel

Browse sample. Durchsuchen Sie das Beispiel

In diesem Artikel wird beschrieben, wie Sie die .NET Multi-Platform App UI (.NET MAUI) IDeviceDisplay-Schnittstelle verwenden können, um Informationen über die Bildschirmmetriken des Geräts zu lesen. Diese Schnittstelle kann verwendet werden, um anzufordern, dass der Bildschirm eingeschaltet bleibt, während die App ausgeführt wird.

Die Standardimplementierung der IDeviceDisplay-Schnittstelle ist über die DeviceDisplay.Current-Eigenschaft verfügbar. Die IDeviceDisplay-Schnittstelle sowie die DeviceDisplay-Klasse sind im Microsoft.Maui.Devices-Namespace enthalten.

Informationen zum Hauptbildschirm

Die MainDisplayInfo-Eigenschaft gibt Informationen über den Bildschirm und die Ausrichtung zurück. Im folgenden Codebeispiel wird das Loaded-Ereignis einer Seite verwendet, um Informationen zum aktuellen Bildschirm zu lesen:

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();
}

Die IDeviceDisplay-Schnittstelle stellt auch das MainDisplayInfoChanged-Ereignis bereit, das ausgelöst wird, wenn sich eine Bildschirmmetrik ändert, z. B. wenn sich die Geräteausrichtung von DisplayOrientation.Landscape in DisplayOrientation.Portrait ändert.

Bildschirm eingeschaltet lassen

Sie können auch verhindern, dass das Gerät gesperrt oder der Bildschirm deaktiviert wird, indem Sie die KeepScreenOn-Eigenschaft auf true festlegen. Im folgenden Codebeispiel wird die Bildschirmsperre beim Drücken des Schaltersteuerelements umgeschaltet:

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

Plattformunterschiede

In diesem Abschnitt werden die plattformspezifischen Unterschiede mit der Geräteanzeige beschrieben.

Keine Plattformunterschiede.