MainMenu Classe
Definição
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.
Cuidado
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 a seguir cria um MainMenu, atribui dois MenuItem objetos ao e o MainMenu associa a um formulário. Este exemplo requer 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
Essa classe não está disponível no .NET Core 3.1 e 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 pode ser um comando para seu aplicativo ou um menu pai para outros itens de submenu. Para associar o MainMenu que o Form exibirá, atribua a MenuMainMenu 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 menus contida em um determinado MainMenu, poderá usar seu CloneMenu método para criar uma cópia. Depois de ter uma cópia da estrutura de menus, 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 em que você está colando não tiver nenhum item de menu definido.
Construtores
| Nome | Description |
|---|---|
| MainMenu() |
Obsoleto.
Inicializa uma nova instância da MainMenu classe sem nenhum item de menu especificado. |
| MainMenu(IContainer) |
Obsoleto.
Inicializa uma nova instância da MainMenu classe com o contêiner especificado. |
| MainMenu(MenuItem[]) |
Obsoleto.
Inicializa uma nova instância com MainMenu um conjunto MenuItem de objetos especificado. |
Campos
| Nome | Description |
|---|---|
| FindHandle |
Obsoleto.
Especifica que o FindMenuItem(Int32, IntPtr) método deve procurar um identificador. (Herdado de Menu) |
| FindShortcut |
Obsoleto.
Especifica que o FindMenuItem(Int32, IntPtr) método deve procurar um atalho. (Herdado de Menu) |
Propriedades
| Nome | 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á no modo de design no momento. (Herdado de Component) |
| Events |
Obsoleto.
Obtém a lista de manipuladores de eventos anexados a isso Component. (Herdado de Component) |
| Handle |
Obsoleto.
Obtém um valor que representa o identificador de janela do menu. (Herdado de Menu) |
| IsParent |
Obsoleto.
Obtém um valor que indica se este menu contém itens de menu. Esta propriedade é somente para leitura. (Herdado de Menu) |
| MdiListItem |
Obsoleto.
Obtém um valor que indica o MenuItem que é usado para exibir uma lista de vários formulários filho da MDI (interface do documento). (Herdado de Menu) |
| MenuItems |
Obsoleto.
Obtém 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 exibido pelo controle é exibido da direita para a esquerda. |
| Site |
Obsoleto.
Obtém ou define o ISiteComponent. (Herdado de Component) |
| Tag |
Obsoleto.
Obtém ou define dados definidos pelo usuário associados ao controle. (Herdado de Menu) |
Métodos
| Nome | Description |
|---|---|
| CloneMenu() |
Obsoleto.
Cria um novo MainMenu que é uma duplicata do atual MainMenu. |
| CloneMenu(Menu) |
Obsoleto.
Copia o Menu que é passado como um parâmetro para o atual Menu. (Herdado de Menu) |
| CreateMenuHandle() |
Obsoleto.
Cria um novo identificador para o Menu. |
| CreateMenuHandle() |
Obsoleto.
Cria um novo identificador para o Menu. (Herdado de Menu) |
| CreateObjRef(Type) |
Obsoleto.
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() |
Obsoleto.
Libera todos os recursos usados pelo Component. (Herdado de Component) |
| Dispose(Boolean) |
Obsoleto.
Descarta os recursos, exceto a memória, usados MainMenupelo . |
| 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.
Retorna a posição na qual um item de menu deve ser inserido no menu. (Herdado de Menu) |
| GetContextMenu() |
Obsoleto.
Obtém o ContextMenu que contém este menu. (Herdado de Menu) |
| GetForm() |
Obsoleto.
Obtém o Form que contém esse controle. |
| GetHashCode() |
Obsoleto.
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 tempo de vida para essa instância. (Herdado de MarshalByRefObject) |
| GetMainMenu() |
Obsoleto.
Obtém o MainMenu que contém este menu. (Herdado de Menu) |
| GetService(Type) |
Obsoleto.
Retorna um objeto que representa um serviço fornecido pelo Component ou por sua Container. (Herdado de Component) |
| GetType() |
Obsoleto.
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 dessa instância. (Herdado de MarshalByRefObject) |
| MemberwiseClone() |
Obsoleto.
Cria uma cópia superficial do Objectatual. (Herdado de Object) |
| MemberwiseClone(Boolean) |
Obsoleto.
Cria uma cópia superficial do objeto atual MarshalByRefObject . (Herdado de MarshalByRefObject) |
| MergeMenu(Menu) |
Obsoleto.
Mescla os MenuItem objetos de um menu com o menu atual. (Herdado de Menu) |
| OnCollapse(EventArgs) |
Obsoleto.
Aciona o evento Collapse. |
| ProcessCmdKey(Message, Keys) |
Obsoleto.
Processa uma chave de comando. (Herdado de Menu) |
| ToString() |
Obsoleto.
Retorna uma cadeia de caracteres que representa o MainMenu. |
Eventos
| Nome | Description |
|---|---|
| Collapse |
Obsoleto.
Ocorre quando o menu principal é recolhido. |
| Disposed |
Obsoleto.
Ocorre quando o componente é descartado por uma chamada para o Dispose() método. (Herdado de Component) |