NotifyIcon NotifyIcon NotifyIcon NotifyIcon Class

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

Das folgende Codebeispiel veranschaulicht die Verwendung der NotifyIcon Klasse, um ein Symbol für eine Anwendung im Infobereich der Taskleiste angezeigt.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 der Icon, ContextMenu, Text, und Visible Eigenschaften und Behandlung der DoubleClick Ereignis.The example demonstrates setting the Icon, ContextMenu, Text, and Visible properties and handling the DoubleClick event. Ein ContextMenu mit einer beenden darauf zugewiesen ist die NotifyIcon.ContextMenu -Eigenschaft, die dem Benutzer ermöglicht, die die Anwendung zu schließen.A ContextMenu with an Exit item on it is assigned to the NotifyIcon.ContextMenu property, which allows the user to close the application. Wenn die DoubleClick Ereignis auftritt, wird das Anwendungsformular durch Aufrufen der Form.Activate Methode.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
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 'Main

    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 'New
    
    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 'Dispose

    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 'Form1

Hinweise

Symbole im Infobereich der Taskleiste sind die Tastenkombinationen für Prozesse, die im Hintergrund von einem Computer, wie ein Virenschutzprogramm oder ein Volume-Steuerelement ausgeführt werden.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 stammen nicht mit ihren eigenen Benutzeroberflächen.These processes do not come with their own user interfaces. Die NotifyIcon -Klasse bietet eine Möglichkeit zum Programm in diese Funktion.The NotifyIcon class provides a way to program in this functionality. Die Icon -Eigenschaft legt das Symbol, das im Infobereich der Taskleiste angezeigt wird.The Icon property defines the icon that appears in the notification area. Popup-Menüs für ein Symbol werden behandelt, mit der ContextMenu Eigenschaft.Pop-up menus for an icon are addressed with the ContextMenu property. Die Text -Eigenschaft weist einen QuickInfo-Text.The Text property assigns ToolTip text. In der Reihenfolge für das Symbol im Infobereich angezeigt wird, wird die Visible Eigenschaft muss festgelegt werden, um true.In order for the icon to show up in the notification area, the Visible property must be set to true.

Konstruktoren

NotifyIcon() NotifyIcon() NotifyIcon() NotifyIcon()

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

NotifyIcon(IContainer) NotifyIcon(IContainer) NotifyIcon(IContainer) 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 BalloonTipIcon BalloonTipIcon 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 BalloonTipText BalloonTipText 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 BalloonTipTitle BalloonTipTitle 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 CanRaiseEvents CanRaiseEvents 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.

(Inherited from Component)
Container Container Container Container

Ruft den IContainer ab, der die Component enthält.Gets the IContainer that contains the Component.

(Inherited from Component)
ContextMenu ContextMenu ContextMenu ContextMenu

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

ContextMenuStrip ContextMenuStrip ContextMenuStrip ContextMenuStrip

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

DesignMode DesignMode DesignMode 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.

(Inherited from Component)
Events Events Events 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.

(Inherited from Component)
Icon Icon Icon Icon

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

Site Site Site Site

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

(Inherited from Component)
Tag Tag Tag 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 Text Text 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 Visible Visible 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) CreateObjRef(Type) CreateObjRef(Type) 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.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

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

(Inherited from Component)
Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) 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.

(Inherited from Component)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als die Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() 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.

(Inherited from MarshalByRefObject)
GetService(Type) GetService(Type) GetService(Type) 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.

(Inherited from Component)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() 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.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

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

(Inherited from MarshalByRefObject)
ShowBalloonTip(Int32) ShowBalloonTip(Int32) ShowBalloonTip(Int32) 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) ShowBalloonTip(Int32, String, String, ToolTipIcon) ShowBalloonTip(Int32, String, String, ToolTipIcon) 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() ToString() ToString() ToString()

Gibt eine String zurück, die 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.

(Inherited from Component)

Ereignisse

BalloonTipClicked BalloonTipClicked BalloonTipClicked BalloonTipClicked

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

BalloonTipClosed BalloonTipClosed BalloonTipClosed BalloonTipClosed

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

BalloonTipShown BalloonTipShown BalloonTipShown BalloonTipShown

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

Click Click Click Click

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

Disposed Disposed Disposed Disposed

Tritt ein, wenn die Komponente durch einen Aufruf der Dispose()-Methode freigegeben wird.Occurs when the component is disposed by a call to the Dispose() method.

(Inherited from Component)
DoubleClick DoubleClick DoubleClick 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 MouseClick MouseClick MouseClick

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

MouseDoubleClick MouseDoubleClick MouseDoubleClick 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 MouseDown MouseDown 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 MouseMove MouseMove 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 MouseUp MouseUp 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.

Sicherheit

UIPermission
zum Erstellen der NotifyIcon Komponente.to create the NotifyIcon component. Zugeordnete Enumeration: AllWindowsAssociated enumeration: AllWindows

Gilt für: