Compartilhar via

Como associar um menu de atalho a um componente NotifyIcon dos Windows Forms

  • Artigo

Nota

Embora MenuStrip e ContextMenuStrip substituam e adicionem funcionalidade aos controles MainMenu e ContextMenu de versões anteriores, MainMenu e ContextMenu serão mantidos para compatibilidade com versões anteriores e uso futuro, se você escolher.

O componente NotifyIcon exibe um ícone na área de notificação de status da barra de tarefas. Normalmente, os aplicativos permitem que você clique com o botão direito do mouse neste ícone para enviar comandos para o aplicativo que ele representa. Ao associar um componente ContextMenu ao componente NotifyIcon, você pode adicionar essa funcionalidade aos seus aplicativos.

Nota

Se você quiser que seu aplicativo seja minimizado na inicialização ao exibir uma instância do componente NotifyIcon na barra de tarefas, defina a propriedade WindowState do formulário principal como Minimized e verifique se a propriedade Visible do componente NotifyIcon está definida como true.

Associar um menu de atalho ao componente NotifyIcon no tempo de design

  1. Adicione um componente NotifyIcon ao formulário e defina as propriedades importantes, como as propriedades Icon e Visible.

    Para obter mais informações, consulte Como adicionar ícones de aplicativo à Barra de Tarefas com o componente NotifyIcon dos Windows Forms.

  2. Adicione um componente ContextMenu ao seu Windows Form.

    Adicione itens de menu ao menu de atalho que representa os comandos que você deseja disponibilizar em tempo de execução. Esse também é um bom momento para adicionar aprimoramentos de menu a esses itens de menu, como chaves de acesso.

  3. Defina a propriedade ContextMenu do componente NotifyIcon para o menu de atalho que você adicionou.

    Com esse conjunto de propriedades, o menu de atalho será exibido quando o ícone na barra de tarefas for clicado.

Para associar um menu de atalho ao componente NotifyIcon programaticamente

  1. Crie uma instância da classe NotifyIcon e uma classe ContextMenu, com quaisquer configurações de propriedade necessárias para o aplicativo ( propriedadesIcon e Visible para o componente NotifyIcon, itens de menu para o componente ContextMenu).

  2. Defina a propriedade ContextMenu do componente NotifyIcon para o menu de atalho que você adicionou.

    Com esse conjunto de propriedades, o menu de atalho será exibido quando o ícone na barra de tarefas for clicado.

    Nota

    O exemplo de código a seguir cria uma estrutura de menu básica. Você precisará personalizar as opções de menu para aqueles que se encaixam no aplicativo que você está desenvolvendo. Além disso, você desejará escrever código para lidar com os eventos de Click para esses itens de menu.

    Public ContextMenu1 As New ContextMenu  
Public NotifyIcon1 As New NotifyIcon  

Public Sub CreateIconMenuStructure()  
   ' Add menu items to shortcut menu.  
   ContextMenu1.MenuItems.Add("&Open Application")  
   ContextMenu1.MenuItems.Add("S&uspend Application")  
   ContextMenu1.MenuItems.Add("E&xit")  

   ' Set properties of NotifyIcon component.  
   NotifyIcon1.Icon = New System.Drawing.Icon _
      (System.Environment.GetFolderPath _
      (System.Environment.SpecialFolder.Personal)  _
      & "\Icon.ico")  
   NotifyIcon1.Text = "Right-click me!"  
   NotifyIcon1.Visible = True  
   NotifyIcon1.ContextMenu = ContextMenu1  
End Sub  

public NotifyIcon notifyIcon1 = new NotifyIcon();  
public ContextMenu contextMenu1 = new ContextMenu();  
  
public void createIconMenuStructure()  
{  
   // Add menu items to shortcut menu.  
   contextMenu1.MenuItems.Add("&Open Application");  
   contextMenu1.MenuItems.Add("S&uspend Application");  
   contextMenu1.MenuItems.Add("E&xit");  
  
   // Set properties of NotifyIcon component.  
   notifyIcon1.Icon = new System.Drawing.Icon  
      (System.Environment.GetFolderPath  
      (System.Environment.SpecialFolder.Personal)  
      + @"\Icon.ico");  
   notifyIcon1.Visible = true;  
   notifyIcon1.Text = "Right-click me!";  
   notifyIcon1.Visible = true;  
   notifyIcon1.ContextMenu = contextMenu1;  
}  

public:  
   System::Windows::Forms::NotifyIcon ^ notifyIcon1;  
   System::Windows::Forms::ContextMenu ^ contextMenu1;  
  
   void createIconMenuStructure()  
   {  
      // Add menu items to shortcut menu.  
      contextMenu1->MenuItems->Add("&Open Application");  
      contextMenu1->MenuItems->Add("S&uspend Application");  
      contextMenu1->MenuItems->Add("E&xit");  
  
      // Set properties of NotifyIcon component.  
      notifyIcon1->Icon = gcnew System::Drawing::Icon  
          (String::Concat(System::Environment::GetFolderPath  
          (System::Environment::SpecialFolder::Personal),  
          "\\Icon.ico"));  
      notifyIcon1->Text = "Right-click me!";  
      notifyIcon1->Visible = true;  
      notifyIcon1->ContextMenu = contextMenu1;  
   }

Nota

Você deve inicializar notifyIcon1 e contextMenu1,, o que você pode fazer incluindo as seguintes instruções no construtor do seu formulário:

notifyIcon1 = gcnew System::Windows::Forms::NotifyIcon();  
contextMenu1 = gcnew System::Windows::Forms::ContextMenu();

Consulte também