Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe MenuItem

 

Representa um item individual que é exibido dentro de um MainMenu ou ContextMenu. Embora ToolStripMenuItem substitui e adiciona a funcionalidade de MenuItem controle de versões anteriores, MenuItem é mantido para compatibilidade com versões anteriores e uso futuro, se você escolher.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.Menu
        System.Windows.Forms.MenuItem

public class MenuItem : Menu

NomeDescrição
System_CAPS_pubmethodMenuItem()

Inicializa uma MenuItem com uma legenda em branco.

System_CAPS_pubmethodMenuItem(MenuMerge, Int32, Shortcut, String, EventHandler, EventHandler, EventHandler, MenuItem[])

Inicializa uma nova instância do MenuItem classe com uma legenda especificada; manipuladores de eventos definidos para o Click, Select e Popup eventos; uma tecla de atalho de um tipo de mesclagem; e ordem especificada para o item de menu.

System_CAPS_pubmethodMenuItem(String)

Inicializa uma nova instância de MenuItem classe com uma legenda especificada para o item de menu.

System_CAPS_pubmethodMenuItem(String, EventHandler)

Inicializa uma nova instância da classe com um manipulador de evento e a legenda especificado para o Click eventos do item de menu.

System_CAPS_pubmethodMenuItem(String, EventHandler, Shortcut)

Inicializa uma nova instância da classe com uma legenda especificada, o manipulador de eventos e a tecla de atalho associadas para o item de menu.

