Compartir vía


Visibilidad de la barra de estado de página en iOS

Esta característica específica de la plataforma iOS se usa para establecer la visibilidad de la barra de estado de un control Page e incluye la capacidad de controlar cómo la barra de estado entra o sale de Page. Se consume en XAML estableciendo la propiedad adjunta Page.PrefersStatusBarHidden en un valor de la enumeración StatusBarHiddenMode y, opcionalmente, la propiedad adjunta Page.PreferredStatusBarUpdateAnimation en un valor de la enumeración UIStatusBarAnimation:

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

Como alternativa, se puede consumir desde C# mediante la API fluida:

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

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

El método Page.On<iOS> especifica que esta plataforma específica solo se ejecutará en iOS. El método Page.SetPrefersStatusBarHidden, del espacio de nombres Xamarin.Forms.PlatformConfiguration.iOSSpecific, se usa para establecer la visibilidad de la barra de estado de un Page especificando uno de los valores de enumeración StatusBarHiddenMode: Default, True o False. Los valores StatusBarHiddenMode.True y StatusBarHiddenMode.False establecen la visibilidad de la barra de estado independientemente de la orientación del dispositivo y el valor StatusBarHiddenMode.Default oculta la barra de estado en un entorno verticalmente compacto.

El resultado es que se puede establecer la visibilidad de la barra de estado de un objeto Page:

Visibilidad de la barra de estado específica de la plataforma

Nota:

En un TabbedPage, el valor de enumeración StatusBarHiddenMode especificado también actualizará la barra de estado en todas las páginas secundarias. En todos los demás tipos derivados de Page, el valor de enumeración StatusBarHiddenMode especificado solo actualizará la barra de estado de la página actual.

El método Page.SetPreferredStatusBarUpdateAnimation se usa para establecer cómo entra o sale la barra de estado de Page especificando uno de los valores de enumeración UIStatusBarAnimation: None, Fade o Slide. Si se especifica el valor de enumeración Fade o Slide, se ejecuta una animación de 0,25 segundos a medida que la barra de estado entra o sale de Page.