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
:
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
.