Modale Seitenpräsentationsformat unter iOS

  • Artikel

Beispiel herunterladen Das Beispiel herunterladen

Diese plattformspezifische iOS-Plattform dient zum Festlegen des Präsentationsstils einer modalen Seite und kann darüber hinaus verwendet werden, um modale Seiten mit transparenten Hintergründen anzuzeigen. Sie wird in XAML verwendet, indem die Page.ModalPresentationStyle bindbare Eigenschaft auf einen UIModalPresentationStyle Enumerationswert festgelegt wird:

<ContentPage ...
             xmlns:ios="clr-namespace:Xamarin.Forms.PlatformConfiguration.iOSSpecific;assembly=Xamarin.Forms.Core"
             ios:Page.ModalPresentationStyle="OverFullScreen">
    ...
</ContentPage>

Alternativ kann es über C# mithilfe der Fluent-API verwendet werden:

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

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

Die Page.On<iOS> -Methode gibt an, dass diese plattformspezifische Nur unter iOS ausgeführt wird. Die Page.SetModalPresentationStyle -Methode im Xamarin.Forms.PlatformConfiguration.iOSSpecific -Namespace wird verwendet, um den modalen Präsentationsstil für einen Page festzulegen, indem einer der folgenden UIModalPresentationStyle Enumerationswerte angegeben wird:

  • FullScreen, wodurch festgelegt wird, dass der modale Präsentationsstil den gesamten Bildschirm umfasst. Standardmäßig werden modale Seiten mit diesem Präsentationsstil angezeigt.
  • FormSheet, wodurch festgelegt wird, dass der modale Präsentationsstil zentriert und kleiner als der Bildschirm ist.
  • Automatic, wodurch der modale Präsentationsstil auf den vom System ausgewählten Standardwert festgelegt wird. Bei den meisten Ansichtscontrollern UIKit ordnet dies zu UIModalPresentationStyle.PageSheet, aber einige Systemansichtscontroller können es einem anderen Stil zuordnen.
  • OverFullScreen, wodurch der modale Präsentationsstil so festgelegt wird, dass der Bildschirm abgedeckt wird.
  • PageSheet, wodurch der modale Präsentationsstil so festgelegt wird, dass er den zugrunde liegenden Inhalt abdeckt.

Darüber hinaus kann die GetModalPresentationStyle -Methode verwendet werden, um den aktuellen Wert der Enumeration abzurufen, die UIModalPresentationStyle auf angewendet Pagewird.

Das Ergebnis ist, dass der modale Präsentationsstil für ein Page festgelegt werden kann:

Modale Präsentationsstile

Hinweis

Seiten, die diesen plattformspezifischen Stil zum Festlegen des modalen Präsentationsstils verwenden, müssen die modale Navigation verwenden. Weitere Informationen finden Sie unter Xamarin.Forms Modale Seiten.