Teilen über


Xamarin.Forms TwoPaneView-Layout

Das TwoPaneView-Steuerelement ist im Xamarin.Forms.DualScreen-NuGet Vorschau verfügbar. Der folgende Code zeigt ein einfaches XAML-Beispiel:

<ContentPage xmlns:dualScreen="clr-namespace:Xamarin.Forms.DualScreen;assembly=Xamarin.Forms.DualScreen">
    <dualScreen:TwoPaneView>
        <dualScreen:TwoPaneView.Pane1>
            <StackLayout>
                <Label Text="Pane1 Content" />
            </StackLayout>
        </dualScreen:TwoPaneView.Pane1>
        <dualScreen:TwoPaneView.Pane2>
            <StackLayout>
                <Label Text="Pane2 Content" />
            </StackLayout>
        </dualScreen:TwoPaneView.Pane2>
    </dualScreen:TwoPaneView>
</ContentPage>

Standardmäßig versucht TwoPaneView, beide Bereiche immer zu rendern. Dies bedeutet, dass die Ansicht auf zwei Bereiche aufgeteilt wird, wenn die App auf einem einzelnen Bildschirm ausgeführt wird. Die folgenden Eigenschaften können verwendet werden, um das Layout zu beeinflussen, wenn es nur auf einem Bildschirm gerendert wird:

  • MinTallModeHeight: Diese Eigenschaft gibt die Mindesthöhe des Steuerelements zum Aktivieren des Modus „Tall“ an.
  • MinWideModeWidth: Diese Eigenschaft gibt die Mindestbreite des Steuerelements zum Aktivieren des Modus „Wide“ an.
  • Pane1Length : Legt die Breite von Pane1 im Wide-Modus und die Höhe von Pane1 im Tall-Modus fest und hat keine Auswirkungen im SinglePane-Modus.
  • Pane2Length : Legt die Breite von Pane2 im Wide-Modus und die Höhe von Pane2 im Tall-Modus fest und hat keine Auswirkungen im SinglePane-Modus.

Auf dem Surface Duo können Anwendungen auf zwei Bildschirmen fortlaufend angezeigt werden. Das TwoPaneView-Steuerelement verfügt über zusätzliche Eigenschaften, die bestimmen, wo die beiden Bereiche in Beziehung zueinander gerendert werden (sowohl bei einem einzelnen als auch bei zwei Bildschirmen):

  • TallModeConfiguration : Im Hochformatmodus können die Bereiche Top/Bottom, Bottom/Top oder nur ein einzelner Bereich angezeigt werden.
  • WideModeConfiguration : Im Wide-Modus können die Bereiche Links/Rechts, Rechts/Links oder nur ein einzelner Bereich sein.
  • PanePriority : Gibt an, ob Pane1 oder Pane2 angezeigt werden soll, wenn im SinglePane-Modus für den Hoch- oder Breitenmodus ausgewählt wird.

Es gibt drei Anzeigemodi:

  • SinglePane: Derzeit ist nur ein Bereich sichtbar.
  • Wide: Die beiden Bereiche sind horizontal angeordnet. Ein Bereich befindet sich auf der linken Seite, der andere auf der rechten Seite. Auf dem Surface Duo befinden sich die beiden Bildschirme im Hochformat.
  • Tall: Die beiden Bereiche sind vertikal angeordnet. Ein Bereich befindet sich oben und der andere unten. Auf dem Surface Duo befinden sich die beiden Bildschirme im Querformat.

Weitere Informationen finden Sie in der Xamarin-Dokumentation. Einige der Entwurfsüberlegungen in der UWP TwoPaneView-Dokumentation gelten auch für das Xamarin-Steuerelement.

Problembehandlung

Wenn Sie unerwartetes Verhalten oder Layout von TwoPaneViewbeobachten, überprüfen Sie die Einrichtungsanweisungen, einschließlich der -Methode und ConfigurationChanges des Init -Attributs.