MainMenu Classe

Definição

Representa a estrutura do menu de um formulário.

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

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

Exemplos

O exemplo de código seguinte cria um MainMenu, atribui dois MenuItem objetos ao MainMenu e liga-o a uma forma. Este exemplo exige que tenhas um Form criado que seja 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

Observações

Esta classe não está disponível no .NET Core 3.1 e versões posteriores. Utilize MenuStrip em substituição.

O MainMenu controlo representa o contentor para a estrutura do menu de um formulário. Um menu é composto por MenuItem objetos que representam os comandos individuais do menu na estrutura do menu. Cada um MenuItem pode ser um comando para a sua aplicação ou um menu pai para outros itens do submenu. Para ligar o MainMenu ao Form que o irá exibir, atribui-lhe MainMenu à Menu propriedade de .Form

Para aplicações que suportam múltiplas línguas, pode usar a RightToLeft propriedade para mostrar o texto do menu da direita para a esquerda para suportar línguas como o árabe.

Podes criar diferentes MainMenu objetos para representar diferentes estruturas de menu para a tua forma. Se quiseres reutilizar a estrutura do menu contida num determinado MainMenu, podes usar o seu CloneMenu método para criar uma cópia. Depois de ter uma cópia da estrutura do menu, pode fazer as modificações apropriadas para a nova estrutura do menu.

Note

Cortar e colar itens do menu de um formulário para outro no designer pode não funcionar como esperado se o formulário onde estás a colar não tiver itens definidos no menu.

Construtores

Name Description
MainMenu()

Inicializa uma nova instância da MainMenu classe sem quaisquer itens de menu especificados.

MainMenu(IContainer)

Inicializa uma nova instância da MainMenu classe com o contentor especificado.

MainMenu(MenuItem[])

Inicializa uma nova instância de com MainMenu um conjunto especificado de MenuItem objetos.

Campos

Name Description
FindHandle

Especifica que o FindMenuItem(Int32, IntPtr) método deve procurar um handle.

(Herdado de Menu)
FindShortcut

Especifica que o FindMenuItem(Int32, IntPtr) método deve procurar um atalho.

(Herdado de Menu)

Propriedades

Name Description
CanRaiseEvents

Obtém um valor que indica se o componente pode gerar 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á atualmente em modo de design.

(Herdado de Component)
Events

Obtém a lista de gestores de eventos que estão ligados a isto Component.

(Herdado de Component)
Handle

Recebe um valor que representa a manivela da janela para o menu.

(Herdado de Menu)
IsParent

Recebe um valor que indica se este menu contém algum item do menu. Esta propriedade é somente leitura.

(Herdado de Menu)
MdiListItem

Recebe um valor que indica que MenuItem é usado para mostrar uma lista de formulários filhos de múltiplos documentos (MDI).

(Herdado de Menu)
MenuItems

Recebe um valor que indica a coleção de MenuItem objetos associados ao menu.

(Herdado de Menu)
Name

Obtém ou define o nome do Menu.

(Herdado de Menu)
RightToLeft

Obtém ou define se o texto apresentado pelo controlo é 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 utilizador associados ao controlo.

(Herdado de Menu)

Métodos

Name Description
CloneMenu()

Cria um novo MainMenu que é um duplicado do atual MainMenu.

CloneMenu(Menu)

Copia o Menu que é passado como parâmetro para a corrente Menu.

(Herdado de Menu)
CreateMenuHandle()

Cria um novo handle no Menu.

CreateObjRef(Type)

Cria um objeto que contém toda a informação relevante necessária para gerar um proxy usado para comunicar com um objeto remoto.

(Herdado de MarshalByRefObject)
Dispose()

Liberta todos os recursos utilizados pelo Component.

(Herdado de Component)
Dispose(Boolean)

Elimina 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)

Devolve a posição em que um item do menu deve ser inserido no menu.

(Herdado de Menu)
GetContextMenu()

Recebe o ContextMenu que contém este menu.

(Herdado de Menu)
GetForm()

Obtém-se que Form contém este controlo.

GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de vida útil neste caso.

(Herdado de MarshalByRefObject)
GetMainMenu()

Recebe o MainMenu que contém este menu.

(Herdado de Menu)
GetService(Type)

Devolve 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()

Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso.

(Herdado de MarshalByRefObject)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto atual MarshalByRefObject .

(Herdado de MarshalByRefObject)
MergeMenu(Menu)

Funde os MenuItem objetos de um menu com o menu atual.

(Herdado de Menu)
OnCollapse(EventArgs)

Eleva o Collapse evento.

ProcessCmdKey(Message, Keys)

Processa uma tecla de comando.

(Herdado de Menu)
ToString()

Devolve uma cadeia que representa o MainMenu.

evento

Name Description
Collapse

Acontece quando o menu principal colapsa.

Disposed

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

(Herdado de Component)

Aplica-se a

Ver também