Menu Classe

Definição

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 seguinte exemplo de código utiliza a classe derivada, MenuItem, para criar 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. Use ToolStripDropDown e ToolStripDropDownMenu em vez disso.

Esta classe é a classe base para as MainMenuclasses, MenuItem, e ContextMenu . Não podes criar uma instância desta classe. Os menus de uma aplicação consistem em MenuItem objetos. Estes podem conter outros MenuItem objetos, representando itens do submenu. Os MenuItem objetos podem ser armazenados MainMenu num para exibição como uma estrutura completa de menu para um formulário ou ContextMenu um que é usado para mostrar menus de atalho. Esta classe fornece funcionalidades comuns a todas as classes de menu.

Ao contrário de muitas classes base, a Menu classe utiliza as suas classes derivadas para definir muitas das suas propriedades. Se estiver a usar o seu menu numa aplicação de interface de múltiplos documentos (MDI), pode usar a MdiListItem propriedade para especificar a MenuItem que exibe uma lista de formulários filhos MDI abertos na sua aplicação. A MenuItems propriedade contém uma lista de MenuItem objetos armazenados na classe menu. Para um MainMenu ou ContextMenu, esta propriedade contém todos os MenuItem objetos que são exibidos. Para um MenuItem, a MenuItems propriedade representa os itens do submenu associados a ela.

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

A Menu classe também define a classe Menu.MenuItemCollectionaninhada . Esta classe define a coleção de MenuItem objetos usados pela MenuItems propriedade. Podes usar os métodos da Menu.MenuItemCollection classe para adicionar e remover itens do menu de um MainMenu, ContextMenu, ou MenuItem.

Ver também

• MainMenu
• ContextMenu
• MenuItem