Menu Menu Menu Menu Class

Definição

Representa a funcionalidade base para todos os menus.Represents the base functionality for all menus. Embora ToolStripDropDown e ToolStripDropDownMenu substituam e adicionem funcionalidade ao controle Menu de versões anteriores, o Menu é mantido para compatibilidade com versões anteriores e uso futuro, se desejado.Although ToolStripDropDown and ToolStripDropDownMenu replace and add functionality to the Menu control of previous versions, Menu is retained for both backward compatibility and future use if you choose.

public ref class Menu abstract : System::ComponentModel::Component
[System.ComponentModel.ListBindable(false)]
public abstract class Menu : System.ComponentModel.Component
type Menu = class
    inherit Component
Public MustInherit Class Menu
Inherits Component
Herança
Derivado
Atributos

Exemplos

O exemplo de código a seguir usa a classe MenuItemderivada,, para criar uma estrutura de menu para um formulário.The following code example uses the derived class, MenuItem, to create a menu structure for a form. O código de exemplo adiciona MenuItem um para representar o item de menu de nível superior, adiciona um item de submenu a ele para selecionar um tamanho de fonte e, em seguida, adiciona dois itens de submenu a esse item de menu que representam opções de fonte grandes e pequenas em um aplicativo.The example code adds a MenuItem to represent the top-level menu item, adds a submenu item to it for selecting a font size, and then adds two submenu items to that menu item that represent large and small font choices in an application. O exemplo requer que haja um MainMenu objeto chamado mainMenu1 e quatro MenuItem objetos chamados menuItem1, menuItem2, menuItem3e menuItem4.The example requires that there is a MainMenu object named mainMenu1 and four MenuItem objects named menuItem1, menuItem2, menuItem3, and 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

Essa classe é a classe base para as MainMenuclasses MenuItem, e ContextMenu .This class is the base class for the MainMenu, MenuItem, and ContextMenu classes. Você não pode criar uma instância dessa classe.You cannot create an instance of this class. Os menus de um aplicativo consistem MenuItem em objetos.The menus for an application consist of MenuItem objects. Eles podem conter outros MenuItem objetos, representando os itens de submenu.These can contain other MenuItem objects, representing submenu items. Os MenuItem objetos podem ser armazenados em um MainMenu para exibição como uma estrutura de menu inteira para um formulário ou ContextMenu um que é usado para exibir menus de atalho.The MenuItem objects can be stored in a MainMenu for display as an entire menu structure for a form or a ContextMenu that is used to display shortcut menus. Essa classe fornece a funcionalidade que é comum para todas as classes de menu.This class provides functionality that is common for all the menu classes.

Ao contrário de muitas classes base Menu , a classe usa suas classes derivadas para definir muitas de suas propriedades.Unlike many base classes, the Menu class uses its derived classes to define many of its properties. Se você estiver usando o 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.If you are using your menu in a multiple-document interface (MDI) application, you can use the MdiListItem property to specify a MenuItem that displays a list of open MDI child forms in your application. A MenuItems propriedade contém uma lista de MenuItem objetos armazenados na classe de menu.The MenuItems property contains a list of MenuItem objects stored in the menu class. Para um MainMenu ou ContextMenu, MenuItem essa propriedade contém todos os objetos que são exibidos.For a MainMenu or ContextMenu, this property contains all the MenuItem objects that are displayed. Para um MenuItem, a MenuItems propriedade representa os itens de submenu associados a ela.For a MenuItem, the MenuItems property represents the submenu items associated with it.

Além das propriedades que são fornecidas para todas as classes de menu derivadas, a Menu classe também fornece métodos, CloneMenu como e MergeMenu, que permitem criar novos menus a partir de menus existentes e também mesclar duas estruturas de menu Unido.In addition to the properties that are provided for all the derived menu classes, the Menu class also provides methods, such as CloneMenu and MergeMenu, that enable you to create new menus from existing menus, and also merge two menu structures together.

