MenuItem Classe

Definição

public ref class MenuItem : System::Windows::Forms::Menu

public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Herança

Object

MarshalByRefObject

Component

Menu

MenuItem

Exemplos

O seguinte exemplo de código cria uma estrutura de menu para um formulário. O código de exemplo adiciona a MenuItem para representar o item do menu de topo, adiciona um elemento de submenu para selecionar o tamanho de uma fonte, e depois adiciona dois itens de submenu a esse item do menu que representam escolhas de fonte grandes e pequenas numa aplicação. O exemplo exige que exista um MainMenu objeto nomeado mainMenu1 e quatro MenuItem objetos nomeados menuItem1, menuItem2, menuItem3, e menuItem4.

public:
   void CreateMyMenu()
   {
      // Set the caption for the top-level menu item.
      menuItem1->Text = "Edit";
      // Set the caption for the first submenu.
      menuItem2->Text = "Font Size";
      // Set the caption for menuItem2's first submenu.
      menuItem3->Text = "Small";
      // Set the checked property to true since this is the default value.
      menuItem3->Checked = true;
      // Define a shortcut key combination for the menu item.
      menuItem3->Shortcut = Shortcut::CtrlS;
      // Set the caption of the second sub menu item of menuItem2.
      menuItem4->Text = "Large";
      // Define a shortcut key combination for the menu item.
      menuItem4->Shortcut = Shortcut::CtrlL;
      // Set the index of the menu item so it is placed below the first submenu item.
      menuItem4->Index = 1;
      // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
      menuItem2->MenuItems->Add( menuItem3 );
      menuItem2->MenuItems->Add( menuItem4 );
      // Add menuItem2 to menuItem1's list of menu items.
      menuItem1->MenuItems->Add( menuItem2 );
      // Add menuItem1 to the MainMenu for displaying.
      mainMenu1->MenuItems->Add( menuItem1 );
   }

public void CreateMyMenu()
    {
    // Set the caption for the top-level menu item.
    menuItem1.Text = "Edit";
    // Set the caption for the first submenu.
    menuItem2.Text = "Font Size";
    // Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small";
    // Set the checked property to true since this is the default value.
    menuItem3.Checked = true;
    // Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS;
    // Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large";
    // Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL;
    // Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1;
    // Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3);
    menuItem2.MenuItems.Add(menuItem4);
    // Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2);
    // Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1);
    }

Public Sub CreateMyMenu()
    ' Set the caption for the top-level menu item.
    menuItem1.Text = "Edit"
    ' Set the caption for the first submenu.
    menuItem2.Text = "Font Size"
    ' Set the caption for menuItem2's first submenu.
    menuItem3.Text = "Small"
    ' Set the checked property to true since this is the default value.
    menuItem3.Checked = True
    ' Define a shortcut key combination for the menu item.
    menuItem3.Shortcut = Shortcut.CtrlS
    ' Set the caption of the second sub menu item of menuItem2.
    menuItem4.Text = "Large"
    ' Define a shortcut key combination for the menu item.
    menuItem4.Shortcut = Shortcut.CtrlL
    ' Set the index of the menu item so it is placed below the first submenu item.
    menuItem4.Index = 1
    ' Add menuItem3 and menuItem4 to menuItem2's list of menu items.
    menuItem2.MenuItems.Add(menuItem3)
    menuItem2.MenuItems.Add(menuItem4)
    ' Add menuItem2 to menuItem1's list of menu items.
    menuItem1.MenuItems.Add(menuItem2)
    ' Add menuItem1 to the MainMenu for displaying.
    mainMenu1.MenuItems.Add(menuItem1)
End Sub

Observações

Esta classe não está disponível no .NET Core 3.1 e versões posteriores. Utilize ToolStripMenuItem em substituição.

Para que a MenuItem seja exibido, deve adicioná-lo a MainMenu ou ContextMenu. Para criar submenus, pode adicionar MenuItem objetos à MenuItems propriedade do pai MenuItem.

A MenuItem classe fornece propriedades que permitem configurar a aparência e a funcionalidade de um item do menu. Para mostrar uma marca de seleção ao lado de um item do menu, use a propriedade Checked . Pode usar esta funcionalidade para identificar um item do menu selecionado numa lista de itens de menu mutuamente exclusivos. Por exemplo, se tiver um conjunto de itens de menu para definir a cor do texto num TextBox controlo, pode usar a Checked propriedade para identificar qual a cor que está atualmente selecionada. A Shortcut propriedade pode ser usada para definir uma combinação de teclado que pode ser pressionada para selecionar o item do menu.

Para MenuItem objetos exibidos numa aplicação de Interface de Múltiplos Documentos (MDI), pode usar o MergeMenu método para fundir os menus de um pai MDI com os dos seus formulários filhos para criar uma estrutura de menus consolidada. Como a MenuItem não pode ser reutilizado em vários locais ao mesmo tempo, como em a MainMenu e a ContextMenu, pode usar o CloneMenu método para criar uma cópia de a MenuItem para uso noutro local.

O Popup evento permite-lhe realizar tarefas antes de um menu ser exibido. Por exemplo, pode criar um gestor de eventos para este evento para mostrar ou ocultar itens do menu com base no estado do seu código. O Select evento permite-lhe realizar tarefas como fornecer ajuda detalhada aos itens do menu da sua aplicação quando o utilizador coloca o ponteiro do rato sobre um item do menu.

Ver também

• MainMenu
• Menu
• MenuMerge
• ContextMenu