UIElement.ContextFlyout Propriedade

Definição

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

C#
public FlyoutBase ContextFlyout { get; set; }

Valor da propriedade

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

Requisitos do Windows

Família de dispositivos
Windows 10 Anniversary Edition (introduzida na 10.0.14393.0)
API contract
Windows.Foundation.UniversalApiContract (introduzida na v3.0)

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.

Um menu de contexto mostrando as opções vermelho e verde
XAML
<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>
C#
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.

Aplica-se a

Produto Versões
WinRT Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100