Condividi tramite

Stile di presentazione pagina modale in iOS

  • Articolo

Questo specifico della piattaforma iOS viene usato per impostare lo stile di presentazione di una pagina modale e, inoltre, può essere usato 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:Xamarin.Forms.PlatformConfiguration.iOSSpecific;assembly=Xamarin.Forms.Core"
             ios:Page.ModalPresentationStyle="OverFullScreen">
    ...
</ContentPage>

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

using Xamarin.Forms.PlatformConfiguration;
using Xamarin.Forms.PlatformConfiguration.iOSSpecific;
...

public class iOSModalFormSheetPageCS : ContentPage
{
    public iOSModalFormSheetPageCS()
    {
        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 Xamarin.Forms.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 :

Stili di presentazione modali

Nota

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