NotifyIcon Klasse

Definition

Gibt eine Komponente an, die ein Symbol im Infobereich erstellt.Specifies a component that creates an icon in the notification area. Diese Klasse kann nicht vererbt werden.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
Vererbung

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie mithilfe der- NotifyIcon Klasse ein Symbol für eine Anwendung im Benachrichtigungsbereich angezeigt wird.The following code example demonstrates using the NotifyIcon class to display an icon for an application in the notification area. Das Beispiel veranschaulicht das Festlegen Icon der ContextMenu Eigenschaften,, Text und Visible und die Behandlung des- DoubleClick Ereignisses.The example demonstrates setting the Icon, ContextMenu, Text, and Visible properties and handling the DoubleClick event. Eine ContextMenu mit einem Exit Beendigungs Element ist der-Eigenschaft zugewiesen NotifyIcon.ContextMenu , die dem Benutzer das Schließen der Anwendung ermöglicht.A ContextMenu with an Exit item on it is assigned to the NotifyIcon.ContextMenu property, which allows the user to close the application. Wenn das- DoubleClick Ereignis auftritt, wird das Anwendungs Formular durch Aufrufen der- Form.Activate Methode aktiviert.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

Hinweise

Symbole im Benachrichtigungsbereich sind Verknüpfungen zu Prozessen, die im Hintergrund eines Computers ausgeführt werden, z. b. ein Virenschutzprogramm oder ein volumesteuerelement.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. Diese Prozesse verfügen über keine eigenen Benutzeroberflächen.These processes do not come with their own user interfaces. Die- NotifyIcon Klasse bietet eine Möglichkeit, diese Funktionalität zu programmieren.The NotifyIcon class provides a way to program in this functionality. Die- Icon Eigenschaft definiert das Symbol, das im Benachrichtigungsbereich angezeigt wird.The Icon property defines the icon that appears in the notification area. Popup Menüs für ein Symbol werden mit der-Eigenschaft adressiert ContextMenu .Pop-up menus for an icon are addressed with the ContextMenu property. Die-Eigenschaft weist QuickInfo- Text Text zu.The Text property assigns ToolTip text. Damit das Symbol im Benachrichtigungsbereich angezeigt wird, muss die- Visible Eigenschaft auf festgelegt werden true .In order for the icon to show up in the notification area, the Visible property must be set to true.

Konstruktoren

NotifyIcon()

Initialisiert eine neue Instanz der NotifyIcon-Klasse.Initializes a new instance of the NotifyIcon class.

NotifyIcon(IContainer)

Initialisiert eine neue Instanz der NotifyIcon-Klasse mit dem angegebenen Container.Initializes a new instance of the NotifyIcon class with the specified container.

Eigenschaften

BalloonTipIcon

Ruft das Symbol ab, das in der SprechblasenInfo angezeigt werden soll, die dem NotifyIcon zugeordnet ist, oder legt dieses Symbol fest.Gets or sets the icon to display on the balloon tip associated with the NotifyIcon.

BalloonTipText

Ruft den Text ab, der in der SprechblasenInfo angezeigt werden soll, die dem NotifyIcon zugeordnet ist, oder legt diesen Text fest.Gets or sets the text to display on the balloon tip associated with the NotifyIcon.

BalloonTipTitle

Ruft den Titel der SprechblasenInfo ab, die auf dem NotifyIcon angezeigt wird, oder legt diesen fest.Gets or sets the title of the balloon tip displayed on the NotifyIcon.

CanRaiseEvents

Ruft einen Wert ab, der angibt, ob die Komponente ein Ereignis auslösen kann.Gets a value indicating whether the component can raise an event.

(Geerbt von Component)
Container

Ruft die IContainer ab, die in der Component enthalten ist.Gets the IContainer that contains the Component.

(Geerbt von Component)
ContextMenu

Ruft das Kontextmenü für das Symbol ab oder legt dieses fest.Gets or sets the shortcut menu for the icon.

ContextMenuStrip

Ruft das dem NotifyIcon zugeordnete Kontextmenü ab oder legt dieses fest.Gets or sets the shortcut menu associated with the NotifyIcon.

DesignMode

Ruft einen Wert ab, der angibt, ob sich Component gegenwärtig im Entwurfsmodus befindet.Gets a value that indicates whether the Component is currently in design mode.

(Geerbt von Component)
Events

