Compartilhar via


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

Especificações do .NET MAUI para a plataforma iOS são usadas para definir o estilo de apresentação de uma página modal e também podem ser usadas para exibir páginas modais com fundo transparente. Ele é utilizado em XAML ao definir a propriedade associável Page.ModalPresentationStyle para um valor de enumeração UIModalPresentationStyle.

<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# por meio da 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 método Page.On<iOS> especifica que essa plataforma específica só será executada no iOS. O método Page.SetModalPresentationStyle, no namespace Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific, é usado para definir o estilo de apresentação modal em um Page especificando um dos seguintes valores de enumeração UIModalPresentationStyle:

  • 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 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.
  • Popover, que define o estilo de apresentação modal para exibir o conteúdo em um popover.

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

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

estilos de apresentação Modal.

Nota

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 Realizar navegação modal.