Share via


Visibilité de la barre d’état de page sur iOS

Cette plateforme iOS spécifique est utilisée pour définir la visibilité de la barre d’état sur un Page, et elle inclut la possibilité de contrôler la façon dont la barre d’état entre ou quitte le Page. Elle est consommée en XAML en définissant la Page.PrefersStatusBarHidden propriété jointe sur une valeur de l’énumération StatusBarHiddenMode , et éventuellement la Page.PreferredStatusBarUpdateAnimation propriété jointe sur une valeur de l’énumération UIStatusBarAnimation :

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

Elle peut également être consommée à partir de C# à l’aide de l’API Fluent :

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

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

La Page.On<iOS> méthode spécifie que cette plateforme ne s’exécutera que sur iOS. La Page.SetPrefersStatusBarHidden méthode, dans l’espace Xamarin.Forms.PlatformConfiguration.iOSSpecific de noms, est utilisée pour définir la visibilité de la barre d’état sur un Page en spécifiant l’une des valeurs d’énumération StatusBarHiddenMode : Default, Trueou False. Les StatusBarHiddenMode.True valeurs définissent StatusBarHiddenMode.False la visibilité de la barre d’état, quelle que soit l’orientation de l’appareil, et la StatusBarHiddenMode.Default valeur masque la barre d’état dans un environnement compact verticalement.

Le résultat est que la visibilité de la barre d’état sur un Page peut être définie :

Visibilité de la barre d’état spécifique à la plateforme

Remarque

Sur un TabbedPage, la valeur d’énumération spécifiée StatusBarHiddenMode met également à jour la barre d’état sur toutes les pages enfants. Sur tous les autres Pagetypes dérivés, la valeur d’énumération spécifiée StatusBarHiddenMode met à jour uniquement la barre d’état sur la page active.

La Page.SetPreferredStatusBarUpdateAnimation méthode est utilisée pour définir la façon dont la barre d’état entre ou quitte la Page barre d’état en spécifiant l’une des valeurs d’énumération UIStatusBarAnimation : None, Fadeou Slide. Si la valeur ou l’énumération Fade est spécifiée, une animation de 0,25 seconde s’exécute lorsque la barre d’état entre ou quitte le Page.Slide