Estilo de presentación de página modal en iOS

Esta interfaz de usuario de aplicación multiplataforma de .NET (.NET MAUI) específica de la plataforma iOS se usa para establecer el estilo de presentación de una página modal y, además, se puede usar para mostrar páginas modales que tienen fondos transparentes. Se utiliza en XAML estableciendo la propiedad enlazable Page.ModalPresentationStyle en un valor de enumeración UIModalPresentationStyle.

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

Como alternativa, se puede consumir desde C# mediante la API fluida:

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

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

El método Page.On<iOS> especifica que este específico de la plataforma solo se ejecutará en iOS. El método Page.SetModalPresentationStyle, en el espacio de nombres Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific, se usa para establecer el estilo de presentación modal en un Page especificando uno de los siguientes valores de enumeración UIModalPresentationStyle:

• FullScreen, que establece el estilo de presentación modal para abarcar toda la pantalla. De forma predeterminada, las páginas modales se muestran con este estilo de presentación.
• FormSheet, que establece que el estilo de presentación modal se centre en y sea menor que la pantalla.
• Automatic, que establece el estilo de presentación modal en el valor predeterminado elegido por el sistema. Para la mayoría de los controladores de vista, UIKit asigna esto a UIModalPresentationStyle.PageSheet, pero algunos controladores de vista del sistema pueden asignarlo a un estilo diferente.
• OverFullScreen, que establece el estilo de presentación modal para cubrir la pantalla.
• PageSheet, que establece el estilo de presentación modal para cubrir el contenido subyacente.
• Popover, que establece el estilo de presentación modal para mostrar contenido en una ventana emergente.

Además, el método GetModalPresentationStyle se puede usar para recuperar el valor actual de la enumeración UIModalPresentationStyle que se aplica a la Page.

El resultado es que se puede establecer el estilo de presentación modal en un Page:

Nota

Las páginas que usan esta plataforma específica para establecer el estilo de presentación modal deben usar la navegación modal. Para obtener más información, vea Realizar navegación modal.