Estilo de apresentação de página modal no iOS

  • Artigo

Baixar exemplo Baixar o exemplo

Essa plataforma específica do iOS é usada para definir o estilo de apresentação de uma página modal e, além disso, pode ser usada para exibir páginas modais que têm planos de fundo transparentes. Ele é consumido em XAML definindo a Page.ModalPresentationStyle propriedade associável como um UIModalPresentationStyle valor de enumeração:

<ContentPage ...
             xmlns:ios="clr-namespace:Xamarin.Forms.PlatformConfiguration.iOSSpecific;assembly=Xamarin.Forms.Core"
             ios:Page.ModalPresentationStyle="OverFullScreen">
    ...
</ContentPage>

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

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

public class iOSModalFormSheetPageCS : ContentPage
{
    public iOSModalFormSheetPageCS()
    {
        On<iOS>().SetModalPresentationStyle(UIModalPresentationStyle.OverFullScreen);
        ...
    }
}

O Page.On<iOS> método especifica que essa plataforma específica só será executada no iOS. O Page.SetModalPresentationStyle método, no Xamarin.Forms.PlatformConfiguration.iOSSpecific namespace, é usado para definir o estilo de apresentação modal em um Page especificando um dos seguintes UIModalPresentationStyle valores de enumeração:

  • FullScreen, que define o estilo de apresentação modal para abranger toda a tela. Por padrão, as páginas modais são exibidas usando esse estilo de apresentação.
  • FormSheet, que define o estilo de apresentação modal para ser centralizado e menor que a tela.
  • Automatic, que define o estilo de apresentação modal como o padrão escolhido pelo sistema. Para a maioria dos controladores de exibição, UIKit mapeia isso para UIModalPresentationStyle.PageSheet, mas alguns controladores de exibição do sistema podem mapeá-lo para um estilo diferente.
  • OverFullScreen, que define o estilo de apresentação modal para cobrir a tela.
  • PageSheet, que define o estilo de apresentação modal para cobrir o conteúdo subjacente.

Além disso, o GetModalPresentationStyle método pode ser usado para recuperar o valor atual da UIModalPresentationStyle enumeração aplicada ao Page.

O resultado é que o estilo de apresentação modal em um Page pode ser definido:

modais de apresentação estilos modais estilos de apresentação

Observação

As páginas que usam essa plataforma específica para definir o estilo de apresentação modal devem usar a navegação modal. Para obter mais informações, consulte Xamarin.Forms Páginas modais.