NotifyIcon NotifyIcon NotifyIcon NotifyIcon Class

Definição

Especifica um componente que cria um ícone na área de notificação.Specifies a component that creates an icon in the notification area. Essa classe não pode ser herdada.This class cannot be inherited.

public ref class NotifyIcon sealed : System::ComponentModel::Component
public sealed class NotifyIcon : System.ComponentModel.Component
type NotifyIcon = class
    inherit Component
Public NotInheritable Class NotifyIcon
Inherits Component
Herança

Exemplos

O exemplo de código a seguir demonstra NotifyIcon como usar a classe para exibir um ícone para um aplicativo na área de notificação.The following code example demonstrates using the NotifyIcon class to display an icon for an application in the notification area. O exemplo demonstra como definir Iconas ContextMenu Visible propriedades Text,, e e manipular o DoubleClick evento.The example demonstrates setting the Icon, ContextMenu, Text, and Visible properties and handling the DoubleClick event. Um ContextMenu com um item de saída NotifyIcon.ContextMenu é atribuído à propriedade, o que permite ao usuário fechar o aplicativo.A ContextMenu with an Exit item on it is assigned to the NotifyIcon.ContextMenu property, which allows the user to close the application. Quando o DoubleClick evento ocorre, o formulário do aplicativo é ativado chamando- Form.Activate se o método.When the DoubleClick event occurs, the application form is activated by calling the Form.Activate method.

#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::Drawing;
using namespace System::Windows::Forms;
public ref class Form1: public System::Windows::Forms::Form
{
private:
   System::Windows::Forms::NotifyIcon^ notifyIcon1;
   System::Windows::Forms::ContextMenu^ contextMenu1;
   System::Windows::Forms::MenuItem^ menuItem1;
   System::ComponentModel::IContainer^ components;

public:
   Form1()
   {
      this->components = gcnew System::ComponentModel::Container;
      this->contextMenu1 = gcnew System::Windows::Forms::ContextMenu;
      this->menuItem1 = gcnew System::Windows::Forms::MenuItem;
      
      // Initialize contextMenu1
      array<System::Windows::Forms::MenuItem^>^temp0 = {this->menuItem1};
      this->contextMenu1->MenuItems->AddRange( temp0 );
      
      // Initialize menuItem1
      this->menuItem1->Index = 0;
      this->menuItem1->Text = "E&xit";
      this->menuItem1->Click += gcnew System::EventHandler( this, &Form1::menuItem1_Click );
      
      // Set up how the form should be displayed.
      this->ClientSize = System::Drawing::Size( 292, 266 );
      this->Text = "Notify Icon Example";
      
      // Create the NotifyIcon.
      this->notifyIcon1 = gcnew System::Windows::Forms::NotifyIcon( this->components );
      
      // The Icon property sets the icon that will appear
      // in the systray for this application.
      notifyIcon1->Icon = gcnew System::Drawing::Icon( "appicon.ico" );
      
      // The ContextMenu property sets the menu that will
      // appear when the systray icon is right clicked.
      notifyIcon1->ContextMenu = this->contextMenu1;
      
      // The Text property sets the text that will be displayed,
      // in a tooltip, when the mouse hovers over the systray icon.
      notifyIcon1->Text = "Form1 (NotifyIcon example)";
      notifyIcon1->Visible = true;
      
      // Handle the DoubleClick event to activate the form.
      notifyIcon1->DoubleClick += gcnew System::EventHandler( this, &Form1::notifyIcon1_DoubleClick );
   }

protected:
   ~Form1()
   {
      if ( components != nullptr )
      {
         delete components;
      }
   }

private:
   void notifyIcon1_DoubleClick( Object^ /*Sender*/, EventArgs^ /*e*/ )
   {
      
      // Show the form when the user double clicks on the notify icon.
      // Set the WindowState to normal if the form is minimized.
      if ( this->WindowState == FormWindowState::Minimized )
            this->WindowState = FormWindowState::Normal;
      
      // Activate the form.
      this->Activate();
   }

   void menuItem1_Click( Object^ /*Sender*/, EventArgs^ /*e*/ )
   {
      
      // Close the form, which closes the application.
      this->Close();
   }

};

[STAThread]
int main()
{
   Application::Run( gcnew Form1 );
}
using System;
using System.Drawing;
using System.Windows.Forms;

public class Form1 : System.Windows.Forms.Form
{
    private System.Windows.Forms.NotifyIcon notifyIcon1;
    private System.Windows.Forms.ContextMenu contextMenu1;
    private System.Windows.Forms.MenuItem menuItem1;
    private System.ComponentModel.IContainer components;

    [STAThread]
    static void Main() 
    {
        Application.Run(new Form1());
    }

    public Form1()
    {
        this.components = new System.ComponentModel.Container();
        this.contextMenu1 = new System.Windows.Forms.ContextMenu();
        this.menuItem1 = new System.Windows.Forms.MenuItem();

        // Initialize contextMenu1
        this.contextMenu1.MenuItems.AddRange(
                    new System.Windows.Forms.MenuItem[] {this.menuItem1});

        // Initialize menuItem1
        this.menuItem1.Index = 0;
        this.menuItem1.Text = "E&xit";
        this.menuItem1.Click += new System.EventHandler(this.menuItem1_Click);

        // Set up how the form should be displayed.
        this.ClientSize = new System.Drawing.Size(292, 266);
        this.Text = "Notify Icon Example";

        // Create the NotifyIcon.
        this.notifyIcon1 = new System.Windows.Forms.NotifyIcon(this.components);

        // The Icon property sets the icon that will appear
        // in the systray for this application.
        notifyIcon1.Icon = new Icon("appicon.ico");

        // The ContextMenu property sets the menu that will
        // appear when the systray icon is right clicked.
        notifyIcon1.ContextMenu = this.contextMenu1;

        // The Text property sets the text that will be displayed,
        // in a tooltip, when the mouse hovers over the systray icon.
        notifyIcon1.Text = "Form1 (NotifyIcon example)";
        notifyIcon1.Visible = true;

        // Handle the DoubleClick event to activate the form.
        notifyIcon1.DoubleClick += new System.EventHandler(this.notifyIcon1_DoubleClick);

    }

    protected override void Dispose( bool disposing )
    {
        // Clean up any components being used.
        if( disposing )
            if (components != null)
                components.Dispose();            

        base.Dispose( disposing );
    }

    private void notifyIcon1_DoubleClick(object Sender, EventArgs e) 
    {
        // Show the form when the user double clicks on the notify icon.

        // Set the WindowState to normal if the form is minimized.
        if (this.WindowState == FormWindowState.Minimized)
            this.WindowState = FormWindowState.Normal;

        // Activate the form.
        this.Activate();
    }

    private void menuItem1_Click(object Sender, EventArgs e) {
        // Close the form, which closes the application.
        this.Close();
    }
}
Imports System.Drawing
Imports System.Windows.Forms

Public NotInheritable Class Form1
    Inherits System.Windows.Forms.Form

    Private contextMenu1 As System.Windows.Forms.ContextMenu
    Friend WithEvents menuItem1 As System.Windows.Forms.MenuItem
    Friend WithEvents notifyIcon1 As System.Windows.Forms.NotifyIcon
    Private components As System.ComponentModel.IContainer

    <System.STAThread()> _
    Public Shared Sub Main()
        System.Windows.Forms.Application.Run(New Form1)
    End Sub

    Public Sub New()

        Me.components = New System.ComponentModel.Container
        Me.contextMenu1 = New System.Windows.Forms.ContextMenu
        Me.menuItem1 = New System.Windows.Forms.MenuItem

        ' Initialize contextMenu1
        Me.contextMenu1.MenuItems.AddRange(New System.Windows.Forms.MenuItem() _
                            {Me.menuItem1})

        ' Initialize menuItem1
        Me.menuItem1.Index = 0
        Me.menuItem1.Text = "E&xit"

        ' Set up how the form should be displayed.
        Me.ClientSize = New System.Drawing.Size(292, 266)
        Me.Text = "Notify Icon Example"

        ' Create the NotifyIcon.
        Me.notifyIcon1 = New System.Windows.Forms.NotifyIcon(Me.components)

        ' The Icon property sets the icon that will appear
        ' in the systray for this application.
        notifyIcon1.Icon = New Icon("appicon.ico")

        ' The ContextMenu property sets the menu that will
        ' appear when the systray icon is right clicked.
        notifyIcon1.ContextMenu = Me.contextMenu1

        ' The Text property sets the text that will be displayed,
        ' in a tooltip, when the mouse hovers over the systray icon.
        notifyIcon1.Text = "Form1 (NotifyIcon example)"
        notifyIcon1.Visible = True
    End Sub
    
    Protected Overloads Overrides Sub Dispose(ByVal disposing As Boolean)
        ' Clean up any components being used.
        If disposing Then
            If (components IsNot Nothing) Then
                components.Dispose()
            End If
        End If
        MyBase.Dispose(disposing)
    End Sub

    Private Sub notifyIcon1_DoubleClick(Sender as object, e as EventArgs) handles notifyIcon1.DoubleClick
        ' Show the form when the user double clicks on the notify icon.

        ' Set the WindowState to normal if the form is minimized.
        if (me.WindowState = FormWindowState.Minimized) then _
            me.WindowState = FormWindowState.Normal

        ' Activate the form.
        me.Activate()
    end sub

    Private Sub menuItem1_Click(Sender as object, e as EventArgs) handles menuItem1.Click
        ' Close the form, which closes the application.
        me.Close()
    end sub

