Sichtbarkeit der Seitenstatusleiste unter iOS

  • Artikel

Beispiel herunterladen Das Beispiel herunterladen

Diese plattformspezifische iOS-Leiste wird verwendet, um die Sichtbarkeit der status leiste auf einem Pagefestzulegen, und es umfasst die Möglichkeit zu steuern, wie die status leiste in die ein- oder verlässt.Page Es wird in XAML verwendet, indem die Page.PrefersStatusBarHidden angefügte Eigenschaft auf einen Wert der StatusBarHiddenMode Enumeration festgelegt wird, und optional die Page.PreferredStatusBarUpdateAnimation angefügte Eigenschaft auf einen Wert der UIStatusBarAnimation Enumeration:

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

Alternativ kann sie über C# mit der Fluent-API genutzt werden:

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

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

Die Page.On<iOS> -Methode gibt an, dass diese plattformspezifische Nur unter iOS ausgeführt wird. Die Page.SetPrefersStatusBarHidden -Methode im Xamarin.Forms.PlatformConfiguration.iOSSpecific Namespace wird verwendet, um die Sichtbarkeit der status leiste auf einem Page festzulegen, indem sie einen der StatusBarHiddenMode Enumerationswerte angeben: Default, Trueoder False. Die StatusBarHiddenMode.True Werte und StatusBarHiddenMode.False legen die status Balkensicht unabhängig von der Geräteausrichtung fest, und der StatusBarHiddenMode.Default Wert blendet die status Leiste in einer vertikal kompakten Umgebung aus.

Das Ergebnis ist, dass die Sichtbarkeit der status Leiste auf einem Page festgelegt werden kann:

Plattformspezifische Statusleistensichtbarkeit

Hinweis

In einem TabbedPageaktualisiert der angegebene StatusBarHiddenMode Enumerationswert auch die status leiste auf allen untergeordneten Seiten. Bei allen anderen Pageabgeleiteten Typen aktualisiert der angegebene StatusBarHiddenMode Enumerationswert nur den status Balken auf der aktuellen Seite.

Die Page.SetPreferredStatusBarUpdateAnimation -Methode wird verwendet, um festzulegen, wie die status Leiste ein- oder verlässt, Page indem Sie einen der UIStatusBarAnimation Enumerationswerte angeben: None, Fadeoder Slide. Wenn der Fade Enumerationswert oder Slide angegeben wird, wird eine Animation von 0,25 Sekunden ausgeführt, wenn die status leiste den Page-Wert eingibt oder verlässt.