FlyoutBase.ShouldConstrainToRootBounds Propriedade

Definição

Namespace:

Windows.UI.Xaml.Controls.Primitives

Obtém ou define um valor que indica se o submenu deve ser mostrado dentro dos limites da raiz 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 da propriedade

Boolean

bool

true se o submenu deve ser mostrado dentro dos limites da raiz XAML; caso contrário, false.

Requisitos do Windows

Família de dispositivos	Windows 10, version 1903 (introduzida na 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v8.0)

Exemplos

Neste exemplo, o submenu não está restrito aos limites raiz por padrão. Portanto, a solicitação para colocar o submenu abaixo do botão é honrada, desde que haja espaço para ele no visor. O submenu é mostrado fora da janela do aplicativo.

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

Neste exemplo, ShouldConstrainToRootBounds é definido como true, portanto, o submenu é restrito aos limites raiz. Portanto, a solicitação para colocar o submenu abaixo do botão não é honrada e o submenu é mostrado dentro da janela do aplicativo acima do botão.

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

Comentários

O valor padrão depende do tipo derivado. Para o Submenu, o padrão é true. Para MenuFlyout e CommandBarFlyout, o padrão é false.

Essa propriedade é aplicável somente a aplicativos em execução na área de trabalho. Para marcar se o submenu for realmente restrito aos limites raiz, marcar a propriedade IsConstrainedToRootBounds.

Em um aplicativo em execução na área de trabalho, quando essa propriedade é verdadeira, o submenu é mostrado dentro do main identificador de janela XAML (HWND). Quando essa propriedade é falsa, o submenu é mostrado em seu próprio HWND de nível superior. Nesse caso, o submenu pode estar posicionado para se estender além da janela main aplicativo.

Quando um submenu com ShouldConstrainToRootBounds = false é mostrado pela primeira vez, ele é colocado em sua própria janela e mostrado nesse contexto. Depois que ele for mostrado, ShouldConstrainToRootBounds não poderá ser definido como true.

A raiz XAML pode ser um CoreWindow, uma ilha XAML ou um AppWindow.

Confira também

• IsConstrainedToRootBounds
• ShouldConstrainToRootBounds