Stile di presentazione della pagina modale in iOS

Questa interfaccia utente dell'app multipiattaforma .NET (.NET MAUI) specifica della piattaforma iOS viene usata per impostare lo stile di presentazione di una pagina modale e può inoltre essere usata per visualizzare pagine modali con sfondi trasparenti. Viene consumata in XAML impostando la proprietà vincolabile Page.ModalPresentationStyle su un valore di enumerazione UIModalPresentationStyle.

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

In alternativa, può essere usato da C# usando l'API Fluent:

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

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

Il metodo Page.On<iOS> specifica che questo metodo specifico per piattaforma verrà eseguito solo su iOS. Il metodo Page.SetModalPresentationStyle, nello spazio dei nomi Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific, viene utilizzato per impostare lo stile di presentazione modale in un Page specificando uno dei valori di enumerazione UIModalPresentationStyle seguenti:

• FullScreen, che imposta lo stile di presentazione modale per includere l'intero schermo. Per impostazione predefinita, le pagine modali vengono visualizzate utilizzando questo stile di presentazione.
• FormSheet, che imposta lo stile di presentazione modale al centro e inferiore rispetto allo schermo.
• Automatic, che imposta lo stile di presentazione modale sul valore predefinito scelto dal sistema. Per la maggior parte dei controller di visualizzazione, UIKit esegue il mapping a UIModalPresentationStyle.PageSheet, ma alcuni controller di visualizzazione di sistema possono eseguirne il mapping a uno stile diverso.
• OverFullScreen, che imposta lo stile di presentazione modale per coprire lo schermo.
• PageSheet, che imposta lo stile di presentazione modale per coprire il contenuto sottostante.
• Popover, che imposta lo stile di presentazione modale per visualizzare il contenuto in un popover.

Inoltre, il metodo GetModalPresentationStyle può essere utilizzato per recuperare il valore corrente dell'enumerazione UIModalPresentationStyle applicata al Page.

Il risultato è che è possibile impostare lo stile di presentazione modale in un Page:

Nota

Le pagine che usano questa piattaforma specifica per impostare lo stile di presentazione modale devono utilizzare lo spostamento modale. Per ulteriori informazioni, vedere Eseguire la navigazione modale.