タスクバーのシステムトレイ（タスクトレイ）にアイコンを表示させる

最終更新 2003 09/17

サンプルのダウンロード → Exp_Shell_NotifyIcon.lzh(40k)

全ソースコード

このサンプルを動作させるには main.cpp と resource.rc と resource.h の
３つのファイルを新規作成して、それぞれの内容をファイルへコピーして下さい。
それと、同じフォルダに１６×１６ピクセルのサイズのアイコンを置いて下さい。
アイコンのファイル名は icon.ico とします。
アイコンはアイコンエディタなどを使って作成して下さい。
Vector などで探せば入手できると思います。

main.cpp
//インクルード #include <windows.h> #include "resource.h" //クラス名定義 #define CLASS_NAME "Exp_Shell_NotifyIcon" #define WM_ICON_CLICK WM_USER + 999 //プロトタイプ宣言 LRESULT CALLBACK WinProc( HWND, UINT, WPARAM, LPARAM ); BOOL ShowPopup( HWND ); BOOL SetTasktrayIcon( HINSTANCE, HWND, NOTIFYICONDATA *, LPCTSTR, const int ); //グローバル変数 NOTIFYICONDATA g_nid; //タスクトレイに表示するアイコンの情報 UINT g_taskbarCreated = -1; //シェル再起動時のメッセージを受け取る HINSTANCE g_hInstance = NULL; //インスタンスハンドル //メイン int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd ) { { //ウィンドウクラス設定＆登録 WNDCLASS wc; wc.cbClsExtra = 0; wc.cbWndExtra = 0; wc.hbrBackground = (HBRUSH)GetStockObject( WHITE_BRUSH ); wc.hCursor = LoadCursor( NULL, IDC_ARROW ); wc.hIcon = LoadIcon( NULL, IDI_WINLOGO ); wc.hInstance = hInstance; wc.lpfnWndProc = WinProc; wc.lpszClassName = CLASS_NAME; wc.lpszMenuName = NULL; wc.style = 0; if( !RegisterClass( &wc ) ) return 1; } //ウィンドウ作成 HWND hWnd = CreateWindow( CLASS_NAME, CLASS_NAME, WS_CAPTION | WS_SYSMENU, CW_USEDEFAULT, CW_USEDEFAULT, 0, 0, NULL, NULL, hInstance, NULL ); if( hWnd == NULL ) return 1; //ウィンドウ表示 ShowWindow( hWnd, SW_HIDE ); UpdateWindow( hWnd ); g_hInstance = hInstance; //タスクトレイにアイコン表示 if( !SetTasktrayIcon( g_hInstance, hWnd, &g_nid, "サンプル", IDI_ICON1 ) ) return 1; //シェル再起動のメッセージを登録 g_taskbarCreated = RegisterWindowMessage( "TaskbarkCreated" ); //メッセージループ while( TRUE ) { MSG msg; if( GetMessage( &msg, NULL, 0, 0 ) <= 0 ) break; TranslateMessage( &msg ); DispatchMessage( &msg ); } //タスクトレイのアイコンを削除 Shell_NotifyIcon( NIM_DELETE, &g_nid ); return 0; } //メッセージの対応 LRESULT CALLBACK WinProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam ) { switch( uMsg ) { case WM_DESTROY: PostQuitMessage(0); break; case WM_ICON_CLICK: //タスクトレイのアイコンのメッセージ switch( lParam ) { case WM_RBUTTONDOWN: //ポップアップメニュー表示 ShowPopup( hWnd ); break; } break; default: //シェルが死んで再起動した時 if( uMsg == g_taskbarCreated ) { //タスクトレイにアイコン表示 if( !SetTasktrayIcon( g_hInstance, hWnd, &g_nid, "サンプル", IDI_ICON1 ) ) PostQuitMessage(0); } } return DefWindowProc( hWnd, uMsg, wParam, lParam ); } //タスクトレイにアイコンを登録 BOOL SetTasktrayIcon( HINSTANCE hInstance, HWND hWnd, NOTIFYICONDATA *nid, LPCTSTR lpszTitle, const int nIconID ) { wsprintf( nid->szTip, lpszTitle ); nid->cbSize = sizeof( NOTIFYICONDATA ); nid->hIcon = LoadIcon( hInstance, MAKEINTRESOURCE( nIconID ) ); nid->hWnd = hWnd; nid->uCallbackMessage = WM_ICON_CLICK; nid->uFlags = NIF_MESSAGE | NIF_ICON | NIF_TIP; return Shell_NotifyIcon( NIM_ADD, nid ); } //ポップアップメニューの処理 BOOL ShowPopup( HWND hWnd ) { //マウスカーソルの位置を取得 POINT mouse; if( !GetCursorPos( &mouse ) ) return FALSE; //メニューを取得 HMENU hMenu = LoadMenu( g_hInstance, MAKEINTRESOURCE( IDR_MENU1 ) ); HMENU hMenuChild = GetSubMenu( hMenu, 0 ); if( hMenuChild == NULL ) return FALSE; //選択されたメニューのＩＤを取得 int nCommandID = TrackPopupMenu( hMenuChild, TPM_RIGHTALIGN | TPM_BOTTOMALIGN | TPM_RETURNCMD, mouse.x, mouse.y, 0, hWnd, NULL ); //取得したＩＤ別に処理 switch( nCommandID ) { case ID_POPUP_EXIT: //終了 PostQuitMessage(0); break; case ID_POPUP_CLOSE: //ポップアップメニューを閉じる { HWND hWndPopup = FindWindow( "#32768", NULL ); if( hWndPopup && IsWindowVisible( hWndPopup ) ) { PostMessage( hWndPopup, WM_KEYDOWN, VK_ESCAPE, 0 ); break; } } return TRUE; case ID_POPUP_VERSION: //バージョン情報表示 MessageBox( NULL, "タスクトレイにアイコンを\r\n表示するサンプル\r\n\r\n配布元 bakage- studio 2003\r\n製作者 blackmarz\r\n\r\nhttp://marz.hp.infoseek.co.jp/\r\nblackmarz@hotmail.com", "バージョン情報", MB_OK ); break; default: return FALSE; } return TRUE; }

