MenuItem Classe

Referência

Definição

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa um item individual que é exibido dentro de um MainMenu ou ContextMenu.

Esta classe não está disponível no .NET Core 3.1 nem em versões posteriores. Use ToolStripMenuItem , em vez disso, que substitui o MenuItem controle .

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 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 chamado mainMenu1 e quatro MenuItem objetos chamados menuItem1, menuItem2, menuItem3e 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

Comentários

Esta classe não está disponível no .NET Core 3.1 nem em 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 marcar 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 Documento Múltiplo), você pode usar o MergeMenu método para mesclar os menus de um pai MDI para com o de seus formulários filho para criar uma estrutura de menu consolidada. Como um MenuItem não pode ser reutilizado 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.

Construtores

MenuItem()	Inicializa um MenuItem com uma legenda em branco.
MenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])	Inicializa uma nova instância da classe MenuItem com uma legenda especificada; manipuladores de eventos definidos para os eventos Click, Select e Popup; uma tecla de atalho; um tipo de mesclagem e, por fim, a ordem especificada para o item de menu.
MenuItem(String)	Inicializa uma nova instância da classe MenuItem com uma legenda especificada para o item de menu.
MenuItem(String, EventHandler)	Inicializa uma nova instância da classe com uma legenda e um manipulador de eventos especificados para o evento Click do item de menu.
MenuItem(String, EventHandler, Shortcut)	Inicializa uma nova instância da classe com uma legenda, um manipulador de eventos e a tecla de atalho associada especificados para o item de menu.
MenuItem(String, MenuItem[])	Inicializa uma nova instância da classe com uma legenda especificada e uma matriz de itens de submenu definida para o item de menu.

Campos

FindHandle	Especifica que o método FindMenuItem(Int32, IntPtr) deve pesquisar por um identificador. (Herdado de Menu)
FindShortcut	Especifica que o método FindMenuItem(Int32, IntPtr) deve pesquisar por um atalho. (Herdado de Menu)

Propriedades

BarBreak	Obtém ou define um valor que indica se o MenuItem é colocado em uma nova linha (de um item de menu adicionado a um objeto MainMenu) ou em uma nova coluna (para um item de submenu ou item de menu exibido em um ContextMenu).
Break	Obtém ou define um valor que indica se o item é colocado em uma nova linha (de um item de menu adicionado a um objeto MainMenu) ou em uma nova coluna (para um item de menu ou item de submenu exibido em um ContextMenu).
CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
Checked	Obtém ou define um valor que indica se uma marca de seleção aparece ao lado do texto do item de menu.
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
DefaultItem	Obtém ou define um valor que indica se o item de menu é o item de menu padrão.
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
Enabled	Obtém ou define um valor que indica se o item de menu está habilitado.
Events	Obtém a lista de manipuladores de eventos que estão anexados a este Component. (Herdado de Component)
Handle	Obtém um valor que representa o identificador de janela do menu. (Herdado de Menu)
Index	Obtém ou define um valor que indica a posição do item de menu em seu menu pai.
IsParent	Obtém um valor que indica se o item de menu contém itens de menu filho.
MdiList	Obtém ou define um valor que indica se o item de menu será populado com uma lista das janelas filho de MDI (interface de documentos múltiplos) que são exibidas no formulário associado.
MdiListItem	Obtém um valor que indica o MenuItem usado para exibir uma lista de formulários filho da interface MDI (interface de vários documentos). (Herdado de Menu)
MenuID	Obtém um valor que indica o identificador do Windows para este item de menu.
MenuItems	Obtém um valor que indica a coleção de objetos MenuItem associados ao menu. (Herdado de Menu)
MergeOrder	Obtém ou define um valor que indica a posição relativa do item de menu quando ele é mesclado com outro.
MergeType	Obtém ou define um valor que indica o comportamento do item de menu quando o menu é mesclado com outro.
Mnemonic	Obtém um valor que indica o caractere mnemônico associado a esse item de menu.
Name	Obtém ou define o nome de Menu. (Herdado de Menu)
OwnerDraw	Obtém ou define um valor que indica se o código fornecido por você desenha o item de menu ou se o Windows desenha o item de menu.
Parent	Obtém um valor que indica o menu que contém esse item de menu.
RadioCheck	Obtém ou define um valor que indica se o MenuItem, quando marcado, exibe um botão de opção em vez de uma marca de seleção.
Shortcut	Obtém ou define um valor que indica a tecla de atalho associada ao item de menu.
ShowShortcut	Obtém ou define um valor que indica se a tecla de atalho associada ao item de menu é exibida ao lado da legenda do item de menu.
Site	Obtém ou define o ISite do Component. (Herdado de Component)
Tag	Obtém ou define dados definidos pelo usuário associados ao controle. (Herdado de Menu)
Text	Obtém ou define um valor que indica a legenda do item de menu.
Visible	Obtém ou define um valor que indica se o item de menu está visível.

