Menu 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 a funcionalidade base para todos os menus.

Esta classe não está disponível no .NET Core 3.1 nem em versões posteriores. Como alternativa, use ToolStripDropDown e ToolStripDropDownMenu, pois eles substituem e estendem o controle Menu.

public ref class Menu abstract : System::ComponentModel::Component

[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component

[<System.ComponentModel.ListBindable(false)>]
type Menu = class
    inherit Component

Public MustInherit Class Menu
Inherits Component

Herança: Object

MarshalByRefObject

Component
Menu

Derivado: System.Windows.Forms.ContextMenu

System.Windows.Forms.MainMenu

System.Windows.Forms.MenuItem

Atributos: ListBindableAttribute

Exemplos

O exemplo de código a seguir usa a classe MenuItemderivada para criar 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 chamadosmenuItem1, 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. Em vez disso, use ToolStripDropDown e ToolStripDropDownMenu.

Essa classe é a classe base para o MainMenu, MenuIteme ContextMenu classes. Você não pode criar uma instância dessa classe. Os menus de um aplicativo consistem em MenuItem objetos. Eles podem conter outros MenuItem objetos, representando itens de submenu. Os MenuItem objetos podem ser armazenados em um MainMenu para exibição como uma estrutura de menu inteira para um formulário ou um ContextMenu que é usado para exibir menus de atalho. Essa classe fornece funcionalidades comuns para todas as classes de menu.

Ao contrário de muitas classes base, a Menu classe usa suas classes derivadas para definir muitas de suas propriedades. Se você estiver usando seu menu em um aplicativo MDI (interface de vários documentos), poderá usar a MdiListItem propriedade para especificar um MenuItem que exibe uma lista de formulários filho MDI abertos em seu aplicativo. A MenuItems propriedade contém uma lista de MenuItem objetos armazenados na classe de menu. Para um MainMenu ou ContextMenu, essa propriedade contém todos os MenuItem objetos que são exibidos. Para um MenuItem, a MenuItems propriedade representa os itens de submenu associados a ela.

Além das propriedades fornecidas para todas as classes de menu derivadas, a Menu classe também fornece métodos, como CloneMenu e MergeMenu, que permitem criar novos menus a partir de menus existentes, além de mesclar duas estruturas de menu.

A Menu classe também define a classe Menu.MenuItemCollectionaninhada. Essa classe define a coleção de MenuItem objetos usados pela MenuItems propriedade. Você pode usar os métodos da Menu.MenuItemCollection classe para adicionar e remover itens de menu de um MainMenu, ContextMenuou MenuItem.

Construtores

Menu(MenuItem[])

Inicializa uma nova instância da classe Menu.

Campos

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

Propriedades

CanRaiseEvents	Obtém um valor que indica se o componente pode acionar um evento. (Herdado de Component)
Container	Obtém o IContainer que contém o Component. (Herdado de Component)
DesignMode	Obtém um valor que indica se o Component está no modo de design no momento. (Herdado de Component)
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.
IsParent	Obtém um valor que indica se este menu contém algum item de menu. Esta propriedade é somente para leitura.
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).
MenuItems	Obtém um valor que indica a coleção de objetos MenuItem associados ao menu.
Name	Obtém ou define o nome 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.

Métodos

CloneMenu(Menu)	Copia o Menu que é passado como um parâmetro para o Menu atual.
CreateMenuHandle()	Cria um novo identificador para o 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 Menu.
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.
FindMergePosition(Int32)	Retorna a posição em que um item de menu deve ser inserido no menu.
GetContextMenu()	Obtém o ContextMenu que contém este 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.
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(Menu)	Mescla os objetos MenuItem de um menu com o menu atual.
ProcessCmdKey(Message, Keys)	Processa uma chave de comando.
ToString()	Retorna uma String que representa o controle Menu.

Eventos

Disposed

Ocorre quando o componente é disposto por uma chamada ao método Dispose().

(Herdado de Component)

Aplica-se a