iOS でのページのステータス バーの表示
この 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
列挙値を Default
、True
、False
のうちの 1 つに指定して、Page
でのステータス バーの可視性をに設定するために使用されます。 StatusBarHiddenMode.True
値と StatusBarHiddenMode.False
値は、デバイスの向きに関係なくステータス バーの可視性を設定し、StatusBarHiddenMode.Default
値は縦方向のコンパクトな環境ではステータス バーを非表示にします。
その結果、Page
でのステータス バーの可視性を設定できます:
Note
TabbedPage
では、指定した StatusBarHiddenMode
列挙値によって、すべての子ページのステータス バーも更新されます。 他のすべてのPage
派生型では、指定した StatusBarHiddenMode
列挙値によって現在のページのステータス バーのみが更新されます。
この Page.SetPreferredStatusBarUpdateAnimation
メソッドは、UIStatusBarAnimation
列挙値を None
、Fade
、Slide
のいずれかに指定して、Page
におけるステータス バーの表示/非表示方法を設定するために使用されます。 Fade
または Slide
列挙値が指定されている場合、Page
でステータス バーが表示または非表示になる時に 0.25 秒のアニメーションが実行されます。