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 utilizzata in XAML impostando la Page.ModalPresentationStyle proprietà associabile su un UIModalPresentationStyle valore di enumerazione:

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

• 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 da allineare al centro e più piccolo 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.

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

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

Nota

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