MainMenu 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 estrutura de menu de um formulário.

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

public ref class MainMenu : System::Windows::Forms::Menu

public class MainMenu : System.Windows.Forms.Menu

type MainMenu = class
    inherit Menu

Public Class MainMenu
Inherits Menu

Herança: Object

MarshalByRefObject

Component

Menu
MainMenu

Exemplos

O exemplo de código a seguir cria um MainMenu, atribui dois MenuItem objetos ao e o MainMenu associa a um formulário. Este exemplo exige que você tenha um Form criado chamado Form1.

void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu^ mainMenu1 = gcnew MainMenu;
   MenuItem^ menuItem1 = gcnew MenuItem;
   MenuItem^ menuItem2 = gcnew MenuItem;
   menuItem1->Text = "File";
   menuItem2->Text = "Edit";

   // Add two MenuItem objects to the MainMenu.
   mainMenu1->MenuItems->Add( menuItem1 );
   mainMenu1->MenuItems->Add( menuItem2 );

   // Bind the MainMenu to Form1.
   Menu = mainMenu1;
}

public void CreateMyMainMenu()
{
   // Create an empty MainMenu.
   MainMenu mainMenu1 = new MainMenu();

   MenuItem menuItem1 = new MenuItem();
   MenuItem menuItem2 = new MenuItem();

   menuItem1.Text = "File";
   menuItem2.Text = "Edit";
   // Add two MenuItem objects to the MainMenu.
   mainMenu1.MenuItems.Add(menuItem1);
   mainMenu1.MenuItems.Add(menuItem2);
   
   // Bind the MainMenu to Form1.
   Menu = mainMenu1;   
}

Public Sub CreateMyMainMenu()
    ' Create an empty MainMenu.
    Dim mainMenu1 As New MainMenu()
       
    Dim menuItem1 As New MenuItem()
    Dim menuItem2 As New MenuItem()
       
    menuItem1.Text = "File"
    menuItem2.Text = "Edit"
    ' Add two MenuItem objects to the MainMenu.
    mainMenu1.MenuItems.Add(menuItem1)
    mainMenu1.MenuItems.Add(menuItem2)
       
    ' Bind the MainMenu to Form1.
    Menu = mainMenu1
End Sub

Comentários

Esta classe não está disponível no .NET Core 3.1 nem em versões posteriores. Use MenuStrip em seu lugar.

O MainMenu controle representa o contêiner para a estrutura de menu de um formulário. Um menu é composto por MenuItem objetos que representam os comandos de menu individuais na estrutura do menu. Cada MenuItem um pode ser um comando para seu aplicativo ou um menu pai para outros itens de submenu. Para associar o MainMenu ao que o Form exibirá, atribua o MainMenu à Menu propriedade do Form.

Para aplicativos que terão suporte para vários idiomas, você pode usar a RightToLeft propriedade para exibir o texto do menu da direita para a esquerda para dar suporte a idiomas como árabe.

Você pode criar objetos diferentes MainMenu para representar estruturas de menu diferentes para seu formulário. Se você quiser reutilizar a estrutura de menu contida em um específico MainMenu, poderá usar seu CloneMenu método para criar uma cópia. Depois de ter uma cópia da estrutura de menu, você poderá fazer as modificações apropriadas para sua nova estrutura de menus.

Observação

Cortar e colar itens de menu de um formulário para outro no designer pode não funcionar conforme o esperado se o formulário que você está colando não tiver itens de menu definidos.

Construtores

MainMenu()	Inicializa uma nova instância da classe MainMenu sem nenhum item de menu especificado.
MainMenu(IContainer)	Inicializa uma nova instância da classe MainMenu com o contêiner especificado.
MainMenu(MenuItem[])	Inicializa uma nova instância da MainMenu com um conjunto de objetos MenuItem especificado.

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

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. (Herdado de Menu)
IsParent	Obtém um valor que indica se este menu contém algum item de menu. Esta propriedade é somente para leitura. (Herdado de Menu)
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)
MenuItems	Obtém um valor que indica a coleção de objetos MenuItem associados ao menu. (Herdado de Menu)
Name	Obtém ou define o nome de Menu. (Herdado de Menu)
RightToLeft	Determina ou define se o texto exibido pelo controle é exibido da direita para a esquerda.
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)

Métodos

CloneMenu()	Cria um novo MainMenu que é uma duplicata do MainMenu atual.
CloneMenu(Menu)	Copia o Menu que é passado como um parâmetro para o Menu atual. (Herdado de Menu)
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 MainMenu.
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)
GetForm()	Obtém o Form que contém este controle.
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(Menu)	Mescla os objetos MenuItem de um menu com o menu atual. (Herdado de Menu)
OnCollapse(EventArgs)	Aciona o evento Collapse.
ProcessCmdKey(Message, Keys)	Processa uma chave de comando. (Herdado de Menu)
ToString()	Retorna uma cadeia de caracteres que representa o MainMenu.

Eventos

Collapse	Ocorre quando o menu principal é recolhido.
Disposed	Ocorre quando o componente é disposto por uma chamada ao método Dispose(). (Herdado de Component)

Aplica-se a

Compartilhar via