NotifyIcon Osztály

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

NotifyIcon.cs

Olyan összetevőt ad meg, amely ikont hoz létre az értesítési területen. Ez az osztály nem örökölhető.

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

Öröklődés

Object

MarshalByRefObject

Component

NotifyIcon

Példák

Az alábbi példakód azt mutatja be, hogy az NotifyIcon osztály használatával megjeleníthető egy alkalmazás ikonja az értesítési területen. A példa bemutatja a Icon, , ContextMenuText, és tulajdonságok beállítását és Visible az DoubleClick esemény kezelését. A ContextMenu tulajdonsághoz egy kilépési elem van rendelve NotifyIcon.ContextMenu , amely lehetővé teszi a felhasználó számára az alkalmazás bezárását. Az esemény bekövetkezésekor az DoubleClick alkalmazásűrlap aktiválása a Form.Activate metódus meghívásával történik.

#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

Megjegyzések

Az értesítési területen található ikonok a számítógép hátterében futó folyamatok, például egy vírusvédelmi program vagy egy hangerő-vezérlés parancsikonjai. Ezek a folyamatok nem rendelkeznek saját felhasználói felülettel. Az NotifyIcon osztály lehetővé teszi, hogy programozza ezt a funkciót. A Icon tulajdonság határozza meg az értesítési területen megjelenő ikont. Az ikonok előugró menüi a ContextMenu tulajdonsággal vannak megcímezve. A Text tulajdonság elemleírás-szöveget rendel hozzá. Ahhoz, hogy az ikon megjelenjen az értesítési területen, a tulajdonságnak a Visible következőre kell állítania true: .

Konstruktorok

Név	Description
NotifyIcon()	Inicializálja a NotifyIcon osztály új példányát.
NotifyIcon(IContainer)	Inicializálja az osztály új példányát NotifyIcon a megadott tárolóval.

Tulajdonságok

Név	Description
BalloonTipIcon	Lekéri vagy beállítja az ikont, hogy megjelenjen a ballon csúcsán, amely a NotifyIcon.
BalloonTipText	Lekéri vagy beállítja a szöveg megjelenítését a ballonhegyen, amely a NotifyIcon.
BalloonTipTitle	Lekéri vagy beállítja a ballonhegy címét a NotifyIcon.
ContextMenuStrip	Lekéri vagy beállítja a parancshoz társított helyi menüt NotifyIcon.
Icon	Lekéri vagy beállítja az aktuális ikont.
Tag	Lekéri vagy beállít egy objektumot, amely adatokat tartalmaz a NotifyIcon.
Text	Lekéri vagy beállítja az elemleírás szövegét, amikor az egérmutató egy értesítési terület ikonján van.
Visible	Lekéri vagy beállít egy értéket, amely jelzi, hogy az ikon látható-e a tálca értesítési területén.

Metódusok

Név	Description
ShowBalloonTip(Int32, String, String, ToolTipIcon)	Egy buborékhegyet jelenít meg a megadott címmel, szöveggel és ikonnal a tálcán a megadott időszakra vonatkozóan.
ShowBalloonTip(Int32)	Buborékhegyet jelenít meg a tálcán a megadott időszakra vonatkozóan.

esemény

Név	Description
BalloonTipClicked	Akkor fordul elő, ha a ballonhegyre kattint.
BalloonTipClosed	Akkor fordul elő, ha a felhasználó bezárja a ballonhegyet.
BalloonTipShown	Akkor fordul elő, ha a buborékhegy megjelenik a képernyőn.
Click	Akkor fordul elő, ha a felhasználó az értesítési területen az ikonra kattint.
DoubleClick	Ez akkor fordul elő, ha a felhasználó duplán kattint az ikonra a tálca értesítési területén.
MouseClick	Akkor fordul elő, ha a felhasználó az egérrel rákattint egy NotifyIcon elemre.
MouseDoubleClick	Akkor fordul elő, ha a felhasználó duplán kattint az NotifyIcon egérrel.
MouseDown	Ez akkor fordul elő, ha a felhasználó lenyomja az egérgombot, miközben az egérmutató a tálca értesítési területén található ikon felett van.
MouseMove	Ez akkor fordul elő, ha a felhasználó áthelyezi az egeret, miközben az egérmutató a tálca értesítési területén található ikon fölé kerül.
MouseUp	Ez akkor fordul elő, ha a felhasználó felengedi az egérgombot, miközben az egérmutató a tálca értesítési területén található ikon felett van.