Xamarin.Essentials: App-Design

Die API RequestedTheme gehört zur AppInfo-Klasse und stellt Informationen dazu bereit, welches Design vom System für Ihre ausgeführte App angefordert wird.

Erste Schritte

Lesen Sie zum Einstieg in die Verwendung dieser API den Leitfaden mit ersten Schritte für Xamarin.Essentials, um sicherzustellen, dass die Bibliothek ordnungsgemäß installiert und in Ihren Projekten eingerichtet ist.

Verwenden von RequestedTheme

Fügen Sie in Ihrer Klasse einen Verweis auf Xamarin.Essentials hinzu:

using Xamarin.Essentials;

Abrufen der Designinformationen

Das angeforderte Anwendungsdesign kann mithilfe der folgenden API erkannt werden:

AppTheme appTheme = AppInfo.RequestedTheme;

Dadurch wird das aktuell angeforderte Design vom System für Ihre Anwendung bereitgestellt. Der Rückgabewert ist einer der folgenden:

  • Nicht angegeben.
  • Hell
  • Dunkel

„Nicht angegeben“ wird zurückgegeben, wenn das Betriebssystem nicht über einen bestimmten Benutzeroberflächenstil verfügt, der angefordert werden kann. Ein Beispiel hierfür sind Geräte, auf denen Versionen von iOS vor 13.0 ausgeführt werden.

Besonderheiten bei der plattformspezifischen Implementierung

Android verwendet Konfigurationsmodi, um den Typ des Designs festzulegen, der vom Benutzer angefordert werden soll. Je nach Android-Version kann er vom Benutzer geändert werden oder wird geändert, wenn der Stromsparmodus aktiviert ist.

Weitere Informationen finden Sie in der offiziellen Android-Dokumentation zum dunklen Design.

API

Auf Channel 9 und auf YouTube finden Sie weitere Videos zu Xamarin.