resource.rc
#include "resource.h" ///////////////////////////////////////////////////////////////////////////// #define APSTUDIO_READONLY_SYMBOLS #include "afxres.h" #undef APSTUDIO_READONLY_SYMBOLS ///////////////////////////////////////////////////////////////////////////// ///////////////////////////////////////////////////////////////////////////// // // 日本語 resources // #if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_JPN) ///////////////////////////////////////////////////////////////////////////// #ifdef _WIN32 LANGUAGE LANG_JAPANESE, SUBLANG_DEFAULT #pragma code_page(932) #endif //_WIN32 ///////////////////////////////////////////////////////////////////////////// ///////////////////////////////////////////////////////////////////////////// #ifdef APSTUDIO_INVOKED 1 TEXTINCLUDE DISCARDABLE BEGIN "resource.h\0" END 2 TEXTINCLUDE DISCARDABLE BEGIN "#include ""afxres.h""\r\n" "\0" END 3 TEXTINCLUDE DISCARDABLE BEGIN "\r\n" "\0" END #endif // APSTUDIO_INVOKED ///////////////////////////////////////////////////////////////////////////// ///////////////////////////////////////////////////////////////////////////// // // Icon // IDI_ICON1 ICON DISCARDABLE "icon.ico" ///////////////////////////////////////////////////////////////////////////// // // Menu // IDR_MENU1 MENU DISCARDABLE BEGIN POPUP "ポップアップ" BEGIN MENUITEM "バージョン情報", ID_POPUP_VERSION MENUITEM SEPARATOR MENUITEM "閉じる", ID_POPUP_CLOSE MENUITEM "終了", ID_POPUP_EXIT END END #endif // 日本語 resources

resource.h
#define IDR_MENU1 102 #define IDI_ICON1 106 #define ID_POPUP_EXIT 40001 #define ID_POPUP_CLOSE 40002 #define ID_POPUP_VERSION 40003 #ifdef APSTUDIO_INVOKED #ifndef APSTUDIO_READONLY_SYMBOLS #define _APS_NEXT_RESOURCE_VALUE 108 #define _APS_NEXT_COMMAND_VALUE 40004 #define _APS_NEXT_CONTROL_VALUE 1000 #define _APS_NEXT_SYMED_VALUE 101 #endif #endif