End Class

Comentários

Os ícones na área de notificação são atalhos para processos que estão sendo executados em segundo plano de um computador, como um programa de proteção contra vírus ou um controle de volume.Icons in the notification area are shortcuts to processes that are running in the background of a computer, such as a virus protection program or a volume control. Esses processos não são fornecidos com suas próprias interfaces de usuário.These processes do not come with their own user interfaces. A NotifyIcon classe fornece uma maneira de programar nessa funcionalidade.The NotifyIcon class provides a way to program in this functionality. A Icon propriedade define o ícone que aparece na área de notificação.The Icon property defines the icon that appears in the notification area. Os menus pop-up de um ícone são abordados ContextMenu com a propriedade.Pop-up menus for an icon are addressed with the ContextMenu property. A Text Propriedade atribui texto de dica de ferramenta.The Text property assigns ToolTip text. Para que o ícone apareça na área de notificação, a Visible propriedade deve ser definida como. trueIn order for the icon to show up in the notification area, the Visible property must be set to true.

Construtores

NotifyIcon() NotifyIcon() NotifyIcon() NotifyIcon()

Inicializa uma nova instância da classe NotifyIcon.Initializes a new instance of the NotifyIcon class.

NotifyIcon(IContainer) NotifyIcon(IContainer) NotifyIcon(IContainer) NotifyIcon(IContainer)

Inicializa uma nova instância da classe NotifyIcon com o contêiner especificado.Initializes a new instance of the NotifyIcon class with the specified container.

Propriedades

BalloonTipIcon BalloonTipIcon BalloonTipIcon BalloonTipIcon

Obtém ou define o ícone a ser exibido na dica de balão associada ao NotifyIcon.Gets or sets the icon to display on the balloon tip associated with the NotifyIcon.

BalloonTipText BalloonTipText BalloonTipText BalloonTipText

Obtém ou define o texto a ser exibido na dica de balão associada ao NotifyIcon.Gets or sets the text to display on the balloon tip associated with the NotifyIcon.

BalloonTipTitle BalloonTipTitle BalloonTipTitle BalloonTipTitle

Obtém ou define o título da dica de balão exibida no NotifyIcon.Gets or sets the title of the balloon tip displayed on the NotifyIcon.

CanRaiseEvents CanRaiseEvents CanRaiseEvents CanRaiseEvents

Obtém um valor que indica se o componente pode acionar um evento.Gets a value indicating whether the component can raise an event.

(Inherited from Component)
Container Container Container Container

Obtém o IContainer que contém o Component.Gets the IContainer that contains the Component.

(Inherited from Component)
ContextMenu ContextMenu ContextMenu ContextMenu

Obtém ou define o menu de atalho do ícone.Gets or sets the shortcut menu for the icon.

ContextMenuStrip ContextMenuStrip ContextMenuStrip ContextMenuStrip

Obtém ou define o menu de atalho associado ao NotifyIcon.Gets or sets the shortcut menu associated with the NotifyIcon.

DesignMode DesignMode DesignMode DesignMode

Obtém um valor que indica se o Component está no modo de design no momento.Gets a value that indicates whether the Component is currently in design mode.

(Inherited from Component)
Events Events Events Events

Obtém a lista de manipuladores de eventos que estão anexados a este Component.Gets the list of event handlers that are attached to this Component.

(Inherited from Component)
Icon Icon Icon Icon

Obtém ou define o ícone atual.Gets or sets the current icon.

Site Site Site Site

Obtém ou define o ISite do Component.Gets or sets the ISite of the Component.

(Inherited from Component)
Tag Tag Tag Tag

Obtém ou define um objeto que contém dados sobre o NotifyIcon.Gets or sets an object that contains data about the NotifyIcon.

