FlyoutBase.ShouldConstrainToRootBounds 속성

정의

네임스페이스:

Windows.UI.Xaml.Controls.Primitives

플라이아웃이 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

속성 값

Boolean

bool

플라이 아웃이 XAML 루트의 범위 내에 표시되어야 하는 경우 true입니다. 그렇지 않으면 false입니다.

Windows 요구 사항

디바이스 패밀리	Windows 10, version 1903 (10.0.18362.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v8.0에서 도입되었습니다.)

예제

이 예제에서는 플라이아웃이 기본적으로 루트 범위로 제한되지 않습니다. 따라서 디스플레이에 플라이아웃을 위한 공간이 있는 한 단추 아래에 플라이아웃을 배치하라는 요청이 적용됩니다. 플라이아웃은 앱 창 외부에 표시됩니다.

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

이 예제에서는 ShouldConstrainToRootBounds 가 true로 설정되므로 플라이아웃이 루트 범위로 제한됩니다. 따라서 플라이아웃을 단추 아래에 배치하는 요청은 적용되지 않으며 플라이아웃은 단추 위의 앱 창 내에 표시됩니다.

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

설명

기본값은 파생 형식에 따라 달라집니다. Flyout의 경우 기본값은 입니다true. MenuFlyout 및 CommandBarFlyout의 경우 기본값은 입니다false.

이 속성은 데스크톱에서 실행되는 앱에만 적용됩니다. 플라이아웃이 실제로 루트 범위로 제한되는지 검사 위해 IsConstrainedToRootBounds 속성을 검사.

데스크톱에서 실행되는 앱에서 이 속성이 true이면 기본 XAML 창 핸들(HWND) 내에 플라이아웃이 표시됩니다. 이 속성이 false이면 플라이아웃이 자체 최상위 HWND에 표시됩니다. 이 경우 플라이아웃이 기본 앱 창 이상으로 확장되도록 배치될 수 있습니다.

와 함께 ShouldConstrainToRootBounds = false 플라이아웃이 처음 표시되면 자체 창에 배치되고 해당 컨텍스트에 표시됩니다. 표시된 ShouldConstrainToRootBounds 후에는 를 true로 다시 설정할 수 없습니다.

XAML 루트는 CoreWindow, XAML 아일랜드 또는 AppWindow일 수 있습니다.

추가 정보

• IsConstrainedToRootBounds
• ShouldConstrainToRootBounds