Compartilhar via


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

Esta interface do usuário do aplicativo multiplataforma .NET (.NET MAUI) específica da plataforma 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 bindable como um UIModalPresentationStyle valor de enumeração:

<ContentPage ...
             xmlns:ios="clr-namespace:Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;assembly=Microsoft.Maui.Controls"
             ios:Page.ModalPresentationStyle="OverFullScreen">
    ...
</ContentPage>

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

using Microsoft.Maui.Controls.PlatformConfiguration;
using Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific;
...

public class iOSModalFormSheetPageCode : ContentPage
{
    public iOSModalFormSheetPageCode()
    {
        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 Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific namespace, é usado para definir o estilo de apresentação modal em um especificando um Page 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 do 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, mapeia isso para , UIKit mas alguns controladores de exibição do sistema podem mapeá-lo para UIModalPresentationStyle.PageSheetum 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 abranger o conteúdo subjacente.

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

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

Modal presentation styles.

Observação

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