FlyoutBase.ShouldConstrainToRootBounds Eigenschaft

Definition

Namespace:

Windows.UI.Xaml.Controls.Primitives

Ruft einen Wert ab, der angibt, ob das Flyout innerhalb der Grenzen des XAML-Stamms angezeigt werden soll, oder legt diesen fest.

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

Eigenschaftswert

Boolean

bool

true , wenn das Flyout innerhalb der Grenzen des XAML-Stamms angezeigt werden soll; Andernfalls false.

Windows-Anforderungen

Gerätefamilie	Windows 10, version 1903 (eingeführt in 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v8.0)

Beispiele

In diesem Beispiel ist das Flyout standardmäßig nicht auf die Stammgrenzen beschränkt. Daher wird die Anforderung, das Flyout unterhalb der Schaltfläche zu platzieren, berücksichtigt, solange auf dem Display Platz dafür ist. Das Flyout wird außerhalb des App-Fensters angezeigt.

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

In diesem Beispiel ist ShouldConstrainToRootBounds auf true festgelegt, sodass das Flyout auf die Stammgrenzen beschränkt ist. Daher wird die Anforderung, das Flyout unterhalb der Schaltfläche zu platzieren, nicht berücksichtigt, und das Flyout wird im App-Fenster über der Schaltfläche angezeigt.

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

Hinweise

Der Standardwert hängt vom abgeleiteten Typ ab. Für Flyout ist trueder Standardwert . Für MenuFlyout und CommandBarFlyout ist falseder Standardwert .

Diese Eigenschaft gilt nur für Apps, die auf dem Desktop ausgeführt werden. Um zu überprüfen, ob das Flyout tatsächlich auf die Stammgrenzen beschränkt ist, überprüfen Sie die IsConstrainedToRootBounds-Eigenschaft .

Wenn diese Eigenschaft in einer auf dem Desktop ausgeführten App true ist, wird das Flyout im Standard XAML-Fensterhandle (HWND) angezeigt. Wenn diese Eigenschaft false ist, wird das Flyout in seinem eigenen HWND der obersten Ebene angezeigt. In diesem Fall kann das Flyout so positioniert sein, dass es über das Standard App-Fenster hinausgeht.

Wenn ein Flyout mit ShouldConstrainToRootBounds = false zum ersten Mal angezeigt wird, wird es in einem eigenen Fenster platziert und in diesem Kontext angezeigt. Nachdem es angezeigt wurde, ShouldConstrainToRootBounds kann nicht auf true zurückgesetzt werden.

Der XAML-Stamm kann ein CoreWindow, eine XAML-Insel oder ein AppWindow sein.

Weitere Informationen

• IsConstrainedToRootBounds
• ShouldConstrainToRootBounds