Visão geral de ContextMenu

A ContextMenu classe representa o elemento que expõe a funcionalidade usando um contexto específico .Menu Normalmente, um usuário expõe o ContextMenu na interface do usuário (UI) clicando com o botão direito do mouse. Este tópico apresenta o ContextMenu elemento e fornece exemplos de como usá-lo em XAML (Extensible Application Markup Language) e código.

Controle ContextMenu

A ContextMenu é anexado a um controle específico. O ContextMenu elemento permite que você apresente aos usuários uma lista de itens que especificam comandos ou opções associados a um controle específico, por exemplo, um Buttonarquivo . Os usuários clicam com o botão direito do mouse no controle para exibir o menu. Normalmente, clicar em um abre um submenu ou faz com que um aplicativo execute um MenuItem comando.

Criando ContextMenus

Os exemplos a seguir mostram como criar um ContextMenu com submenus. Os ContextMenu controles são anexados a controles de botão.

<Button Name="cmButton" Height="30">
  Button with Context Menu
  <Button.ContextMenu>
    <ContextMenu Name="cm" Opened="OnOpened" Closed="OnClosed" StaysOpen="true">
      <MenuItem Header="File"/>
      <MenuItem Header="Save"/>
      <MenuItem Header="SaveAs"/>
      <MenuItem Header="Recent Files">
        <MenuItem Header="ReadMe.txt"/>
        <MenuItem Header="Schedule.xls"/>
      </MenuItem>
    </ContextMenu>
  </Button.ContextMenu>
</Button>
btn = new Button();
btn.Content = "Created with C#";
contextmenu = new ContextMenu();
btn.ContextMenu = contextmenu;
mi = new MenuItem();
mi.Header = "File";
mia = new MenuItem();
mia.Header = "New";
mi.Items.Add(mia);
mib = new MenuItem();
mib.Header = "Open";
mi.Items.Add(mib);
mib1 = new MenuItem();
mib1.Header = "Recently Opened";
mib.Items.Add(mib1);
mib1a = new MenuItem();
mib1a.Header = "Text.xaml";
mib1.Items.Add(mib1a);
contextmenu.Items.Add(mi);
cv2.Children.Add(btn);
Dim btn As New Button()
Dim contextmenu As New ContextMenu()
Dim mi As New MenuItem()
Dim mia As New MenuItem()

btn.Background = Brushes.Red
btn.Height = 30
btn.Content = "Created with Visual Basic."

mi.Header = ("Item 1")
contextmenu.Items.Add(mi)
mia.Header = ("Item 2")
contextmenu.Items.Add(mia)

btn.ContextMenu = (contextmenu)
cv2.Children.Add(btn)

Aplicando estilos a um ContextMenu

Usando um controle , você pode alterar drasticamente a aparência e o comportamento de um sem escrever um ContextMenu controle Stylepersonalizado. Além de definir propriedades visuais, você também pode aplicar estilos a partes de um controle. Por exemplo, você pode alterar o comportamento de partes do controle usando propriedades ou pode adicionar partes ou alterar o layout de um ContextMenu. Os exemplos a seguir mostram várias maneiras de adicionar estilos a ContextMenu controles.

O primeiro exemplo define um estilo chamado SimpleSysResources, que mostra como usar as configurações atuais do sistema no seu estilo. O exemplo atribui MenuHighlightBrushKey como a cor e MenuTextBrushKey como a BackgroundForeground cor do ContextMenu.

<Style x:Key="SimpleSysResources" TargetType="{x:Type MenuItem}">  
  <Setter Property = "Background" Value=
    "{DynamicResource {x:Static SystemColors.MenuHighlightBrushKey}}"/>  
  <Setter Property = "Foreground" Value=
    "{DynamicResource {x:Static SystemColors.MenuTextBrushKey}}"/>  
</Style>  

O exemplo a seguir usa o elemento para alterar a aparência de um Menu em resposta a Trigger eventos gerados no ContextMenu. Quando um usuário move o mouse sobre o menu, a aparência dos ContextMenu itens muda.

<Style x:Key="Triggers" TargetType="{x:Type MenuItem}">  
  <Style.Triggers>  
    <Trigger Property="MenuItem.IsMouseOver" Value="true">  
      <Setter Property = "FontSize" Value="16"/>  
      <Setter Property = "FontStyle" Value="Italic"/>  
      <Setter Property = "Foreground" Value="Red"/>  
    </Trigger>  
  </Style.Triggers>  
</Style>  

Confira também