Xamarin.Essentials:應用程式主題
RequestedTheme API 是 類別的一部分,AppInfo
並提供系統針對執行中應用程式要求的主題資訊。
開始使用
若要開始使用此 API,請閱讀 入門指南Xamarin.Essentials,以確保連結庫已正確安裝並設定在您的專案中。
使用 RequestedTheme
在類別中新增 的 Xamarin.Essentials 參考:
using Xamarin.Essentials;
取得佈景主題資訊
可透過下列 API 來偵測所要求的應用程式佈景主題:
AppTheme appTheme = AppInfo.RequestedTheme;
這將會提供系統針對您的應用程式目前所要求的佈景主題。 傳回值將會是下列其中一個:
- [未指定]
- 淺色
- 深色
如果作業系統沒有特定的使用者介面樣式可供要求,將會傳回「未指定」。 此情況的其中一個範例,是執行早於 13.0 之 iOS 版本的裝置。
平台實作特性
Android 會使用設定模式來指定要向使用者要求的佈景主題類型。 根據 Android 的版本而定,其可能會由使用者變更,或是在啟用節約耗電量模式時變更。
您可以在官方的深色佈景主題 Android 文件 \(英文\) 中深入閱讀。