Shell_NotifyIcon 関数
	
	対応しているバージョン
	95, 98, Me, NT4.0以降, CE1.0以降, 2000, XP
	( Microsoft Internet Explorer 4.0以上推奨 )
		
	使用するヘッダとライブラリ
	shellapi.h
	shell32.lib



【 タスクトレイにアイコンを登録する 】


タスクトレイにアイコンを表示させるには Shell_NotifyIcon() 関数を
使います。

NOTIFYICONDATA 構造体に表示するアイコンなどを設定したら
Shell_NotifyIcon() 関数の最初の引数に NIM_ADD を指定して
二番目の引数に先ほど設定を行った NOTIFYICONDATA 構造体の
ポインタを渡します。

	NOTIFYICONDATA nid;
	Shell_NotifyIcon( NIM_ADD, &nid );

タスクトレイに登録したアイコンを削除するには、最初の引数を
NIM_DELETE と変更すれば削除できます。

	NOTIFYICONDATA nid;
	Shell_NotifyIcon( NIM_DELETE, &nid );


以下に NOTIFYICONDATA 構造体の各メンバの説明を書きます。

NOTIFYICONDATA 構造体のメンバ

cbSize

    sizeof( NOTIFYICONDATA ) を指定します。

hWnd 

    登録するアプリケーションのウィンドウハンドルを渡します。
    ここに指定したウィンドウのコールバック関数に
    タスクトレイのアイコンをクリックした時などのメッセージが
    送信されます。
    
uID 

    アプリケーション側で定義されたタスクバーアイコンの識別子
    とＭＳＤＮに書かれていますが、登録・削除を行うだけなら
    使用しません。

uFlags

    次のいずれかを指定します。
    | で区切る事で複数指定することができます。
	
    NIF_ICON       hIcon メンバを使用する
    NIF_MESSAGE    uCallbackMessage メンバを使用する
    NIF_TIP        szTip メンバを使用する
    
uCallbackMessage 

    タスクトレイに登録したアイコンがクリックされたときなどに
    コールバック関数に送信されるメッセージ番号を指定します。
    メッセージ番号は WM_USER + ０以上の値を指定します。
    
        #define WM_ICON_CLICK WM_USER + 1
    
    などとデファインを使って定義しておくとよいです。
    
hIcon

    タスクトレイに表示するアイコンを指定します。
    リソースに登録したアイコンを指定する場合は
    MAKEINTRESOURCE( リソースＩＤ ) を使います。

szTip

    タスクトレイに表示されているアイコンに、マウスカーソルが
    触った時に表示する文字を指定します。
    普通はソフト名を指定します。



【 ポップアップメニューを作成する 】


タスクトレイのアイコンをクリックした時に表示させる
ポップアップメニューを作成します。

ポップアップメニューは普通のウィンドウメニューと同じように
リソーススクリプトにメニューを追加して編集します。

メニューハンドルが取得できるような状態であれば、メニューは
どのように作成しても問題はありません。

以下に説明する方法は、あくまで一例です。

( まだリソーススクリプトを作成していない状態だとします。 )



１．ﾌﾟﾛｼﾞｪｸﾄ(P) - ﾌﾟﾛｼﾞｪｸﾄへ追加(A) - 新規作成(N) を選択。





２．ﾘｿｰｽｽｸﾘﾌﾟﾄ - ﾌｧｲﾙ名(N) - ＯＫ を選択。



ここでは ﾌｧｲﾙ名(N) に resource と指定しましたが、自分の好きな名前で構いません。
	


３．ﾜｰｸｽﾍﾟｰｽ にリソースビューが追加されます。





４．resource ﾘｿｰｽ と書かれているフォルダのアイコンを右クリックして 挿入(I)
　　を選択。





５．Menu - 新規作成(N) を選択。




	
IDR_MENU1 という名前でメニューが作成されました。
このＩＤをプログラム中に呼び出す時は MAKEINTRESOURCE( IDR_MENU1 )
というように MAKEINTRESOURCE を使って呼び出します。
（この IDR_MENU1 は便宜上つけられたものなので、後で変更できます。）