System_CAPS_pubmethodMenuItem(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.

NomeDescrição
System_CAPS_pubpropertyBarBreak

Obtém ou define um valor que indica se o MenuItem é colocado em uma nova linha (para um item de menu adicionado a um MainMenu objeto) ou em uma nova coluna (para um item de submenu ou item de menu exibido em um ContextMenu).

System_CAPS_pubpropertyBreak

Obtém ou define um valor que indica se o item é colocado em uma nova linha (para um item de menu é adicionado a um MainMenu objeto) ou em uma nova coluna (para um item de menu ou item de submenu exibido em um ContextMenu).

System_CAPS_protpropertyCanRaiseEvents

Obtém um valor indicando se o componente pode disparar um evento.(Herdado de Component.)

System_CAPS_pubpropertyChecked

Obtém ou define um valor que indica se uma marca de seleção aparece ao lado do texto do item de menu.

System_CAPS_pubpropertyContainer

Obtém o IContainer que contém o Component.(Herdado de Component.)

System_CAPS_pubpropertyDefaultItem

Obtém ou define um valor que indica se o item de menu é o item de menu padrão.

System_CAPS_protpropertyDesignMode

Obtém um valor que indica se o Component está atualmente no modo de design.(Herdado de Component.)

System_CAPS_pubpropertyEnabled

Obtém ou define um valor que indica se o item de menu está habilitado.

System_CAPS_protpropertyEvents

Obtém a lista de manipuladores de eventos que estão anexados a este Component.(Herdado de Component.)

System_CAPS_pubpropertyHandle

Obtém um valor que representa o identificador de janela para o menu.(Herdado de Menu.)

System_CAPS_pubpropertyIndex

Obtém ou define um valor que indica a posição do item de menu no menu de seu pai.

System_CAPS_pubpropertyIsParent

Obtém um valor que indica se o item de menu contém itens de menu filho.(Substitui o Menu.IsParent.)

System_CAPS_pubpropertyMdiList

Obtém ou define um valor que indica se o item de menu será preenchido com uma lista das janelas filho de Interface de documentos múltiplos (MDI) que são exibidos no formulário associado.

System_CAPS_pubpropertyMdiListItem

Obtém um valor que indica o MenuItem que é usado para exibir uma lista de várias formas de filho MDI (interface) de documento.(Herdado de Menu.)

System_CAPS_protpropertyMenuID

Obtém um valor que indica o identificador do Windows para este item de menu.

System_CAPS_pubpropertyMenuItems

Obtém um valor que indica a coleção de MenuItem objetos associados no menu.(Herdado de Menu.)

System_CAPS_pubpropertyMergeOrder

Obtém ou define um valor que indica a posição relativa do item de menu quando ele é mesclado com outro.

System_CAPS_pubpropertyMergeType

Obtém ou define um valor que indica o comportamento do item de menu ao menu é mesclado com outro.

System_CAPS_pubpropertyMnemonic

Obtém um valor que indica o caractere mnemônico associada este item de menu.

System_CAPS_pubpropertyName

Obtém ou define o nome de Menu.(Herdado de Menu.)

System_CAPS_pubpropertyOwnerDraw

Obtém ou define um valor que indica se o código que você fornecer desenha o item de menu ou Windows desenha o item de menu.

System_CAPS_pubpropertyParent

Obtém um valor que indica o menu que contém esse item de menu.

System_CAPS_pubpropertyRadioCheck

Obtém ou define um valor que indica se o MenuItem, se selecionada, exibe um botão de opção em vez de uma marca de seleção.

System_CAPS_pubpropertyShortcut

Obtém ou define um valor que indica a tecla de atalho associada ao item de menu.

System_CAPS_pubpropertyShowShortcut

Obtém ou define um valor que indica se a tecla de atalho que é associada ao item de menu é exibida ao lado da legenda do item de menu.

System_CAPS_pubpropertySite

Obtém ou define o ISite do Component.(Herdado de Component.)

System_CAPS_pubpropertyTag

Obtém ou define dados definidos pelo usuário associados ao controle.(Herdado de Menu.)

System_CAPS_pubpropertyText

Obtém ou define um valor que indica a legenda do item de menu.

System_CAPS_pubpropertyVisible

Obtém ou define um valor que indica se o item de menu está visível.

NomeDescrição
System_CAPS_pubmethodCloneMenu()

Cria uma cópia do atual MenuItem.

System_CAPS_protmethodCloneMenu(Menu)

Copia o Menu que é passado como um parâmetro para o atual Menu.(Herdado de Menu.)

System_CAPS_protmethodCloneMenu(MenuItem)

Cria uma cópia do especificado MenuItem.

System_CAPS_protmethodCreateMenuHandle()

Cria um novo identificador para o Menu.(Herdado de Menu.)

System_CAPS_pubmethodCreateObjRef(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.)

System_CAPS_pubmethodDispose()

Libera todos os recursos usados pelo Component.(Herdado de Component.)

System_CAPS_protmethodDispose(Boolean)

Libera os recursos (diferente de memória) usados pelo MenuItem.(Substitui o Menu.Dispose(Boolean).)

System_CAPS_pubmethodEquals(Object)

Verifica se o objeto especificado é igual ao objeto atual. (Herdado de Object.)

System_CAPS_protmethodFinalize()

Libera recursos não gerenciados e executa outras operações de limpeza antes que Component seja recuperado pela coleta de lixo.(Herdado de Component.)

System_CAPS_pubmethodFindMenuItem(Int32, IntPtr)

Obtém o MenuItem que contém o valor especificado.(Herdado de Menu.)

System_CAPS_protmethodFindMergePosition(Int32)

Retorna a posição na qual um item de menu deve ser inserido no menu.(Herdado de Menu.)

System_CAPS_pubmethodGetContextMenu()

Obtém o ContextMenu que contém esse menu.(Herdado de Menu.)

System_CAPS_pubmethodGetHashCode()

Serve como a função de hash padrão.(Herdado de Object.)

System_CAPS_pubmethodGetLifetimeService()

Recupera o objeto atual de serviço de vida útil que controla a diretiva de vida útil para esta instância. (Herdado de MarshalByRefObject.)

System_CAPS_pubmethodGetMainMenu()

Obtém o MainMenu que contém esse menu.(Herdado de Menu.)

System_CAPS_protmethodGetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.(Herdado de Component.)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_pubmethodInitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a diretiva de vida útil para esta instância. (Herdado de MarshalByRefObject.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_protmethodMemberwiseClone(Boolean)

Cria uma cópia superficial do atual MarshalByRefObject objeto.(Herdado de MarshalByRefObject.)

System_CAPS_pubmethodMergeMenu()

Mescla este MenuItem com outro MenuItem e retorna a resultante mesclada MenuItem.

System_CAPS_pubmethodMergeMenu(Menu)

Mescla o MenuItem objetos de um menu com o menu atual.(Herdado de Menu.)

System_CAPS_pubmethodMergeMenu(MenuItem)

Mescla outro item de menu com esse item de menu.

System_CAPS_protmethodOnClick(EventArgs)

Aciona o evento Click.

System_CAPS_protmethodOnDrawItem(DrawItemEventArgs)

Gera o DrawItem evento.

System_CAPS_protmethodOnInitMenuPopup(EventArgs)

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Gera o Popup evento.

System_CAPS_protmethodOnMeasureItem(MeasureItemEventArgs)

Gera o MeasureItem evento.

System_CAPS_protmethodOnPopup(EventArgs)

Gera o Popup evento.

System_CAPS_protmethodOnSelect(EventArgs)

Gera o Select evento.

System_CAPS_pubmethodPerformClick()

Gera um Click eventos para o MenuItem, simular um clique de um usuário.

System_CAPS_pubmethodPerformSelect()

Gera o Select evento para este item de menu.

System_CAPS_protmethodProcessCmdKey(Message, Keys)

Processa uma chave de comando.(Herdado de Menu.)

System_CAPS_pubmethodToString()

Esta API dá suporte à infraestrutura produto e não se destina a ser usada diretamente do seu código. Retorna uma cadeia de caracteres que representa o MenuItem.(Substitui o Menu.ToString().)

NomeDescrição
System_CAPS_pubeventClick

Ocorre ao clicar ou selecionar o item de menu usando uma tecla de atalho ou tecla de acesso definida para o item de menu.

System_CAPS_pubeventDisposed

Ocorre quando o componente é disposto por uma chamada para o Dispose método.(Herdado de Component.)

System_CAPS_pubeventDrawItem

Ocorre quando o OwnerDraw propriedade de um item de menu é definida como true e é feita uma solicitação para desenhar o item de menu.

System_CAPS_pubeventMeasureItem

Ocorre quando o menu precisa saber o tamanho de um item de menu antes de desenhá-lo.

System_CAPS_pubeventPopup

Ocorre antes da exibição da lista de um item de menu de itens de menu.

System_CAPS_pubeventSelect

Ocorre quando o usuário coloca o ponteiro sobre um item de menu.

Para que um MenuItem para ser exibido, você deve adicioná-lo para um MainMenu ou ContextMenu. Para criar submenus, você pode adicionar MenuItem objetos para o MenuItems propriedade do pai MenuItem.

O MenuItem classe fornece propriedades que permitem que você configure 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 o Checked propriedade. Você pode usar esse recurso para identificar um item de menu é selecionado em uma lista de itens de menu mutuamente exclusivas. Por exemplo, se você tiver um conjunto de itens de menu para definir a cor do texto em uma TextBox controle, você pode usar o Checked propriedade para identificar qual cor está selecionado no momento. O 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 de Interface de documentos múltiplos (MDI), você pode usar o MergeMenu método para mesclar os menus de um MDI pai para que seus formulários filho para criar uma estrutura de menu consolidado. Porque 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 de um menu é exibido. Por exemplo, você pode criar um manipulador de eventos para esse evento exibir ou ocultar itens de menu com base no estado do seu código. O Select evento permite que você execute tarefas como fornecer ajuda detalhada para itens de menu do aplicativo quando o usuário coloca o ponteiro do mouse sobre um item de menu.

O exemplo de código a seguir cria uma estrutura de menu para um formulário. O exemplo de código adiciona um MenuItem para representar o item de menu de nível superior, adiciona um item de submenu para selecionar um tamanho de fonte e, em seguida, adiciona dois itens de submenu para esse item de menu que representam as opções de fonte pequeno e grande em um aplicativo. O exemplo requer que haja um MainMenu objeto chamado 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);
    }

.NET Framework
Disponível desde 1.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: