Compartilhar via

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

  • Artigo

Esse específico da plataforma iOS é usado para definir o estilo de apresentação de uma página modal e, além disso, pode ser usado para exibir páginas modais com 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 método Page.On<iOS> 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 como centralizado e menor que a tela.
  • Automatic, que define o estilo de apresentação modal para 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 a Page pode ser definido:

Estilos de apresentação modal

Observação

As páginas que usam esse específico da plataforma 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.