６．IDR_MENU1 をダブルクリックして、メニューエディタでメニューの項目を
　　編集。


	
メニュー項目の上で右クリックして ﾌﾟﾛﾊﾟﾃｨ(P) で項目の編集を行います。



ｷｬﾌﾟｼｮﾝ(C) と ID(I) を入力。



最終的にメニューは以下のように作成します。

//親メニュー
キャプション：ポップアップ( ﾌﾟﾛﾊﾟﾃｨ の ﾎﾟｯﾌﾟｱｯﾌﾟ(O) にチェックを入れます )
ＩＤ：なし

　//子メニュー１
　キャプション：バージョン情報
　ＩＤ：ID_POPUP_VERSION

　//子メニュー２
　キャプション：なし( ﾌﾟﾛﾊﾟﾃｨ の ｾﾊﾟﾚｰﾀ(A) にチェックを入れます )
　ＩＤ：なし

　//子メニュー３
　キャプション：閉じる
　ＩＤ：ID_POPUP_CLOSE

　//子メニュー４
　キャプション：終了
　ＩＤ：ID_POPUP_EXIT



【 アイコンを追加する 】


アイコンはＶＣ＋＋に付属のエディタでも作成できるのですが
１６×１６サイズのアイコンを作成したはいいのですが、どのように
プログラム中で呼び出せばいいのかが分かりませんでした。

ですので、別のアイコン作成用エディタで１６×１６サイズの
アイコンを作成して、それをプロジェクトと同じフォルダに入れておき
リソースに追加するという方法を取ります。


１．resource ﾘｿｰｽ と書かれているフォルダのアイコンを右クリックして 挿入(I)
　　を選択。





２．Icon - インポート(M) を選択。





３．追加するアイコンを選択したらインポートをクリック。






IDI_ICON1 という名前でアイコンが追加されました。
このＩＤをプログラム中で呼び出す時は MAKEINTRESOURCE( IDI_ICON1 ) の
ようにします。（この名前は変更可能です。）



【 アイコンがクリックされたかどうかを調べる 】


アイコンとメニューをリソースに追加したら、今度はタスクトレイの
アイコンがクリックされたかどうかを調べる処理を追加します。

タスクトレイに表示したアイコンがクリックされると、メインウィンドウの
コールバック関数に Shell_NotifyIcon() 関数を呼び出すときに指定した
NOTIFYICONDATA 構造体の uCallbackMessage メンバに指定した
メッセージが送信されます。

uCallbackMessage に指定する値は WM_USER + ０以上の値です。

サンプルでは分かりやすいように

	#define WM_ICON_CLICK WM_USER + 999
	
として WM_ICON_CLICK という名前と uCallbackMessage に指定する値を
対応させています。

こうすると、あとで WM_USER + 999 を WM_USER + 1000 に
変更しなければならなくなっても、このデファインの部分だけ
変更すれば良いので便利です。

999 を指定したのに深い意味はありません。なんとなくです。
0 でも 100 でも、他に同じ値を使用していなければ何でもかまいません。

WM_USER 以降のメッセージは、自分で定義できるメッセージです。
今回のように、自分で独自にメッセージを定義しなければならない場合に
WM_USER ＋０以上の値を使用します。

タスクトレイに表示されているアイコンがクリックされたかどうかを
調べるには以下のようにします。

