UIElement.ContextFlyout Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Xaml

Ottiene o imposta il riquadro a comparsa associato a questo 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

Valore della proprietà

FlyoutBase

Riquadro a comparsa associato a questo elemento, se presente; in caso contrario, null. Il valore predefinito è null.

Esempio

In questo esempio viene illustrato come collegare un menu di scelta rapida con le opzioni Rosso e Verde a un rettangolo. Il menu viene visualizzato quando l'utente fa clic con il pulsante destro del mouse o esegue un'azione 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);
    }
}

Commenti

Un menu di scelta rapida è associato a un singolo elemento e visualizza i comandi secondari. Viene richiamato facendo clic con il pulsante destro del mouse o un'azione equivalente, ad esempio premendo e tenendo premuto con il dito.

Quando si imposta la ContextFlyout proprietà, il menu di scelta rapida viene visualizzato e nascosto automaticamente, l'evento ContextRequested viene contrassegnato come gestito. È consigliabile gestire ContextRequested e ContextCanceled se non si imposta ContextFlyout.