FlyoutBase.ShouldConstrainToRootBounds Propiedad

Definición

Espacio de nombres:

Windows.UI.Xaml.Controls.Primitives

Obtiene o establece un valor que indica si el control flotante debe mostrarse dentro de los límites de la raíz XAML.

public:
 property bool ShouldConstrainToRootBounds { bool get(); void set(bool value); };

bool ShouldConstrainToRootBounds();

void ShouldConstrainToRootBounds(bool value);

public bool ShouldConstrainToRootBounds { get; set; }

var boolean = flyoutBase.shouldConstrainToRootBounds;
flyoutBase.shouldConstrainToRootBounds = boolean;

Public Property ShouldConstrainToRootBounds As Boolean

Valor de propiedad

Boolean

bool

true si el control flotante debe mostrarse dentro de los límites de la raíz XAML; de lo contrario, false.

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1903 (se introdujo en la versión 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v8.0)

Ejemplos

En este ejemplo, el control flotante no está restringido a los límites raíz de forma predeterminada. Por lo tanto, se respeta la solicitud de colocar el control flotante debajo del botón siempre que haya espacio para él en la pantalla. El control flotante se muestra fuera de la ventana de la aplicación.

<Button Content="Button"
        VerticalAlignment="Bottom" HorizontalAlignment="Center">
    <Button.Flyout>
        <Flyout Placement="Bottom">
            <TextBlock Text="Flyout content" />
        </Flyout>
    </Button.Flyout>
</Button>

En este ejemplo, ShouldConstrainToRootBounds se establece en true, por lo que el control flotante está restringido a los límites raíz. Por lo tanto, la solicitud para colocar el control flotante debajo del botón no se respeta y el control flotante se muestra dentro de la ventana de la aplicación encima del botón.

<Button Content="Button"
        VerticalAlignment="Bottom" HorizontalAlignment="Center">
    <Button.Flyout>
        <Flyout Placement="Bottom"
                ShouldConstrainToRootBounds="True">
            <TextBlock Text="Flyout content" />
        </Flyout>
    </Button.Flyout>
</Button>

Comentarios

El valor predeterminado depende del tipo derivado. En Control flotante, el valor predeterminado es true. En MenuFlyout y CommandBarFlyout, el valor predeterminado es false.

Esta propiedad solo se aplica a las aplicaciones que se ejecutan en el escritorio. Para comprobar si el control flotante está restringido realmente a los límites raíz, compruebe la propiedad IsConstrainedToRootBounds .

En una aplicación que se ejecuta en el escritorio, cuando esta propiedad es true, el control flotante se muestra dentro del identificador de ventana XAML principal (HWND). Cuando esta propiedad es false, el control flotante se muestra en su propio HWND de nivel superior. En este caso, es posible que el control flotante se coloque para extenderse más allá de la ventana principal de la aplicación.

Cuando se muestra por primera vez un control flotante con ShouldConstrainToRootBounds = false , se coloca en su propia ventana y se muestra en ese contexto. Una vez que se ha mostrado, ShouldConstrainToRootBounds no se puede volver a establecer en true.

La raíz XAML puede ser CoreWindow, una isla XAML o appWindow.

Consulte también

• IsConstrainedToRootBounds
• ShouldConstrainToRootBounds