iOS でのページのステータス バーの表示

Download Sampleサンプルのダウンロード

この iOS プラットフォーム固有の機能は、Page でのステータス バーの可視性を設定するために使用され、ステータス バーが Page で表示/非表示される方法を制御する機能が含まれています。 Page.PrefersStatusBarHidden 添付プロパティを StatusBarHiddenMode 列挙型の値に設定し、必要に応じて Page.PreferredStatusBarUpdateAnimation 添付プロパティを UIStatusBarAnimation 列挙型の値に設定することで、XAML で使用されます:

<ContentPage ...
             xmlns:ios="clr-namespace:Xamarin.Forms.PlatformConfiguration.iOSSpecific;assembly=Xamarin.Forms.Core"
             ios:Page.PrefersStatusBarHidden="True"
             ios:Page.PreferredStatusBarUpdateAnimation="Fade">
  ...
</ContentPage>

あるいは、Fluent API を使用して C# から使用することもできます。

using Xamarin.Forms.PlatformConfiguration;
using Xamarin.Forms.PlatformConfiguration.iOSSpecific;
...

On<iOS>().SetPrefersStatusBarHidden(StatusBarHiddenMode.True)
         .SetPreferredStatusBarUpdateAnimation(UIStatusBarAnimation.Fade);

Page.On<iOS> メソッドは、このプラットフォーム固有が iOS でのみ実行されるように指定します。 Xamarin.Forms.PlatformConfiguration.iOSSpecific 名前空間内の Page.SetPrefersStatusBarHidden メソッドは、StatusBarHiddenMode 列挙値を DefaultTrueFalse のうちの 1 つに指定して、Page でのステータス バーの可視性をに設定するために使用されます。 StatusBarHiddenMode.True 値と StatusBarHiddenMode.False 値は、デバイスの向きに関係なくステータス バーの可視性を設定し、StatusBarHiddenMode.Default 値は縦方向のコンパクトな環境ではステータス バーを非表示にします。

その結果、Page でのステータス バーの可視性を設定できます:

Status Bar Visibility Platform-Specific

Note

TabbedPage では、指定した StatusBarHiddenMode 列挙値によって、すべての子ページのステータス バーも更新されます。 他のすべてのPage 派生型では、指定した StatusBarHiddenMode 列挙値によって現在のページのステータス バーのみが更新されます。

この Page.SetPreferredStatusBarUpdateAnimation メソッドは、UIStatusBarAnimation 列挙値を NoneFadeSlide のいずれかに指定して、Page におけるステータス バーの表示/非表示方法を設定するために使用されます。 Fade または Slide 列挙値が指定されている場合、Page でステータス バーが表示または非表示になる時に 0.25 秒のアニメーションが実行されます。