Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase NotifyIcon

 

Publicado: octubre de 2016

Especifica un componente que crea un icono en el área de notificación. Esta clase no puede heredarse.

Espacio de nombres:   System.Windows.Forms
Ensamblado:  System.Windows.Forms (en System.Windows.Forms.dll)

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      System.Windows.Forms.NotifyIcon

public sealed class NotifyIcon : Component

NombreDescripción
System_CAPS_pubmethodNotifyIcon()

Inicializa una nueva instancia de la clase NotifyIcon.

System_CAPS_pubmethodNotifyIcon(IContainer)

Inicializa una nueva instancia de la clase NotifyIcon con el contenedor especificado.

NombreDescripción
System_CAPS_pubpropertyBalloonTipIcon

Obtiene o establece el icono que se muestra en el globo de sugerencias asociado al NotifyIcon.

System_CAPS_pubpropertyBalloonTipText

Obtiene o establece el texto que se muestra en el globo de sugerencias asociado al NotifyIcon.

System_CAPS_pubpropertyBalloonTipTitle

Obtiene o establece el título del globo de sugerencias mostrado en el NotifyIcon.

System_CAPS_pubpropertyContainer

Obtiene IContainer que contiene Component.(Heredado de Component).

System_CAPS_pubpropertyContextMenu

Obtiene o establece el menú contextual para el icono.

System_CAPS_pubpropertyContextMenuStrip

Obtiene o establece el menú contextual asociado al NotifyIcon.

System_CAPS_pubpropertyIcon

Obtiene o establece el sitio actual.

System_CAPS_pubpropertySite

Obtiene o establece la ISite de la Component.(Heredado de Component).

System_CAPS_pubpropertyTag

Obtiene o establece un objeto que contiene datos sobre el NotifyIcon.

System_CAPS_pubpropertyText

Obtiene o establece el texto de información sobre herramientas que aparece cuando se sitúa el puntero en un icono del área de notificación.

System_CAPS_pubpropertyVisible

Obtiene o establece un valor que indica si el icono es visible en el área de notificación de la barra de tareas.

NombreDescripción
System_CAPS_pubmethodCreateObjRef(Type)

Crea un objeto que contiene toda la información pertinente necesaria para generar a un proxy utilizado para comunicarse con un objeto remoto.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodDispose()

Libera todos los recursos que usa Component.(Heredado de Component).

System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetLifetimeService()

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_pubmethodInitializeLifetimeService()

Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia.(Heredado de MarshalByRefObject).

System_CAPS_pubmethodShowBalloonTip(Int32)

Muestra un globo de sugerencias en la barra de tareas para el período de tiempo especificado.

System_CAPS_pubmethodShowBalloonTip(Int32, String, String, ToolTipIcon)

Muestra un globo de sugerencias con el título, el texto y el icono especificado en la barra de tareas para el período de tiempo especificado.

System_CAPS_pubmethodToString()

Devuelve un String que contiene el nombre de la Component, si existe. Este método no se debe invalidar.(Heredado de Component).

NombreDescripción
System_CAPS_pubeventBalloonTipClicked

Se produce al hacer clic en el globo de sugerencias.

System_CAPS_pubeventBalloonTipClosed

Se produce cuando el usuario cierra el globo de sugerencias.

System_CAPS_pubeventBalloonTipShown

Se produce cuando el globo de sugerencias se muestra en la pantalla.

System_CAPS_pubeventClick

Ocurre cuando el usuario hace clic en el icono del área de notificación.

System_CAPS_pubeventDisposed

Se produce cuando el componente se elimina mediante una llamada a la Dispose (método).(Heredado de Component).

System_CAPS_pubeventDoubleClick

Ocurre cuando el usuario hace doble clic en el icono del área de notificación de la barra de tareas.

System_CAPS_pubeventMouseClick

Se produce cuando el usuario hace clic en un nodo NotifyIcon con el mouse.

System_CAPS_pubeventMouseDoubleClick

Se produce cuando el usuario hace doble clic con el mouse en el NotifyIcon.

System_CAPS_pubeventMouseDown

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.

System_CAPS_pubeventMouseMove

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.

System_CAPS_pubeventMouseUp

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.

Iconos en el área de notificación son accesos directos a procesos que se ejecutan en segundo plano de un equipo, como un programa antivirus o un control de volumen. Estos procesos no se incluyen en sus propias interfaces de usuario. La NotifyIcon clase proporciona una manera de programar en esta funcionalidad. El Icon propiedad define el icono que aparece en el área de notificación. Menús emergentes de un icono se definen con el ContextMenu propiedad. El Text propiedad asigna texto de información sobre herramientas. Para el icono aparezca en el área de notificación, la Visible propiedad debe establecerse en true.

En el ejemplo de código siguiente se muestra cómo utilizar el NotifyIcon clase para mostrar un icono para una aplicación en el área de notificación. En el ejemplo se muestra cómo establecer el Icon, ContextMenu, Text, y Visible Propiedades y el control de la DoubleClick eventos. Un ContextMenu con un Exit elemento se asigna a la NotifyIcon.ContextMenu propiedad, que permite al usuario cerrar la aplicación. Cuando el DoubleClick evento se produce, se activa el formulario de la aplicación mediante una llamada a la Form.Activate (método).

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();
    }
}

UIPermission

to create the T:System.Windows.Forms.NotifyIcon component. Associated enumeration: F:System.Security.Permissions.UIPermissionWindow.AllWindows

.NET Framework
Disponible desde 1.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: