Xamarin.Essentials:アプリのテーマ

RequestedTheme API は AppInfo クラスの一部であり、実行中のアプリに対してシステムから要求されているテーマに関する情報が提供されます。

作業開始

この API の使用を始めるには、Xamarin.Essentials の概要ガイドを読み、ライブラリが正しくインストールされてプロジェクトに設定されていることを確認してください。

RequestedTheme の使用

クラスの Xamarin.Essentials への参照を追加します。

using Xamarin.Essentials;

テーマ情報の取得

要求されたアプリケーションのテーマは、次の API を使用して検出できます。

AppTheme appTheme = AppInfo.RequestedTheme;

これにより、システムによって現在要求されているアプリケーションのテーマが提供されます。 その戻り値は、次のいずれかになります。

  • 指定されていません。
  • 淡色
  • 濃色

オペレーティング システムから要求される特定のユーザー インターフェイス スタイルがない場合は、Unspecified が返されます。 この例としては、13.0 より前のバージョンの iOS を稼働しているデバイスなどがあります。

プラットフォームの実装の詳細

Android では、要求するテーマの種類を指定するために、ユーザーからの構成モードが使用されます。 これは、Android のバージョンに基づき、ユーザーが変更したり、バッテリ節約モードが有効になっているときに変更されたりする場合があります。

詳細については、公式のダーク テーマに関する Android ドキュメントを参照してください。

API

他の Xamarin ビデオは、Channel 9 および YouTube でご覧いただけます。