NotifyIcon Klasa

Definicja

Określa składnik, który tworzy ikonę w obszarze powiadomień.Specifies a component that creates an icon in the notification area. Klasa ta nie może być dziedziczona.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
Dziedziczenie

Przykłady

Poniższy przykład kodu demonstruje użycie NotifyIcon klasy do wyświetlania ikony aplikacji w obszarze powiadomień.The following code example demonstrates using the NotifyIcon class to display an icon for an application in the notification area. W przykładzie pokazano Icon , jak ustawić ContextMenu właściwości,, Text , i Visible obsłużyć DoubleClick zdarzenie.The example demonstrates setting the Icon, ContextMenu, Text, and Visible properties and handling the DoubleClick event. ContextMenuElement z elementem zamykającym jest przypisany do NotifyIcon.ContextMenu właściwości, co umożliwia użytkownikowi zamknięcie aplikacji.A ContextMenu with an Exit item on it is assigned to the NotifyIcon.ContextMenu property, which allows the user to close the application. Gdy DoubleClick wystąpi zdarzenie, formularz aplikacji jest uaktywniany przez wywołanie Form.Activate metody.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

Uwagi

Ikony w obszarze powiadomień to skróty do procesów uruchomionych w tle komputera, takich jak program ochrony przed wirusami lub kontrolka woluminu.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. Procesy te nie są powiązane z własnymi interfejsami użytkownika.These processes do not come with their own user interfaces. NotifyIconKlasa zapewnia sposób programowania w tej funkcji.The NotifyIcon class provides a way to program in this functionality. IconWłaściwość definiuje ikonę wyświetlaną w obszarze powiadomień.The Icon property defines the icon that appears in the notification area. Menu podręczne dla ikony jest rozwiązywane z ContextMenu właściwością.Pop-up menus for an icon are addressed with the ContextMenu property. TextWłaściwość przypisuje tekst etykietki narzędzia.The Text property assigns ToolTip text. Aby ikona była wyświetlana w obszarze powiadomień, Visible Właściwość musi być ustawiona na wartość true .In order for the icon to show up in the notification area, the Visible property must be set to true.

Konstruktory

NotifyIcon()

Inicjuje nowe wystąpienie klasy NotifyIcon.Initializes a new instance of the NotifyIcon class.

NotifyIcon(IContainer)

Inicjuje nowe wystąpienie NotifyIcon klasy z określonym kontenerem.Initializes a new instance of the NotifyIcon class with the specified container.

Właściwości

BalloonTipIcon

Pobiera lub ustawia ikonę, która zostanie wyświetlona na etykietce dymka skojarzonej z NotifyIcon .Gets or sets the icon to display on the balloon tip associated with the NotifyIcon.

BalloonTipText

Pobiera lub ustawia tekst, który będzie wyświetlany w poradach dymków skojarzonych z NotifyIcon .Gets or sets the text to display on the balloon tip associated with the NotifyIcon.

BalloonTipTitle

Pobiera lub ustawia tytuł porady dymkowej wyświetlanej w NotifyIcon .Gets or sets the title of the balloon tip displayed on the NotifyIcon.

CanRaiseEvents

Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie.Gets a value indicating whether the component can raise an event.

(Odziedziczone po Component)
Container

Pobiera IContainer , który zawiera Component .Gets the IContainer that contains the Component.

(Odziedziczone po Component)
ContextMenu

Pobiera lub ustawia menu skrótów dla ikony.Gets or sets the shortcut menu for the icon.

ContextMenuStrip

Pobiera lub ustawia menu skrótów skojarzone z NotifyIcon .Gets or sets the shortcut menu associated with the NotifyIcon.

DesignMode

Pobiera wartość wskazującą, czy Component jest aktualnie w trybie projektowania.Gets a value that indicates whether the Component is currently in design mode.

(Odziedziczone po Component)
Events

Pobiera listę programów obsługi zdarzeń, które są dołączone do tego elementu Component .Gets the list of event handlers that are attached to this Component.

(Odziedziczone po Component)
Icon

