Visibilidade da barra de status da página no iOS

  • Artigo

Baixar exemplo Baixar o exemplo

Essa plataforma iOS específica é usada para definir a visibilidade da barra de status em um Pagee inclui a capacidade de controlar como a barra de status entra ou sai do Page. Ele é consumido em XAML definindo a Page.PrefersStatusBarHidden propriedade anexada como um valor da StatusBarHiddenMode enumeração e, opcionalmente, a Page.PreferredStatusBarUpdateAnimation propriedade anexada a um valor da UIStatusBarAnimation enumeração:

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

Como alternativa, ele pode ser consumido do C# usando a API fluente:

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

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

O Page.On<iOS> método especifica que essa plataforma específica só será executada no iOS. O Page.SetPrefersStatusBarHidden método, no Xamarin.Forms.PlatformConfiguration.iOSSpecific namespace, é usado para definir a visibilidade da barra de status em um Page especificando um dos valores de StatusBarHiddenMode enumeração: Default, Trueou False. Os StatusBarHiddenMode.True valores e StatusBarHiddenMode.False definem a visibilidade da barra de status independentemente da orientação do dispositivo e o StatusBarHiddenMode.Default valor oculta a barra de status em um ambiente verticalmente compacto.

O resultado é que a visibilidade da barra de status em um Page pode ser definida:

Plataforma de visibilidade da barra de status específica

Observação

Em um TabbedPage, o valor de enumeração especificado StatusBarHiddenMode também atualizará a barra de status em todas as páginas filho. Em todos os outros Pagetipos derivados, o valor de enumeração especificado StatusBarHiddenMode só atualizará a barra de status na página atual.

O Page.SetPreferredStatusBarUpdateAnimation método é usado para definir como a barra de status entra ou sai Page especificando um dos valores de UIStatusBarAnimation enumeração: None, Fadeou Slide. Se o Fade valor ou Slide enumeração for especificado, uma animação de 0,25 segundo será executada à medida que a barra de status entrar ou sair do Page.