Item de Menu

O MenuItem controlo representa itens selecionáveis individualmente dentro de um Menu ou ContextMenu. O MenuItem é o bloco fundamental dos sistemas de menus nas aplicações WPF, fornecendo os elementos interativos que os utilizadores clicam ou selecionam para executar ações.

Captura de ecrã que mostra um elemento de controlo de menu com múltiplos itens de menu.

Para exemplos sobre como usar menus, veja Menu: Exmaples.

A Menu serve como um recipiente para MenuItem objetos, estabelecendo uma relação pai-filho onde:

  • O controlo do Menu fornece a estrutura geral e o layout para organizar os itens do menu.
  • Cada MenuItem representa um comando, opção ou submenu específico dentro dessa estrutura.
  • MenuItens podem conter outros MenuItens enquanto filhos, criando submenus hierárquicos de profundidade ilimitada.
  • Os MenuItems herdam as propriedades de estilo e comportamento do seu Menu pai, a menos que sejam explicitamente substituídas.

Esta relação hierárquica permite-lhe criar estruturas de navegação complexas, desde menus simples e planos até sistemas de submenus profundamente aninhados.

Itens de Menu suportam vários tipos diferentes de comportamentos:

Itens de comando: MenuItens que executam comandos específicos quando clicados. Estes são normalmente usados para ações como Abrir Ficheiro > ou Editar > Cópia.

Itens marcáveis: MenuItens que podem ser ativados ou desativados, semelhantes a caixas de seleção. Defina a propriedade IsCheckable para true permitir este comportamento.

Itens separadores: Use Separator controlos dentro de um Menu para agrupar visualmente os MenuItems relacionados.

Itens do Submenu: MenuItens que contêm outros Itens do Menu quando crianças. Quando clicados ou passando o rato sobre, exibem um submenu com opções adicionais.

As principais propriedades do MenuItem incluem:

  • Header: O conteúdo apresentado no item do menu.
  • Command: O comando a executar quando o item é selecionado.
  • IsCheckable: Se o item pode ser verificado e desverificado.
  • IsChecked: O estado atual verificado de um item verificável.
  • InputGestureText: Texto que representa o atalho de teclado do item.
  • Icon: Um ícone para mostrar ao lado do texto do item do menu.

Eventos importantes incluem Click, Checked, e Unchecked.

Estilos e modelos

Podes modificar o padrão ControlTemplate para dar ao MenuItem controlo uma aparência única. Para mais informações, veja O que são estilos e modelos? e Como criar um modelo para um controlo.

Propriedade de conteúdo

Este controlo não define uma propriedade de conteúdo.

Partes

A tabela seguinte lista as partes nomeadas para o MenuItem controlo.

Parte Tipo Description
PART_Popup Popup O pop-up que contém os itens do submenu.

Quando cria um ControlTemplate para um MenuItem, o seu modelo pode conter um ItemsPresenter dentro de um ScrollViewer. O ItemsPresenter apresenta cada item no MenuItem; o ScrollViewer permite que se faça scroll dentro do controlo. Se o ItemsPresenter não for filho direto do ScrollViewer, deve atribuir o nome ItemsPresenter ao ItemsPresenter.

Estados visuais

A tabela seguinte lista os estados visuais do MenuItem controlo.

Nome VisualState Nome VisualStateGroup Description
Válido Estados de Validação O controlo é válido e não tem erros de validação.
FocadoInválido Estados de Validação O controlo apresenta um erro de validação e tem o foco do teclado.
InvalidUnfocused Estados de Validação O controlo tem um erro de validação mas não tem foco no teclado.

Consulte também

  • Last updated on