Formatvorlage für modale Seitenpräsentation unter iOS

Diese .NET Multi-Platform App UI (.NET MAUI) iOS-plattformspezifisch wird verwendet, um den Darstellungsstil einer modalen Seite festzulegen, und darüber hinaus kann verwendet werden, um modale Seiten mit transparenten Hintergründen anzuzeigen. Sie wird in XAML genutzt, indem Sie die Page.ModalPresentationStyle bindable Eigenschaft auf einen UIModalPresentationStyle Enumerationswert festlegen:

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

Alternativ kann sie mit der Fluent-API von C# genutzt werden:

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

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

Die Page.On<iOS>-Methode gibt an, dass diese plattformspezifische Funktion nur unter iOS ausgeführt wird. Die Page.SetModalPresentationStyle-Methode im Microsoft.Maui.Controls.PlatformConfiguration.iOSSpecific-Namespace wird verwendet, um den modalen Präsentationsstil für eine Page festzulegen, indem sie einen der folgenden UIModalPresentationStyle Enumerationswerte angeben:

• FullScreen, wodurch der modale Präsentationsstil auf den gesamten Bildschirm festgelegt ist. Standardmäßig werden modale Seiten mithilfe dieses Präsentationsformats angezeigt.
• FormSheet, wodurch der modale Präsentationsstil so festgelegt wird, dass er zentriert auf dem Bildschirm und kleiner als dieser ist.
• Automatic, wodurch der modale Präsentationsstil auf den vom System ausgewählten Standardstil festgelegt wird. Bei den meisten Ansichtscontrollern ordnet UIKit dies UIModalPresentationStyle.PageSheetzu, aber einige Systemansichtscontroller ordnen sie möglicherweise einem anderen Stil zu.
• OverFullScreen, wodurch der modale Präsentationsstil so festgelegt wird, dass der Bildschirm verdeckt wird.
• PageSheet, wodurch der modale Präsentationsstil so festgelegt wird, dass er den zugrunde liegenden Inhalt abdeckt.
• Popover, wodurch der modale Präsentationsstil so festgelegt wird, dass Inhalt in einem Popover angezeigt wird.

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

Das Ergebnis ist, dass das modale Präsentationsformat für eine Page festgelegt werden kann:

Anmerkung

Seiten, die eine plattformspezifische Methode verwenden, um den modalen Präsentationsstil festzulegen, müssen modale Navigation nutzen. Weitere Informationen finden Sie unter Ausführen der modalen Navigation.