Text Text Text Text

Obtém ou define o texto da dica de ferramenta que é exibido quando o ponteiro do mouse repousa sobre um ícone da área de notificação.Gets or sets the ToolTip text displayed when the mouse pointer rests on a notification area icon.

Visible Visible Visible Visible

Obtém ou define um valor que indica se o ícone está visível na área de notificação da barra de tarefas.Gets or sets a value indicating whether the icon is visible in the notification area of the taskbar.

Métodos

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

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.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

Libera todos os recursos usados pelo Component.Releases all resources used by the Component.

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera os recursos não gerenciados usados pelo Component e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Recupera o objeto de serviço de tempo de vida atual que controla a política de ciclo de vida para esta instância.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

Retorna um objeto que representa um serviço fornecido pelo Component ou pelo seu Container.Returns an object that represents a service provided by the Component or by its Container.

(Inherited from Component)
GetType() GetType() GetType() GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Obtém um objeto de serviço de tempo de vida para controlar a política de tempo de vida para essa instância.Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Cria uma cópia superficial do objeto MarshalByRefObject atual.Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
ShowBalloonTip(Int32) ShowBalloonTip(Int32) ShowBalloonTip(Int32) ShowBalloonTip(Int32)

Exibe uma dica de balão na barra de tarefas durante o tempo especificado.Displays a balloon tip in the taskbar for the specified time period.

ShowBalloonTip(Int32, String, String, ToolTipIcon) ShowBalloonTip(Int32, String, String, ToolTipIcon) ShowBalloonTip(Int32, String, String, ToolTipIcon) ShowBalloonTip(Int32, String, String, ToolTipIcon)

Exibe uma dica de balão com o título, texto e ícone especificados na barra de tarefas durante o período especificado.Displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period.

ToString() ToString() ToString() ToString()

Retorna um String que contém o nome do Component, se houver.Returns a String containing the name of the Component, if any. Esse método não deve ser substituído.This method should not be overridden.

(Inherited from Component)

Eventos

BalloonTipClicked BalloonTipClicked BalloonTipClicked BalloonTipClicked

Ocorre quando a dica de balão recebe um clique.Occurs when the balloon tip is clicked.

BalloonTipClosed BalloonTipClosed BalloonTipClosed BalloonTipClosed

Ocorre quando a dica de balão é fechada pelo usuário.Occurs when the balloon tip is closed by the user.

BalloonTipShown BalloonTipShown BalloonTipShown BalloonTipShown

Ocorre quando a dica de balão é exibida na tela.Occurs when the balloon tip is displayed on the screen.

Click Click Click Click

Ocorre quando o usuário clica no ícone na área de notificação.Occurs when the user clicks the icon in the notification area.

Disposed Disposed Disposed Disposed

Ocorre quando o componente é disposto por uma chamada para o método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
DoubleClick DoubleClick DoubleClick DoubleClick

Ocorre quando o usuário clica duas vezes no ícone da área de notificação da barra de tarefas.Occurs when the user double-clicks the icon in the notification area of the taskbar.

MouseClick MouseClick MouseClick MouseClick

Ocorre quando o usuário clica em um NotifyIcon com o mouse.Occurs when the user clicks a NotifyIcon with the mouse.

MouseDoubleClick MouseDoubleClick MouseDoubleClick MouseDoubleClick

Ocorre quando o usuário clica duas vezes no NotifyIcon com o mouse.Occurs when the user double-clicks the NotifyIcon with the mouse.

MouseDown MouseDown MouseDown MouseDown

Ocorre quando o usuário pressiona o botão do mouse enquanto o ponteiro está sobre o ícone na área de notificação da barra de tarefas.Occurs when the user presses the mouse button while the pointer is over the icon in the notification area of the taskbar.

MouseMove MouseMove MouseMove MouseMove

Ocorre quando o usuário move o mouse enquanto o ponteiro está sobre o ícone na área de notificação da barra de tarefas.Occurs when the user moves the mouse while the pointer is over the icon in the notification area of the taskbar.

MouseUp MouseUp MouseUp MouseUp

Ocorre quando o usuário libera o botão do mouse enquanto o ponteiro está sobre o ícone na área de notificação da barra de tarefas.Occurs when the user releases the mouse button while the pointer is over the icon in the notification area of the taskbar.

Segurança

UIPermission
para criar o NotifyIcon componente.to create the NotifyIcon component. Enumeração associada: AllWindowsAssociated enumeration: AllWindows

Aplica-se a