Ruft die Liste der Ereignishandler ab, die dieser Component angefügt sind.Gets the list of event handlers that are attached to this Component.

(Geerbt von Component)
Icon

Ruft das aktuelle Symbol ab oder legt es fest.Gets or sets the current icon.

Site

Ruft den ISite von Component ab oder legt ihn fest.Gets or sets the ISite of the Component.

(Geerbt von Component)
Tag

Ruft das Objekt ab, das Daten über das NotifyIcon enthält, oder legt dieses Objekt fest.Gets or sets an object that contains data about the NotifyIcon.

Text

Ruft den QuickInfo-Text ab, der angezeigt wird, wenn sich der Mauszeiger auf einem Symbol im Infobereich befindet, oder legt ihn fest.Gets or sets the ToolTip text displayed when the mouse pointer rests on a notification area icon.

Visible

Ruft einen Wert ab, der angibt, ob das Symbol im Infobereich der Taskleiste sichtbar ist, oder legt ihn fest.Gets or sets a value indicating whether the icon is visible in the notification area of the taskbar.

Methoden

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Dispose()

Gibt alle vom Component verwendeten Ressourcen frei.Releases all resources used by the Component.

(Geerbt von Component)
Dispose(Boolean)

Gibt die von Component verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei.Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(Geerbt von Component)
Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetService(Type)

Gibt ein Objekt zurück, das einen von der Component oder von deren Container bereitgestellten Dienst darstellt.Returns an object that represents a service provided by the Component or by its Container.

(Geerbt von Component)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab.Obtains a lifetime service object to control the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
ShowBalloonTip(Int32)

Zeigt für den angegebene Zeitraum eine SprechblasenInfo in der Taskleiste an.Displays a balloon tip in the taskbar for the specified time period.

ShowBalloonTip(Int32, String, String, ToolTipIcon)

Zeigt eine SprechblasenInfo mit dem angegebenen Titel, Text und Symbol für den angegebenen Zeitraum in der Taskleiste an.Displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period.

ToString()

Gibt einen String zurück, der den Namen der Component enthält (sofern vorhanden).Returns a String containing the name of the Component, if any. Diese Methode darf nicht überschrieben werden.This method should not be overridden.

(Geerbt von Component)

Ereignisse

BalloonTipClicked

Tritt auf, wenn auf die SprechblasenInfo geklickt wird.Occurs when the balloon tip is clicked.

BalloonTipClosed

Tritt auf, wenn die SprechblasenInfo vom Benutzer geschlossen wird.Occurs when the balloon tip is closed by the user.

BalloonTipShown

Tritt auf, wenn die SprechblasenInfo auf dem Bildschirm angezeigt wird.Occurs when the balloon tip is displayed on the screen.

Click

Tritt auf, wenn der Benutzer auf das Symbol im Infobereich klickt.Occurs when the user clicks the icon in the notification area.

Disposed

Tritt auf, wenn die Komponente von einem Aufruf der Dispose()-Methode verworfen wird.Occurs when the component is disposed by a call to the Dispose() method.

(Geerbt von Component)
DoubleClick

Tritt auf, wenn der Benutzer auf das Symbol im Infobereich der Taskleiste doppelklickt.Occurs when the user double-clicks the icon in the notification area of the taskbar.

MouseClick

Tritt ein, wenn der Benutzer mit der Maus auf einen NotifyIcon klickt.Occurs when the user clicks a NotifyIcon with the mouse.

MouseDoubleClick

Tritt ein, wenn der Benutzer mit der Maus auf das NotifyIcon doppelklickt.Occurs when the user double-clicks the NotifyIcon with the mouse.

MouseDown

Tritt auf, wenn der Benutzer die Maustaste klickt, während der Mauszeiger sich über dem Symbol im Infobereich der Taskleiste befindet.Occurs when the user presses the mouse button while the pointer is over the icon in the notification area of the taskbar.

MouseMove

Tritt auf, wenn der Benutzer die Maus bewegt, während der Mauszeiger sich über dem Symbol im Infobereich der Taskleiste befindet.Occurs when the user moves the mouse while the pointer is over the icon in the notification area of the taskbar.

MouseUp

Tritt auf, wenn der Benutzer die Maustaste loslässt, während sich der Mauszeiger über dem Symbol im Infobereich der Taskleiste befindet.Occurs when the user releases the mouse button while the pointer is over the icon in the notification area of the taskbar.

Gilt für: