Diseño TwoPaneView de Xamarin.Forms

  • Artículo

La clase TwoPaneView representa un contenedor con dos vistas que ajustan el tamaño y la posición del contenido en el espacio disponible, ya sea en paralelo o de arriba a abajo. TwoPaneView hereda de Grid, por lo que la manera más sencilla de pensar en estas propiedades es como si se aplicaran a una cuadrícula.

Configuración de TwoPaneView

Siga estas instrucciones para crear un diseño de doble pantalla en la aplicación:

  1. Siga las instrucciones de la sección Primeros pasos para agregar NuGet y configurar la clase MainActivity de Android.

  2. Comience con una clase TwoPaneView básica con el código XAML siguiente:

    <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>

Sugerencia

El XAML anterior omite muchos atributos comunes del elemento ContentPage. Al agregar una clase TwoPaneView a la aplicación, no olvide declarar el espacio de nombres xmlns:dualScreen como se muestra.

Descripción de los modos de TwoPaneView

Solo puede estar activo uno de estos modos:

  • SinglePane actualmente solo hay un panel visible.
  • Wide los dos paneles se disponen en horizontal. Un panel se sitúa a la izquierda y el otro a la derecha. Cuando se muestra en dos pantallas, en este modo el dispositivo está en vertical.
  • Tall los dos paneles se disponen en vertical. Un panel está en la parte superior y el otro en la parte inferior. Cuando se muestra en dos pantallas, en este modo el dispositivo está en horizontal.

Control de TwoPaneView cuando solo está en una pantalla

Las siguientes propiedades se aplican cuando TwoPaneView ocupa una sola pantalla:

  • MinTallModeHeight indica el alto mínimo que debe tener el control para entrar en modo Tall.
  • MinWideModeWidth indica el ancho mínimo que debe tener el control para entrar en modo Wide.
  • Pane1Length establece el ancho de Panel1 en el modo Wide, el alto de Panel1 en modo Tall y no tiene ningún efecto en el modo SinglePane.
  • Pane2Length establece el ancho de Panel2 en el modo Wide, el alto de Panel2 en modo Tall y no tiene ningún efecto en el modo SinglePane.

Importante

Si TwoPaneView se distribuye en dos pantallas, estas propiedades no tienen ningún efecto.

Propiedades que se aplican cuando se está en una pantalla o en dos

Las siguientes propiedades se aplican cuando TwoPaneView ocupa una sola pantalla o dos pantallas:

  • TallModeConfiguration cuando está en modo Tall (alto) indica la disposición de arriba a abajo, o bien si solo quiere un panel visible según lo que se haya definido mediante TwoPaneViewPriority.
  • WideModeConfiguration cuando está en modo Wide (ancho), la disposición de izquierda a derecha, o bien si solo quiere un panel visible según lo que se haya definido mediante TwoPaneViewPriority.
  • PanePriority determina si se muestra Panel1 o Panel2 en el modo SinglePane.