NotifyIcon Classe

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

NotifyIcon.cs

Spécifie un composant qui crée une icône dans la zone de notification. Cette classe ne peut pas être héritée.

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

Héritage

Object

MarshalByRefObject

Component

NotifyIcon

Exemples

L’exemple de code suivant illustre l’utilisation de la NotifyIcon classe pour afficher une icône pour une application dans la zone de notification. L’exemple montre comment définir les Iconpropriétés et VisibleContextMenuTextla gestion de l’événementDoubleClick. Un ContextMenu élément Exit sur lequel il est affecté à la NotifyIcon.ContextMenu propriété, ce qui permet à l’utilisateur de fermer l’application. Lorsque l’événement DoubleClick se produit, le formulaire d’application est activé en appelant la Form.Activate méthode.

#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

Remarques

Les icônes de la zone de notification sont des raccourcis vers les processus qui s’exécutent en arrière-plan d’un ordinateur, tels qu’un programme de protection antivirus ou un contrôle de volume. Ces processus ne sont pas fournis avec leurs propres interfaces utilisateur. La NotifyIcon classe fournit un moyen de programmer dans cette fonctionnalité. La Icon propriété définit l’icône qui apparaît dans la zone de notification. Les menus contextuels d’une icône sont traités avec la ContextMenu propriété. La propriété affecte du Text texte Info-bulle. Pour que l’icône s’affiche dans la zone de notification, la Visible propriété doit être définie truesur .

Constructeurs

Nom	Description
NotifyIcon()	Initialise une nouvelle instance de la classe NotifyIcon.
NotifyIcon(IContainer)	Initialise une nouvelle instance de la NotifyIcon classe avec le conteneur spécifié.

Propriétés

Nom	Description
BalloonTipIcon	Obtient ou définit l’icône à afficher sur l’info-bulle associée au NotifyIcon.
BalloonTipText	Obtient ou définit le texte à afficher sur l’info-bulle associée au NotifyIcon.
BalloonTipTitle	Obtient ou définit le titre de la bulle affichée sur le NotifyIcon.
ContextMenuStrip	Obtient ou définit le menu contextuel associé au NotifyIcon.
Icon	Obtient ou définit l’icône actuelle.
Tag	Obtient ou définit un objet qui contient des données sur le NotifyIcon.
Text	Obtient ou définit le texte info-bulle affiché lorsque le pointeur de la souris se trouve sur une icône de zone de notification.
Visible	Obtient ou définit une valeur indiquant si l’icône est visible dans la zone de notification de la barre des tâches.

Méthodes

Nom	Description
ShowBalloonTip(Int32, String, String, ToolTipIcon)	Affiche une bulle avec le titre, le texte et l’icône spécifiés dans la barre des tâches pour la période spécifiée.
ShowBalloonTip(Int32)	Affiche une bulle dans la barre des tâches pour la période spécifiée.

Événements

Nom	Description
BalloonTipClicked	Se produit lorsque l’info-bulle est cliqué.
BalloonTipClosed	Se produit lorsque l’info-bulle est fermée par l’utilisateur.
BalloonTipShown	Se produit lorsque l’info-bulle s’affiche à l’écran.
Click	Se produit lorsque l’utilisateur clique sur l’icône dans la zone de notification.
DoubleClick	Se produit lorsque l’utilisateur double-clique sur l’icône dans la zone de notification de la barre des tâches.
MouseClick	Se produit lorsque l’utilisateur clique sur une NotifyIcon souris.
MouseDoubleClick	Se produit lorsque l’utilisateur double-clique sur le NotifyIcon bouton avec la souris.
MouseDown	Se produit lorsque l’utilisateur appuie sur le bouton de la souris pendant que le pointeur se trouve sur l’icône dans la zone de notification de la barre des tâches.
MouseMove	Se produit lorsque l’utilisateur déplace la souris pendant que le pointeur se trouve sur l’icône dans la zone de notification de la barre des tâches.
MouseUp	Se produit lorsque l’utilisateur relâche le bouton de la souris pendant que le pointeur se trouve sur l’icône dans la zone de notification de la barre des tâches.