MenuItem Classe

Definição

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

public class MenuItem : System.Windows.Forms.Menu

[System.ComponentModel.Browsable(false)]
[System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class MenuItem : System.Windows.Forms.Menu

type MenuItem = class
    inherit Menu

[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`Menu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `ToolStripDropDown` and `ToolStripDropDownMenu` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type MenuItem = class
    inherit Menu

Public Class MenuItem
Inherits Menu

Herança

Object

MarshalByRefObject

Component

Menu

MenuItem

Atributos

BrowsableAttribute ObsoleteAttribute

Exemplos

O exemplo de código a seguir cria uma estrutura de menu para um formulário. O código de exemplo adiciona um MenuItem para representar o item de menu de nível superior, adiciona um item de submenu a ele para selecionar um tamanho de fonte e adiciona dois itens de submenu a esse item de menu que representam opções de fonte grandes e pequenas em um aplicativo. O exemplo requer que haja um MainMenu objeto nomeado mainMenu1 e quatro MenuItem objetos chamados menuItem1, menuItem2e menuItem3menuItem4.

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

Comentários

Essa classe não está disponível no .NET Core 3.1 e versões posteriores. Use ToolStripMenuItem em seu lugar.

Para que um MenuItem seja exibido, você deve adicioná-lo a um MainMenu ou ContextMenu. Para criar submenus, você 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 de menu. Para exibir uma marca de seleção ao lado de um item de menu, use a Checked propriedade. Você pode usar esse recurso para identificar um item de menu selecionado em uma lista de itens de menu mutuamente exclusivos. Por exemplo, se você tiver um conjunto de itens de menu para definir a cor do texto em um TextBox controle, poderá usar a Checked propriedade para identificar qual cor está selecionada no momento. A Shortcut propriedade pode ser usada para definir uma combinação de teclado que pode ser pressionada para selecionar o item de menu.

Para MenuItem objetos exibidos em um aplicativo MDI (Interface de Documentos Múltiplos), você pode usar o MergeMenu método para mesclar os menus de um pai MDI com o de seus formulários filho para criar uma estrutura de menu consolidada. Como não MenuItem é possível reutilização em vários locais ao mesmo tempo, como em um MainMenu e um ContextMenu, você pode usar o CloneMenu método para criar uma cópia de um MenuItem para uso em outro local.

O Popup evento permite que você execute tarefas antes que um menu seja exibido. Por exemplo, você pode criar um manipulador de eventos para esse evento para exibir ou ocultar itens de menu com base no estado do código. O Select evento permite que você execute tarefas como fornecer ajuda detalhada para os itens de menu do aplicativo quando o usuário coloca o ponteiro do mouse sobre um item de menu.

Confira também

• MainMenu
• Menu
• MenuMerge
• ContextMenu