Métodos

CloneMenu()	Cria uma cópia das MenuItem atuais.
CloneMenu(Menu)	Copia o Menu que é passado como um parâmetro para o Menu atual. (Herdado de Menu)
CloneMenu(MenuItem)	Cria uma cópia do MenuItem especificado.
CreateMenuHandle()	Cria um novo identificador para o Menu. (Herdado de Menu)
CreateObjRef(Type)	Cria um objeto que contém todas as informações relevantes necessárias para gerar um proxy usado para se comunicar com um objeto remoto. (Herdado de MarshalByRefObject)
Dispose()	Libera todos os recursos usados pelo Component. (Herdado de Component)
Dispose(Boolean)	Descarta os recursos (exceto a memória) usados pelo MenuItem.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FindMenuItem(Int32, IntPtr)	Obtém o MenuItem que contém o valor especificado. (Herdado de Menu)
FindMergePosition(Int32)	Retorna a posição em que um item de menu deve ser inserido no menu. (Herdado de Menu)
GetContextMenu()	Obtém o ContextMenu que contém este menu. (Herdado de Menu)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetLifetimeService()	Obsoleto. Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância. (Herdado de MarshalByRefObject)
GetMainMenu()	Obtém o MainMenu que contém este menu. (Herdado de Menu)
GetService(Type)	Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
InitializeLifetimeService()	Obsoleto. Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância. (Herdado de MarshalByRefObject)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
MemberwiseClone(Boolean)	Cria uma cópia superficial do objeto MarshalByRefObject atual. (Herdado de MarshalByRefObject)
MergeMenu()	Mescla este MenuItem com outro MenuItem e retorna o MenuItem mesclado resultante.
MergeMenu(Menu)	Mescla os objetos MenuItem de um menu com o menu atual. (Herdado de Menu)
MergeMenu(MenuItem)	Mescla a outro item de menu com este item de menu.
OnClick(EventArgs)	Aciona o evento Click.
OnDrawItem(DrawItemEventArgs)	Aciona o evento DrawItem.
OnInitMenuPopup(EventArgs)	Aciona o evento Popup.
OnMeasureItem(MeasureItemEventArgs)	Aciona o evento MeasureItem.
OnPopup(EventArgs)	Aciona o evento Popup.
OnSelect(EventArgs)	Aciona o evento Select.
PerformClick()	Gera um evento Click para o MenuItem, que simula um clique de um usuário.
PerformSelect()	Aciona o evento Select deste item de menu.
ProcessCmdKey(Message, Keys)	Processa uma chave de comando. (Herdado de Menu)
ToString()	Retorna uma cadeia de caracteres que representa o MenuItem.

Eventos

Click	Ocorre ao clicar ou selecionar o item de menu usando uma tecla de atalho ou tecla de acesso definida para o item de menu.
Disposed	Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)
DrawItem	Ocorre quando a propriedade OwnerDraw de um item de menu é definida como `true` e é feita uma solicitação para desenhar o item de menu.
MeasureItem	Ocorre quando o menu precisa saber o tamanho de um item de menu antes de desenhá-lo.
Popup	Ocorre antes que a lista do item de menu seja exibida.
Select	Ocorre quando o usuário coloca o ponteiro sobre um item de menu.

Aplica-se a

Compartilhar via