NotifyIcon Clase

Definición

Especifica un componente que crea un icono en el área de notificación.Specifies a component that creates an icon in the notification area. Esta clase no puede heredarse.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
Herencia

Ejemplos

En el ejemplo de código siguiente se NotifyIcon muestra cómo usar la clase para mostrar un icono para una aplicación en el área de notificación.The following code example demonstrates using the NotifyIcon class to display an icon for an application in the notification area. En el ejemplo se muestra Iconcómo ContextMenuestablecer Textlas Visible propiedades,, y y DoubleClick cómo controlar el evento.The example demonstrates setting the Icon, ContextMenu, Text, and Visible properties and handling the DoubleClick event. Un ContextMenu elemento con un elemento de salida se asigna a la NotifyIcon.ContextMenu propiedad, lo que permite al usuario cerrar la aplicación.A ContextMenu with an Exit item on it is assigned to the NotifyIcon.ContextMenu property, which allows the user to close the application. Cuando se DoubleClick produce el evento, el formulario de la aplicación se activa Form.Activate mediante una llamada al 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

Comentarios

Los iconos del área de notificación son accesos directos a los procesos que se ejecutan en segundo plano en un equipo, como un programa de protección antivirus o un control de volumen.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. Estos procesos no tienen sus propias interfaces de usuario.These processes do not come with their own user interfaces. La NotifyIcon clase proporciona una manera de programar en esta funcionalidad.The NotifyIcon class provides a way to program in this functionality. La Icon propiedad define el icono que aparece en el área de notificación.The Icon property defines the icon that appears in the notification area. Los menús emergentes de un icono se direccionan con ContextMenu la propiedad.Pop-up menus for an icon are addressed with the ContextMenu property. La Text propiedad asigna el texto de información sobre herramientas.The Text property assigns ToolTip text. Para que el icono se muestre en el área de notificación, la Visible propiedad debe trueestablecerse en.In order for the icon to show up in the notification area, the Visible property must be set to true.

Constructores

NotifyIcon()

Inicializa una nueva instancia de la clase NotifyIcon.Initializes a new instance of the NotifyIcon class.

NotifyIcon(IContainer)

Inicializa una nueva instancia de la clase NotifyIcon con el contenedor especificado.Initializes a new instance of the NotifyIcon class with the specified container.

Propiedades

BalloonTipIcon

Obtiene o establece el icono que se muestra en el globo de sugerencias asociado al NotifyIcon.Gets or sets the icon to display on the balloon tip associated with the NotifyIcon.

BalloonTipText

Obtiene o establece el texto que se muestra en el globo de sugerencias asociado al NotifyIcon.Gets or sets the text to display on the balloon tip associated with the NotifyIcon.

BalloonTipTitle

Obtiene o establece el título del globo de sugerencias mostrado en el NotifyIcon.Gets or sets the title of the balloon tip displayed on the NotifyIcon.

CanRaiseEvents

Obtiene un valor que indica si el componente puede generar un evento.Gets a value indicating whether the component can raise an event.

(Heredado de Component)
Container

Obtiene IContainer que contiene Component.Gets the IContainer that contains the Component.

(Heredado de Component)
ContextMenu

Obtiene o establece el menú contextual para el icono.Gets or sets the shortcut menu for the icon.

ContextMenuStrip

Obtiene o establece el menú contextual asociado al NotifyIcon.Gets or sets the shortcut menu associated with the NotifyIcon.

DesignMode

Obtiene un valor que indica si Component está actualmente en modo de diseño.Gets a value that indicates whether the Component is currently in design mode.

(Heredado de Component)
Events

Obtiene la lista de controladores de eventos asociados a Component.Gets the list of event handlers that are attached to this Component.

(Heredado de Component)
Icon

Obtiene o establece el icono actual.Gets or sets the current icon.

Site

Obtiene o establece el ISite de Component.Gets or sets the ISite of the Component.

(Heredado de Component)
Tag

Obtiene o establece un objeto que contiene datos sobre el control NotifyIcon.Gets or sets an object that contains data about the NotifyIcon.

Text

Obtiene o establece el texto de la información sobre herramientas que se muestra cuando el mouse se sitúa sobre un icono del área de notificación.Gets or sets the ToolTip text displayed when the mouse pointer rests on a notification area icon.

Visible

Obtiene o establece un valor que indica si el icono es visible en el área de notificación de la barra de tareas.Gets or sets a value indicating whether the icon is visible in the notification area of the taskbar.

Métodos

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Dispose()

Libera todos los recursos que usa Component.Releases all resources used by the Component.

(Heredado de Component)
Dispose(Boolean)

Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Heredado de Component)
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetService(Type)

Devuelve un objeto que representa el servicio suministrado por Component o por Container.Returns an object that represents a service provided by the Component or by its Container.

(Heredado de Component)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
ShowBalloonTip(Int32)

Muestra un globo de sugerencias en la barra de tareas correspondiente al período de tiempo especificado.Displays a balloon tip in the taskbar for the specified time period.

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Muestra un globo de sugerencias con el título, texto e icono especificados en la barra de tareas para el período de tiempo determinado.Displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period.

ToString()

Devuelve una String que contiene el nombre del Component, si existe.Returns a String containing the name of the Component, if any. Este método no se debe invalidar.This method should not be overridden.

(Heredado de Component)

Eventos

BalloonTipClicked

Se produce al hacer clic en el globo de sugerencias.Occurs when the balloon tip is clicked.

BalloonTipClosed

Se produce cuando el usuario cierra el globo de sugerencias.Occurs when the balloon tip is closed by the user.

BalloonTipShown

Se produce cuando el globo de sugerencias se muestra en la pantalla.Occurs when the balloon tip is displayed on the screen.

Click

Ocurre cuando el usuario hace clic en el icono del área de notificación.Occurs when the user clicks the icon in the notification area.

Disposed

Se produce cuando el componente se elimina mediante una llamada al método Dispose().Occurs when the component is disposed by a call to the Dispose() method.

(Heredado de Component)
DoubleClick

Se produce cuando el usuario hace doble clic en el icono del área de notificación de la barra de tareas.Occurs when the user double-clicks the icon in the notification area of the taskbar.

MouseClick

Se produce cuando el usuario hace clic en un nodo NotifyIcon con el mouse.Occurs when the user clicks a NotifyIcon with the mouse.

MouseDoubleClick

Aparece cuando el usuario hace doble clic en el control NotifyIcon con el mouse.Occurs when the user double-clicks the NotifyIcon with the mouse.

MouseDown

Se produce cuando el usuario presiona el botón del mouse mientras el puntero está sobre el icono del área de notificación de la barra de tareas.Occurs when the user presses the mouse button while the pointer is over the icon in the notification area of the taskbar.

MouseMove

Se produce cuando el usuario mueve el mouse mientras el puntero está sobre el icono del área de notificación de la barra de tareas.Occurs when the user moves the mouse while the pointer is over the icon in the notification area of the taskbar.

MouseUp

Se produce cuando el usuario suelta el botón del mouse mientras el puntero está sobre el icono del área de notificación de la barra de tareas.Occurs when the user releases the mouse button while the pointer is over the icon in the notification area of the taskbar.

Seguridad

UIPermission
para crear el NotifyIcon componente.to create the NotifyIcon component. Enumeración asociada:AllWindowsAssociated enumeration: AllWindows

Se aplica a