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 ドキュメントを参照してください。