MainMenu Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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() | |
| 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) |