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.
Atenção
MainMenu is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use MenuStrip instead.
public ref class MainMenu : System::Windows::Forms::Menu
public class MainMenu : System.Windows.Forms.Menu
[System.ComponentModel.Browsable(false)]
[System.Obsolete("`MainMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `MenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")]
public class MainMenu : System.Windows.Forms.Menu
type MainMenu = class
inherit Menu
[<System.ComponentModel.Browsable(false)>]
[<System.Obsolete("`MainMenu` is provided for binary compatibility with .NET Framework and is not intended to be used directly from your code. Use `MenuStrip` instead.", false, DiagnosticId="WFDEV006", UrlFormat="https://aka.ms/winforms-warnings/{0}")>]
type MainMenu = class
inherit Menu
Public Class MainMenu
Inherits Menu
- Herança
- Atributos
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() |
Obsoleto.
Inicializa uma nova instância da MainMenu classe sem quaisquer itens de menu especificados. |
| MainMenu(IContainer) |
Obsoleto.
Inicializa uma nova instância da MainMenu classe com o contentor especificado. |
| MainMenu(MenuItem[]) |
Obsoleto.
Inicializa uma nova instância de com MainMenu um conjunto especificado de MenuItem objetos. |
Campos
| Name | Description |
|---|---|
| FindHandle |
Obsoleto.
Especifica que o FindMenuItem(Int32, IntPtr) método deve procurar um handle. (Herdado de Menu) |
| FindShortcut |
Obsoleto.
Especifica que o FindMenuItem(Int32, IntPtr) método deve procurar um atalho. (Herdado de Menu) |
Propriedades
| Name | Description |
|---|---|
| CanRaiseEvents |
Obsoleto.
Obtém um valor que indica se o componente pode gerar um evento. (Herdado de Component) |
| Container |
Obsoleto.
Obtém o IContainer que contém o Component. (Herdado de Component) |
| DesignMode |
Obsoleto.
Obtém um valor que indica se o Component está atualmente em modo de design. (Herdado de Component) |
| Events |
Obsoleto.
Obtém a lista de gestores de eventos que estão ligados a isto Component. (Herdado de Component) |
| Handle |
Obsoleto.
Recebe um valor que representa a manivela da janela para o menu. (Herdado de Menu) |
| IsParent |
Obsoleto.
Recebe um valor que indica se este menu contém algum item do menu. Esta propriedade é somente leitura. (Herdado de Menu) |
| MdiListItem |
Obsoleto.
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 |
Obsoleto.
Recebe um valor que indica a coleção de MenuItem objetos associados ao menu. (Herdado de Menu) |
| Name |
Obsoleto.
Obtém ou define o nome do Menu. (Herdado de Menu) |
| RightToLeft |
Obsoleto.
Obtém ou define se o texto apresentado pelo controlo é exibido da direita para a esquerda. |
| Site |
Obsoleto.
Obtém ou define o ISite do Component. (Herdado de Component) |
| Tag |
Obsoleto.
Obtém ou define dados definidos pelo utilizador associados ao controlo. (Herdado de Menu) |
Métodos
| Name | Description |
|---|---|
| CloneMenu() |
Obsoleto.
|
| CloneMenu(Menu) |
Obsoleto.
Copia o Menu que é passado como parâmetro para a corrente Menu. (Herdado de Menu) |
| CreateMenuHandle() |
Obsoleto.
Cria um novo handle no Menu. |
| CreateMenuHandle() |
Obsoleto.
Cria uma nova alça para o Menu. (Herdado de Menu) |
| CreateObjRef(Type) |
Obsoleto.
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() |
Obsoleto.
Liberta todos os recursos utilizados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Obsoleto.
Elimina os recursos, exceto a memória, usados pelo MainMenu. |
| Equals(Object) |
Obsoleto.
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| FindMenuItem(Int32, IntPtr) |
Obsoleto.
Obtém o MenuItem que contém o valor especificado. (Herdado de Menu) |
| FindMergePosition(Int32) |
Obsoleto.
Devolve a posição em que um item do menu deve ser inserido no menu. (Herdado de Menu) |
| GetContextMenu() |
Obsoleto.
Recebe o ContextMenu que contém este menu. (Herdado de Menu) |
| GetForm() |
Obsoleto.
Obtém-se que Form contém este controlo. |
| GetHashCode() |
Obsoleto.
Serve como função de hash predefinida. (Herdado de Object) |
| GetLifetimeService() |
Obsoleto.
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() |
Obsoleto.
Recebe o MainMenu que contém este menu. (Herdado de Menu) |
| GetService(Type) |
Obsoleto.
Devolve um objeto que representa um serviço fornecido pelo Component ou pelo seu Container. (Herdado de Component) |
| GetType() |
Obsoleto.
Obtém o Type da instância atual. (Herdado de Object) |
| InitializeLifetimeService() |
Obsoleto.
Obtém-se um objeto de serviço vitalício para controlar a apólice vitalícia neste caso. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Obsoleto.
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Obsoleto.
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| MergeMenu(Menu) |
Obsoleto.
Funde os MenuItem objetos de um menu com o menu atual. (Herdado de Menu) |
| OnCollapse(EventArgs) |
Obsoleto.
Eleva o Collapse evento. |
| ProcessCmdKey(Message, Keys) |
Obsoleto.
Processa uma tecla de comando. (Herdado de Menu) |
| ToString() |
Obsoleto.
Devolve uma cadeia que representa o MainMenu. |
evento
| Name | Description |
|---|---|
| Collapse |
Obsoleto.
Acontece quando o menu principal colapsa. |
| Disposed |
Obsoleto.
Ocorre quando o componente é eliminado por uma chamada ao Dispose() método. (Herdado de Component) |