NotifyIcon Klasa

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Źródło:

NotifyIcon.cs

Określa składnik, który tworzy ikonę w obszarze powiadomień. Tej klasy nie można dziedziczyć.

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

Dziedziczenie

Object

MarshalByRefObject

Component

NotifyIcon

Przykłady

W poniższym przykładzie kodu pokazano użycie NotifyIcon klasy do wyświetlenia ikony aplikacji w obszarze powiadomień. W tym przykładzie pokazano ustawienie Iconwłaściwości , ContextMenui VisibleTextoraz obsługę zdarzeniaDoubleClick. Element ContextMenu Exit ( Zakończ ) jest przypisany do NotifyIcon.ContextMenu właściwości , która umożliwia użytkownikowi zamknięcie aplikacji. Po wystąpieniu DoubleClick zdarzenia formularz aplikacji jest aktywowany przez wywołanie Form.Activate metody .

#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

Uwagi

Ikony w obszarze powiadomień to skróty do procesów uruchomionych w tle komputera, takich jak program ochrony przed wirusami lub kontrolka głośności. Te procesy nie są dostarczane z własnymi interfejsami użytkownika. Klasa NotifyIcon zapewnia sposób programowania w tej funkcji. Właściwość Icon definiuje ikonę wyświetlaną w obszarze powiadomień. Menu podręczne ikony są adresowane za ContextMenu pomocą właściwości . Właściwość Text przypisuje tekst etykietki narzędzia. Aby ikona pojawiła się w obszarze powiadomień, Visible właściwość musi być ustawiona na true.

Konstruktory

Nazwa	Opis
NotifyIcon()	Inicjuje nowe wystąpienie klasy NotifyIcon.
NotifyIcon(IContainer)	Inicjuje nowe wystąpienie NotifyIcon klasy przy użyciu określonego kontenera.

Właściwości

Nazwa	Opis
BalloonTipIcon	Pobiera lub ustawia ikonę wyświetlaną na wskazówce balonu skojarzonej z elementem NotifyIcon.
BalloonTipText	Pobiera lub ustawia tekst wyświetlany na wskazówce balonu skojarzonej z elementem NotifyIcon.
BalloonTipTitle	Pobiera lub ustawia tytuł końcówki balonu wyświetlanej NotifyIconna .
ContextMenuStrip	Pobiera lub ustawia menu skrótów skojarzone z elementem NotifyIcon.
Icon	Pobiera lub ustawia bieżącą ikonę.
Tag	Pobiera lub ustawia obiekt zawierający dane dotyczące obiektu NotifyIcon.
Text	Pobiera lub ustawia tekst etykietki narzędzia wyświetlany, gdy wskaźnik myszy znajduje się na ikonie obszaru powiadomień.
Visible	Pobiera lub ustawia wartość wskazującą, czy ikona jest widoczna w obszarze powiadomień paska zadań.

Metody

Nazwa	Opis
ShowBalloonTip(Int32, String, String, ToolTipIcon)	Wyświetla poradę balonu z określonym tytułem, tekstem i ikoną na pasku zadań dla określonego okresu.
ShowBalloonTip(Int32)	Wyświetla poradę balonu na pasku zadań dla określonego okresu.

Zdarzenia

Nazwa	Opis
BalloonTipClicked	Występuje po kliknięciu końcówki balonu.
BalloonTipClosed	Występuje, gdy porada balonu jest zamykana przez użytkownika.
BalloonTipShown	Występuje, gdy na ekranie jest wyświetlana porada balonu.
Click	Występuje, gdy użytkownik kliknie ikonę w obszarze powiadomień.
DoubleClick	Występuje, gdy użytkownik kliknie dwukrotnie ikonę w obszarze powiadomień paska zadań.
MouseClick	Występuje, gdy użytkownik klika NotifyIcon wskaźnik myszy.
MouseDoubleClick	Występuje, gdy użytkownik klika NotifyIcon dwukrotnie wskaźnik myszy.
MouseDown	Występuje, gdy użytkownik naciska przycisk myszy, gdy wskaźnik znajduje się na ikonie w obszarze powiadomień paska zadań.
MouseMove	Występuje, gdy użytkownik przesuwa wskaźnik myszy, gdy wskaźnik znajduje się nad ikoną w obszarze powiadomień paska zadań.
MouseUp	Występuje, gdy użytkownik zwalnia przycisk myszy, gdy wskaźnik znajduje się nad ikoną w obszarze powiadomień paska zadań.