NotifyIcon クラス

定義

通知領域にアイコンを作成するコンポーネントを指定します。Specifies a component that creates an icon in the notification area. このクラスは継承できません。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
継承

NotifyIconクラスを使用して、通知領域にアプリケーションのアイコンを表示するコード例を次に示します。The following code example demonstrates using the NotifyIcon class to display an icon for an application in the notification area. この例IconではContextMenu Visible 、、、 DoubleClick 、およびの各プロパティを設定し、イベントを処理する方法を示します。 TextThe example demonstrates setting the Icon, ContextMenu, Text, and Visible properties and handling the DoubleClick event. 終了ContextMenu項目を**** 持つがNotifyIcon.ContextMenuプロパティに割り当てられます。これにより、ユーザーはアプリケーションを閉じることができます。A ContextMenu with an Exit item on it is assigned to the NotifyIcon.ContextMenu property, which allows the user to close the application. イベントが発生すると、アプリケーションフォームはForm.Activateメソッドを呼び出すことによってアクティブ化されます。 DoubleClickWhen 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

注釈

通知領域のアイコンは、ウイルス対策プログラムやボリュームコントロールなど、コンピューターのバックグラウンドで実行されているプロセスへのショートカットです。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. これらのプロセスには、独自のユーザーインターフェイスが付属していません。These processes do not come with their own user interfaces. クラスNotifyIconは、この機能をプログラミングする手段を提供します。The NotifyIcon class provides a way to program in this functionality. プロパティIconは、通知領域に表示されるアイコンを定義します。The Icon property defines the icon that appears in the notification area. アイコンのポップアップメニューは、 ContextMenuプロパティでアドレス指定されます。Pop-up menus for an icon are addressed with the ContextMenu property. プロパティTextは、ツールヒントテキストを割り当てます。The Text property assigns ToolTip text. 通知領域Visibleにアイコンが表示されるようにするには、プロパティをにtrue設定する必要があります。In order for the icon to show up in the notification area, the Visible property must be set to true.

コンストラクター

NotifyIcon()

NotifyIcon クラスの新しいインスタンスを初期化します。Initializes a new instance of the NotifyIcon class.

NotifyIcon(IContainer)

指定したコンテナーがある NotifyIcon クラスの新しいインスタンスを初期化します。Initializes a new instance of the NotifyIcon class with the specified container.

プロパティ

BalloonTipIcon

NotifyIcon に関連付けられたバルーン ヒントに表示するアイコンを取得または設定します。Gets or sets the icon to display on the balloon tip associated with the NotifyIcon.

BalloonTipText

NotifyIcon に関連付けられたバルーン ヒントに表示するテキストを取得または設定します。Gets or sets the text to display on the balloon tip associated with the NotifyIcon.

BalloonTipTitle

NotifyIcon に表示されるバルーン ヒントのタイトルを取得または設定します。Gets or sets the title of the balloon tip displayed on the NotifyIcon.

CanRaiseEvents

コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。Gets a value indicating whether the component can raise an event.

(継承元 Component)
Container

IContainer を格納している Component を取得します。Gets the IContainer that contains the Component.

(継承元 Component)
ContextMenu

アイコンのショートカット メニューを取得または設定します。Gets or sets the shortcut menu for the icon.

ContextMenuStrip

NotifyIcon に関連付けられたショートカット メニューを取得または設定します。Gets or sets the shortcut menu associated with the NotifyIcon.

DesignMode

Component が現在デザイン モードかどうかを示す値を取得します。Gets a value that indicates whether the Component is currently in design mode.

(継承元 Component)
Events

Component に結び付けられているイベント ハンドラーのリストを取得します。Gets the list of event handlers that are attached to this Component.

(継承元 Component)
Icon

現在のアイコンを取得または設定します。Gets or sets the current icon.

Site

ComponentISite を取得または設定します。Gets or sets the ISite of the Component.

(継承元 Component)
Tag

