NotifyIcon Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

NotifyIcon.cs

Určuje komponentu, která vytvoří ikonu v oznamovací oblasti. Tuto třídu nelze zdědit.

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

Dědičnost

Object

MarshalByRefObject

Component

NotifyIcon

Příklady

Následující příklad kódu ukazuje použití NotifyIcon třídy k zobrazení ikony pro aplikaci v oznamovací oblasti. Příklad ukazuje nastavení Icon, , ContextMenuTexta Visible vlastnosti a zpracování DoubleClick události. Položka ContextMenuExit je přiřazena k NotifyIcon.ContextMenu vlastnosti, která uživateli umožňuje zavřít aplikaci. Když dojde k DoubleClick události, formulář aplikace je aktivován voláním 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

Poznámky

Ikony v oznamovací oblasti jsou zkratky pro procesy spuštěné na pozadí počítače, jako je program antivirové ochrany nebo ovládací prvek svazku. Tyto procesy nepřicházejí s vlastními uživatelskými rozhraními. Třída NotifyIcon poskytuje způsob, jak programovat v této funkci. Vlastnost Icon definuje ikonu, která se zobrazí v oznamovací oblasti. Místní nabídky ikony jsou adresovány vlastností ContextMenu . Vlastnost Text přiřadí text popisu. Aby se ikona zobrazila v oznamovací oblasti, Visible musí být vlastnost nastavena na truehodnotu .

Konstruktory

Name	Description
NotifyIcon()	Inicializuje novou instanci NotifyIcon třídy.
NotifyIcon(IContainer)	Inicializuje novou instanci NotifyIcon třídy se zadaným kontejnerem.

Vlastnosti

Name	Description
BalloonTipIcon	Získá nebo nastaví ikonu pro zobrazení na bublině tip přidružené k NotifyIcon.
BalloonTipText	Získá nebo nastaví text, který se zobrazí v bublině tip přidružené k NotifyIcon.
BalloonTipTitle	Získá nebo nastaví název bubliny tip zobrazený na NotifyIcon.
ContextMenuStrip	Získá nebo nastaví místní nabídku přidruženou k .NotifyIcon
Icon	Získá nebo nastaví aktuální ikonu.
Tag	Získá nebo nastaví objekt, který obsahuje data o objektu NotifyIcon.
Text	Získá nebo nastaví text popisu zobrazený při umístění ukazatele myši na ikonu oznamovací oblasti.
Visible	Získá nebo nastaví hodnotu označující, zda je ikona viditelná v oznamovací oblasti hlavního panelu.

Metody

Name	Description
ShowBalloonTip(Int32, String, String, ToolTipIcon)	Zobrazí bublinový tip se zadaným názvem, textem a ikonou na hlavním panelu pro zadané časové období.
ShowBalloonTip(Int32)	Zobrazí bublinový tip na hlavním panelu pro zadané časové období.

Událost

Name	Description
BalloonTipClicked	Nastane při kliknutí na bublinu.
BalloonTipClosed	Nastane, když je bublina tip zavřena uživatelem.
BalloonTipShown	Nastane, když se na obrazovce zobrazí tip bubliny.
Click	Nastane, když uživatel klikne na ikonu v oznamovací oblasti.
DoubleClick	Nastane, když uživatel dvakrát klikne na ikonu v oznamovací oblasti hlavního panelu.
MouseClick	Nastane, když uživatel klikne myší NotifyIcon .
MouseDoubleClick	Nastane, když uživatel dvakrát klikne NotifyIcon myší.
MouseDown	Nastane, když uživatel stiskne tlačítko myši, zatímco ukazatel je nad ikonou v oznamovací oblasti hlavního panelu.
MouseMove	Nastane, když uživatel přesune myš, zatímco ukazatel je nad ikonou v oznamovací oblasti hlavního panelu.
MouseUp	Nastane, když uživatel uvolní tlačítko myši, zatímco ukazatel je nad ikonou v oznamovací oblasti hlavního panelu.