FlyoutBase.ShouldConstrainToRootBounds Propriété

Définition

Espace de noms:

Windows.UI.Xaml.Controls.Primitives

Obtient ou définit une valeur qui indique si le menu volant doit être affiché dans les limites de la racine 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

Valeur de propriété

Boolean

bool

true si le menu volant doit être affiché dans les limites de la racine XAML ; sinon, false.

Configuration requise pour Windows

Famille d’appareils	Windows 10, version 1903 (introduit dans 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v8.0)

Exemples

Dans cet exemple, le menu volant n’est pas limité aux limites racines par défaut. Par conséquent, la demande de placer le menu volant sous le bouton est honorée tant qu’il y a de la place pour celui-ci sur l’écran. Le menu volant s’affiche en dehors de la fenêtre de l’application.

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

Dans cet exemple, ShouldConstrainToRootBounds a la valeur true, de sorte que le menu volant est limité aux limites racines. Par conséquent, la demande de placer le menu volant sous le bouton n’est pas respectée et le menu volant s’affiche à l’intérieur de la fenêtre de l’application au-dessus du bouton.

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

Remarques

La valeur par défaut dépend du type dérivé. Pour Flyout, la valeur par défaut est true. Pour MenuFlyout et CommandBarFlyout, la valeur par défaut est false.

Cette propriété s’applique uniquement aux applications qui s’exécutent sur le bureau. Pour case activée si le menu volant est réellement limité aux limites racines, case activée la propriété IsConstrainedToRootBounds.

Dans une application s’exécutant sur le bureau, lorsque cette propriété a la valeur true, le menu volant s’affiche dans le main handle de fenêtre XAML (HWND). Lorsque cette propriété a la valeur false, le menu volant s’affiche dans son propre HWND de niveau supérieur. Dans ce cas, le menu volant peut être positionné pour s’étendre au-delà de la fenêtre main’application.

Lorsqu’un menu volant avec ShouldConstrainToRootBounds = false est affiché pour la première fois, il est placé dans sa propre fenêtre et affiché dans ce contexte. Une fois qu’elle a été affichée, ShouldConstrainToRootBounds ne peut pas être définie sur true.

La racine XAML peut être un CoreWindow, un îlot XAML ou un AppWindow.

Voir aussi

• IsConstrainedToRootBounds
• ShouldConstrainToRootBounds