NotifyIcon に関するデータを格納するオブジェクトを取得または設定します。Gets or sets an object that contains data about the NotifyIcon.

Text

マウス ポインターが通知領域アイコンの上にあるときに表示されるツールヒント テキストを取得または設定します。Gets or sets the ToolTip text displayed when the mouse pointer rests on a notification area icon.

Visible

アイコンをタスクバーの通知領域に表示するかどうかを示す値を取得または設定します。Gets or sets a value indicating whether the icon is visible in the notification area of the taskbar.

メソッド

CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(継承元 MarshalByRefObject)
Dispose()

Component によって使用されているすべてのリソースを解放します。Releases all resources used by the Component.

(継承元 Component)
Dispose(Boolean)

Component によって使用されているアンマネージド リソースを解放し、オプションでマネージド リソースも解放します。Releases the unmanaged resources used by the Component and optionally releases the managed resources.

(継承元 Component)
Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(継承元 Object)
GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(継承元 Object)
GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(継承元 MarshalByRefObject)
GetService(Type)

Component またはその Container で提供されるサービスを表すオブジェクトを返します。Returns an object that represents a service provided by the Component or by its Container.

(継承元 Component)
GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(継承元 Object)
InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(継承元 MarshalByRefObject)
MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(継承元 Object)
MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(継承元 MarshalByRefObject)
ShowBalloonTip(Int32)

指定した期間、タスク バーにバルーン ヒントを表示します。Displays a balloon tip in the taskbar for the specified time period.

ShowBalloonTip(Int32, String, String, ToolTipIcon)

指定したタイトル、テキスト、アイコンを含むバルーン ヒントを、指定した時間だけタスク バーに表示します。Displays a balloon tip with the specified title, text, and icon in the taskbar for the specified time period.

ToString()

Component の名前 (存在する場合) を格納する String を返します。Returns a String containing the name of the Component, if any. このメソッドはオーバーライドできません。This method should not be overridden.

(継承元 Component)

イベント

BalloonTipClicked

バルーン ヒントがクリックされたときに発生します。Occurs when the balloon tip is clicked.

BalloonTipClosed

ユーザーがバルーン ヒントを閉じると発生します。Occurs when the balloon tip is closed by the user.

BalloonTipShown

バルーン ヒントが画面に表示されたときに発生します。Occurs when the balloon tip is displayed on the screen.

Click

ユーザーが通知領域のアイコンをクリックした時点で発生します。Occurs when the user clicks the icon in the notification area.

Disposed

Dispose() メソッドの呼び出しによってコンポーネントが破棄されると発生します。Occurs when the component is disposed by a call to the Dispose() method.

(継承元 Component)
DoubleClick

タスクバーの通知領域のアイコンをダブルクリックすると発生します。Occurs when the user double-clicks the icon in the notification area of the taskbar.

MouseClick

ユーザーがマウスで NotifyIcon をクリックしたときに発生します。Occurs when the user clicks a NotifyIcon with the mouse.

MouseDoubleClick

ユーザーがマウスで NotifyIcon をダブルクリックすると発生します。Occurs when the user double-clicks the NotifyIcon with the mouse.

MouseDown

ポインターがタスクバーの通知領域のアイコンの上にあるときに、マウス ボタンを押すと発生します。Occurs when the user presses the mouse button while the pointer is over the icon in the notification area of the taskbar.

MouseMove

ポインターがタスクバーの通知領域のアイコンの上にあるときに、マウスを移動すると発生します。Occurs when the user moves the mouse while the pointer is over the icon in the notification area of the taskbar.

MouseUp

ポインターがタスクバーの通知領域のアイコンの上にあるときに、マウス ボタンを離すと発生します。Occurs when the user releases the mouse button while the pointer is over the icon in the notification area of the taskbar.

セキュリティ

UIPermission
NotifyIconコンポーネントを作成します。to create the NotifyIcon component. 関連付けられた列挙型:AllWindowsAssociated enumeration: AllWindows

適用対象