A Menu classe também define a classe Menu.MenuItemCollectionaninhada.The Menu class also defines the nested class Menu.MenuItemCollection. Essa classe define a coleção de MenuItem objetos usados MenuItems pela propriedade.This class defines the collection of MenuItem objects used by the MenuItems property. Você pode usar os métodos Menu.MenuItemCollection da classe para adicionar e remover itens de menu de um MainMenu, ContextMenuou. MenuItemYou can use the methods of the Menu.MenuItemCollection class to add and remove menu items from a MainMenu, ContextMenu, or MenuItem.

Construtores

Menu(MenuItem[]) Menu(MenuItem[]) Menu(MenuItem[]) Menu(MenuItem[])

Inicializa uma nova instância da classe Menu.Initializes a new instance of the Menu class.

Campos

FindHandle FindHandle FindHandle FindHandle

Especifica que o método FindMenuItem(Int32, IntPtr) deve pesquisar por um identificador.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a handle.

FindShortcut FindShortcut FindShortcut FindShortcut

Especifica que o método FindMenuItem(Int32, IntPtr) deve pesquisar por um atalho.Specifies that the FindMenuItem(Int32, IntPtr) method should search for a shortcut.

Propriedades

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Inherited from Component)
DesignMode DesignMode DesignMode DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Handle Handle Handle Handle

Obtém um valor que representa o identificador de janela do menu.Gets a value representing the window handle for the menu.

IsParent IsParent IsParent IsParent

Obtém um valor que indica se este menu contém algum item de menu.Gets a value indicating whether this menu contains any menu items. Esta propriedade é somente para leitura.This property is read-only.

MdiListItem MdiListItem MdiListItem 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).Gets a value indicating the MenuItem that is used to display a list of multiple document interface (MDI) child forms.

MenuItems MenuItems MenuItems MenuItems

Obtém um valor que indica a coleção de objetos MenuItem associados ao menu.Gets a value indicating the collection of MenuItem objects associated with the menu.

Name Name Name Name

Obtém ou define o nome de Menu.Gets or sets the name of the Menu.

Site Site Site Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Tag Tag Tag Tag

Obtém ou define dados definidos pelo usuário associados ao controle.Gets or sets user-defined data associated with the control.

Métodos

CloneMenu(Menu) CloneMenu(Menu) CloneMenu(Menu) CloneMenu(Menu)

Copia o Menu que é passado como um parâmetro para o Menu atual.Copies the Menu that is passed as a parameter to the current Menu.

CreateMenuHandle() CreateMenuHandle() CreateMenuHandle() CreateMenuHandle()

Cria um novo identificador para o Menu.Creates a new handle to the Menu.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) 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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Descarta os recursos (exceto a memória) usados pelo Menu.Disposes of the resources, other than memory, used by the Menu.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr) FindMenuItem(Int32, IntPtr)

Obtém o MenuItem que contém o valor especificado.Gets the MenuItem that contains the value specified.

FindMergePosition(Int32) FindMergePosition(Int32) FindMergePosition(Int32) FindMergePosition(Int32)

Retorna a posição em que um item de menu deve ser inserido no menu.Returns the position at which a menu item should be inserted into the menu.

GetContextMenu() GetContextMenu() GetContextMenu() GetContextMenu()

Obtém o ContextMenu que contém este menu.Gets the ContextMenu that contains this menu.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetMainMenu() GetMainMenu() GetMainMenu() GetMainMenu()

Obtém o MainMenu que contém este menu.Gets the MainMenu that contains this menu.

GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MergeMenu(Menu) MergeMenu(Menu) MergeMenu(Menu) MergeMenu(Menu)

Mescla os objetos MenuItem de um menu com o menu atual.Merges the MenuItem objects of one menu with the current menu.

ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys) ProcessCmdKey(Message, Keys)

Processa uma chave de comando.Processes a command key.

ToString() ToString() ToString() ToString()

Retorna uma String que representa o controle Menu.Returns a String that represents the Menu control.

Eventos

Disposed Disposed Disposed Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)

Aplica-se a

Veja também