UIElement.ContextFlyout Propriedade

Definição

Namespace:

Microsoft.UI.Xaml

Obtém ou define o submenu associado a esse elemento.

public:
 property FlyoutBase ^ ContextFlyout { FlyoutBase ^ get(); void set(FlyoutBase ^ value); };

FlyoutBase ContextFlyout();

void ContextFlyout(FlyoutBase value);

public FlyoutBase ContextFlyout { get; set; }

var flyoutBase = uIElement.contextFlyout;
uIElement.contextFlyout = flyoutBase;

Public Property ContextFlyout As FlyoutBase

Valor da propriedade

FlyoutBase

O submenu associado a esse elemento, se houver; caso contrário, null. O padrão é null.

Exemplos

Este exemplo mostra como anexar um menu de contexto com as opções Vermelho e Verde a um retângulo. O menu é mostrado quando o usuário clica com o botão direito do mouse ou executa uma ação equivalente.

<Page
    ...>
    <Page.Resources>
        <MenuFlyout x:Key="colorMenuFlyout">
            <MenuFlyoutItem Text="Red" Tag="red" Click="MenuFlyoutItem_Click"/>
            <MenuFlyoutItem Text="Green" Tag="green" Click="MenuFlyoutItem_Click"/>
        </MenuFlyout>
    </Page.Resources>

    <Grid>
        <Rectangle Width="100" Height="100" Fill="Yellow"
                   ContextFlyout="{StaticResource colorMenuFlyout}">
        </Rectangle>
    </Grid>
</Page>

private void MenuFlyoutItem_Click(object sender, RoutedEventArgs e)
{
    var colorMenuFlyout = Resources["colorMenuFlyout"] as MenuFlyout;
    var item = sender as MenuFlyoutItem;
    var target = colorMenuFlyout.Target;
    if (string.Equals(item.Tag.ToString(), "red"))
    {
        ((Rectangle)target).Fill = new SolidColorBrush(Windows.UI.Colors.Red);
    }
    else if (string.Equals(item.Tag.ToString(), "green"))
    {
        ((Rectangle)target).Fill = new SolidColorBrush(Windows.UI.Colors.Green);
    }
}

Comentários

Um menu de contexto é anexado a um único elemento e exibe comandos secundários. Ele é invocado clicando com o botão direito do mouse ou uma ação equivalente, como pressionar e segurar com o dedo.

Quando você define a ContextFlyout propriedade, o menu de contexto é mostrado e oculto automaticamente, o evento ContextRequested é marcado como manipulado. Você só deve manipular ContextRequested e ContextCanceled se não definir ContextFlyout.