Pobiera lub ustawia bieżącą ikonę.Gets or sets the current icon.

Site

Pobiera lub ustawia wartość ISite Component .Gets or sets the ISite of the Component.

(Odziedziczone po Component)
Tag

Pobiera lub ustawia obiekt, który zawiera dane o NotifyIcon .Gets or sets an object that contains data about the NotifyIcon.

Text

Pobiera lub ustawia tekst etykietki narzędzia wyświetlany, gdy wskaźnik myszy zatrzyma się na ikonie obszaru powiadomień.Gets or sets the ToolTip text displayed when the mouse pointer rests on a notification area icon.

Visible

Pobiera lub ustawia wartość wskazującą, czy ikona jest widoczna w obszarze powiadomień paska zadań.Gets or sets a value indicating whether the icon is visible in the notification area of the taskbar.

Metody

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Dispose()

Zwalnia wszelkie zasoby używane przez element Component.Releases all resources used by the Component.

(Odziedziczone po Component)
Dispose(Boolean)

Zwalnia zasoby niezarządzane używane przez element Component i opcjonalnie zwalnia zasoby zarządzane.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Odziedziczone po Component)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLifetimeService()

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetService(Type)

Zwraca obiekt, który reprezentuje usługę dostarczoną przez Component lub przez Container .Returns an object that represents a service provided by the Component or by its Container.

(Odziedziczone po Component)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
InitializeLifetimeService()

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
ShowBalloonTip(Int32)

Wyświetla wskazówkę dymek na pasku zadań w określonym przedziale czasu.Displays a balloon tip in the taskbar for the specified time period.

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Wyświetla poradę dymkową o określonym tytule, tekście i ikonie na pasku zadań w określonym przedziale czasu.Displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period.

ToString()

Zwraca wartość String zawierającą nazwę Component (jeśli istnieje).Returns a String containing the name of the Component, if any. Ta metoda nie powinna być przesłaniana.This method should not be overridden.

(Odziedziczone po Component)

Zdarzenia

BalloonTipClicked

Występuje po kliknięciu wskazówki dymek.Occurs when the balloon tip is clicked.

BalloonTipClosed

Występuje po zamknięciu przez użytkownika porady dymkowej.Occurs when the balloon tip is closed by the user.

BalloonTipShown

Występuje, gdy na ekranie zostanie wyświetlona etykietka dymka.Occurs when the balloon tip is displayed on the screen.

Click

Występuje, gdy użytkownik kliknie ikonę w obszarze powiadomień.Occurs when the user clicks the icon in the notification area.

Disposed

Występuje, gdy składnik zostanie usunięty przez wywołanie Dispose() metody.Occurs when the component is disposed by a call to the Dispose() method.

(Odziedziczone po Component)
DoubleClick

Występuje, gdy użytkownik kliknie dwukrotnie ikonę w obszarze powiadomień na pasku zadań.Occurs when the user double-clicks the icon in the notification area of the taskbar.

MouseClick

Występuje, gdy użytkownik kliknie ikonę NotifyIcon z myszą.Occurs when the user clicks a NotifyIcon with the mouse.

MouseDoubleClick

Występuje, gdy użytkownik kliknie dwukrotnie ikonę NotifyIcon z myszą.Occurs when the user double-clicks the NotifyIcon with the mouse.

MouseDown

Występuje, gdy użytkownik naciśnie przycisk myszy, gdy wskaźnik znajduje się nad ikoną w obszarze powiadomień na pasku zadań.Occurs when the user presses the mouse button while the pointer is over the icon in the notification area of the taskbar.

MouseMove

Występuje, gdy użytkownik przesuwa mysz, gdy wskaźnik znajduje się nad ikoną w obszarze powiadomień na pasku zadań.Occurs when the user moves the mouse while the pointer is over the icon in the notification area of the taskbar.

MouseUp

Występuje, gdy użytkownik zwolni przycisk myszy, gdy wskaźnik znajduje się nad ikoną w obszarze powiadomień na pasku zadań.Occurs when the user releases the mouse button while the pointer is over the icon in the notification area of the taskbar.

Dotyczy