LRESULT CALLBACK WinProc( HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam )
{
    switch( uMsg )
    {
    case WM_ICON_CLICK:
        
        //タスクトレイのアイコンのメッセージ
        switch( lParam )
        {
        case WM_RBUTTONDOWN:

            //アイコンが右クリックされた
            break;
            
        case WM_LBUTTONDOWN:
        
            //アイコンが左クリックされた
            break;
            
        case WM_MBUTTONDOWN:
        
            //アイコンがマウスの中央ボタンでクリックされた
            break;
        }

        break;
        
        ・
        ・
        ・


こんな風にマウスのボタン別に処理を分けることも可能です。
サンプルでは右クリックにだけ対応させています。

このサンプルを見ると「WM_KEYDOWNを使えばキー入力も判定できるのでは？」
と考えてしまうのですが、そもそも WM_ICON_CLICK がアイコンをクリックした
時にしか呼ばれないので、キー判定はできません。



【 ポップアップメニューを表示させる 】


アイコンのクリックが判定できるようになったら、次はそれにあわせて
ポップアップメニューを表示する処理を追加します。

ポップアップメニューの表示には TrackPopupMenu 関数を使います。
この部分の処理はもう、お決まりのパターンになっているので、以下の
ソースを何も考えずに使って下さい。
（赤くなっている部分だけ、必要に応じて修正する必要があります。）

//マウスカーソルの位置を取得
POINT mouse;
if( !GetCursorPos( &mouse ) ) return FALSE;

//メニューを取得
HMENU hMenu = LoadMenu( hInstance, MAKEINTRESOURCE( IDR_MENU1 ) );
HMENU hMenuChild = GetSubMenu( hMenu, 0 );
if( hMenuChild == NULL ) return FALSE;

//選択されたメニューのＩＤを取得
int nCommandID = TrackPopupMenu(
                     hMenuChild,
                     TPM_RIGHTALIGN | TPM_BOTTOMALIGN | TPM_RETURNCMD,
                     mouse.x, mouse.y,
                     0,
                     hWnd,
                     NULL
                     );


上のソース中の赤い文字は、必要に応じて変更しなければならない箇所です。
IDR_MENU1 は、リソースに登録されているポップアップメニューのＩＤです。
メニューのＩＤを別の名前に変更した場合は、ここの値も変更します。

hWnd はメインウィンドウのウィンドウハンドルです。
hInstance はアプリケーションのインスタンスハンドルです。

おおまかに説明すると、画面上のマウスカーソルの位置と、IDR_MENU1 の
２番目の階層にあるメニュー項目を取得して、それを TrackPopupMenu()
関数に渡しています。

ポップアップメニューの場合、一番上の階層は必要ないので、２番目の階層を
使います。（サンプルだと、キャプションにポップアップという名前を
設定されている項目が一番上の階層です。）

そうすると、nCommandID には、ポップアップメニューのクリックされた項目の
ＩＤが返ってきます。

ポップアップメニューを作成した時に、各メニュー項目にＩＤをつけたと
思いますが、nCommandID の値はそのＩＤと対応しているので、nCommandID の
値を switch で分岐させて、ＩＤで捕らえれば良いということになります。

ようするにこうです。

switch( nCommandID )
{
case ID_POPUP_VERSION: //バージョン情報がクリックされた

    //バージョン情報表示
    break;
    
case ID_POPUP_CLOSE:   //閉じるがクリックされた

    //ポップアップメニューを閉じる
    break;
    
case ID_POPUP_EXIT:   //終了がクリックされた

    //アプリケーション終了
    break;
}

/*
    ID_POPUP_VERSION, ID_POPUP_CLOSE, ID_POPUP_EXIT は
    ポップアップメニュー作成時に設定したＩＤです。
*/


タスクトレイに表示したアイコンがクリックされたか判定する処理から
ここまでの処理をくっつけると

LRESULT CALLBACK WinProc(
    HWND hWnd,
    UINT uMsg,
    WPARAM wParam,
    LPARAM lParam
){
  switch( uMsg )
  {
  case WM_ICON_CLICK:
        
    //タスクトレイのアイコンのメッセージ
    switch( lParam )
    {
    case WM_RBUTTONDOWN:
        
      {
        //マウスカーソルの位置を取得
        POINT mouse;
        if( !GetCursorPos( &mouse ) ) return FALSE;

        //メニューを取得
        HMENU hMenu
          = LoadMenu( hInstance, MAKEINTRESOURCE( IDR_MENU1 ) );
        
        HMENU hMenuChild = GetSubMenu( hMenu, 0 );
        if( hMenuChild == NULL ) return FALSE;

        //選択されたメニューのＩＤを取得
        int nCommandID
          = TrackPopupMenu(
              hMenuChild,
              TPM_RIGHTALIGN | TPM_BOTTOMALIGN | TPM_RETURNCMD,
              mouse.x, mouse.y,
              0,
              hWnd,
              NULL
              );

        switch( nCommandID )
        {
        case ID_POPUP_VERSION://バージョン情報がクリックされた

          //バージョン情報表示
          break;
    
        case ID_POPUP_CLOSE://閉じるがクリックされた

          //ポップアップメニューを閉じる
          break;
    
        case ID_POPUP_EXIT://終了がクリックされた

          //アプリケーション終了
          break;
        }
      }
            
      break;
    }
        
    break;
        
    ・
    ・
    ・


まー、こんな流れになるわけです・・・。
WM_RBUTTONDOWN の中の処理はけっこう長いので、サンプルでは ShowPopup()
という関数を作ってそれを呼び出し、その関数内で処理を行うようにして
います。



【 ポップアップメニューが閉じない罠 】


次にポップアップメニューの「閉じる」の処理を追加します。
よく、タスクトレイのアイコンをクリックしてポップアップメニューを
表示させた状態で、デスクトップをクリックするなどのアクションを
行うと、ポップアップメニューが開いたまま閉じなくなります。

開きっぱなしのポップアップメニューを閉じるには、選びたくもない項目を
選んで半ば強制的に閉じるしか方法がありません。
これはどうもウィンドウズのバグらしいのですが、一向に改善される気配が
ないのでこちらで対応してしまいましょう。
そのために、ポップアップメニューに「閉じる」という項目を追加しました。

ポップアップメニューもウィンドウのひとつなので、名前が分かってしまえば
FindWindow() で検索してウィンドウハンドルを取ってくる事が可能です。
で、ポップアップメニューは Esc キーを押すと閉じるようになっているので
ポップアップメニューのウィンドウに対して「エスケープキーが押されたよ」
というメッセージを送ればよいという事になります。

ポップアップメニューのウィンドウ名は、#32768 だそうです。

HWND hWndPopup = FindWindow( "#32768", NULL );
if( hWndPopup && IsWindowVisible( hWndPopup ) )
{
    PostMessage( hWndPopup, WM_KEYDOWN, VK_ESCAPE, 0 );
    break;
}


これを ID_POPUP_CLOSE の中に入れてあげればＯＫ。

switch( nCommandID )
{
case ID_POPUP_VERSION://バージョン情報がクリックされた

  //バージョン情報表示
  break;
    
case ID_POPUP_CLOSE://閉じるがクリックされた

  //ポップアップメニューを閉じる
  {
      HWND hWndPopup = FindWindow( "#32768", NULL );
      if( hWndPopup && IsWindowVisible( hWndPopup ) )
      {
        PostMessage( hWndPopup, WM_KEYDOWN, VK_ESCAPE, 0 );
        break;
      }
  }
  break;
    
case ID_POPUP_EXIT://終了がクリックされた

  //アプリケーション終了
  break;
}




【 タスクトレイのアイコンが消える罠 】


以上の処理で十分使用する事は可能ですが、まだひとつ問題があります。

ＩＥがフリーズして強制終了すると、タスクトレイに登録したアイコンが
全て消えてしまいます。
タスクマネージャを見ると、まだアプリケーションは動いているので
終了したい場合は強制終了しなければなりません。
「シェルが死ぬ。」などと言うそうです。
これはタスクトレイがＩＥと連動して動いているのが原因のようです。

ＩＥを強制終了したなどの原因でシェルが死ぬと、自動的にタスクトレイが
再起動します。
ＩＥ４．０以上でしか利用できませんが、この再起動したかどうかを調べる
ことができます。
それには "TaskbarCreated" というメッセージをシステムに登録します。
そうするとメッセージが使用できるようなら「あいよ〜思う存分使いなされ〜」
とウィンドウズがメッセージに使用できる値を返してくれるので、この値を
コールバック関数で調べます。
もしキャッチできたら、シェルが死んでアイコンが消えてしまっているので
アイコンをもう一度タスクトレイに表示します。

メッセージの登録には RegisterWindowMessage() 関数を使います。

以下、使用例

LRESULT CALLBACK WinProc(
    HWND hWnd,
    UINT uMsg,
    WPARAM wParam,
    LPARAM lParam
){

  static UINT uMsgRebootShell = 0;
	
  switch( uMsg )
  {
  case WM_CREATE:
		
    uMsgRebootShell = RegisterWindowMessage( "TaskbarCreated" );
    break;
		
  default:
	
    if( uMsgRebootShell >= 0xC000 && uMsg == uMsgRebootShell )
    {
        //タスクトレイにアイコンを登録
    }
  }
    
  ・
  ・
  ・

| home |