Windows 7 タスクバーの動的なオーバーレイアイコンと進行状況バー

Article
08/01/2011

みなさん、こんにちは。Windows 開発統括部の古内です。

今週はまた Windows 7 タスクバーの特集に戻りたいと思います。今日お届けするのは、2009 年 7 月 28 日に Developing for Windows Blog に投稿された「Windows 7 Taskbar Dynamic Overlay Icons and Progress Bars」の翻訳です。

Windows 7 タスクバーの動的なオーバーレイアイコンと進行状況バー

これまでの記事では、Windows 7 タスクバーの基本事項 (「Windows 7 タスクバー関連の開発 – Application ID」) と、アプリケーション用のジャンプリストの作成方法 (「Windows 7 タスクバー関連の開発 – ジャンプリストの活用 (その 1)」、「その 2」、「その 3」 ) について説明してきました。今回はこの Windows 7 タスクバーの優れた機能の中から、動的なオーバーレイアイコンと、複数の状態を表示する進行状況バーの活用方法についてご紹介します。

Windows 7 の理念の核とも言えるのが、「ユーザーが主導権を握る (User Is in Control)」ということです。つまり、デスクトップの外観や機能を、ユーザー自身がコントロールできるようにすることです。たとえば些細なことですが、タスクバーアイコンの配置を調整したり、タスクバーに表示するアイコンの数を制御したりすることができます。Windows 7 では、システムトレイアイコン領域が非常にシンプルになり、デフォルトではほぼすべてのトレイアイコンが非表示となっています。このため、通知メッセージのほとんどは表示されず、ユーザーが通知を目にする機会が減少していることが十分に考えられます。通知領域の更新情報についてさらに詳しく知りたい方は、こちらのブログ記事を参照してください。このあまり表示されなくなった通知を補う手段として、Windows 7 のタスクバーにはオーバーレイアイコンと進行状況バーが提供されています。これらの機能を活用すれば、システムトレイアイコン領域がなくても、さらにはアプリケーションのウィンドウが表示されていない状態であっても、アプリケーションの状況を適切に示すステータス情報をユーザーに提供することができます。ユーザーはアプリケーションのサムネイルやライブプレビューを表示する必要もありません。重要なステータス更新があれば、タスクバーボタンそのものに表示されます。この機能は、ユーザーが余分なクリック操作なしで簡単にアプリケーションの状態を確認できるようにする、ということを目指したマイクロソフトの取り組みの 1 つの成果です。

オーバーレイアイコン

ネイティブのオーバーレイ機能は、ITaskbarList4 インターフェイス、具体的にはその SetOverlayIcon 関数で提供されています。次のコードスニペットに示すとおり、この関数は、ウィンドウハンドル、アイコンハンドル、およびオプションの説明テキストを使用します。

 HICON hIcon = NULL; // IDM_OVERLAY_CLEAR の場合
hIcon = LoadIcon(g_hInstance, MAKEINTRESOURCE(IDI_OVERLAY1));
// ウィンドウのオーバーレイ アイコン (NULL 値が可能) を設定する
g_pTaskbarList->SetOverlayIcon(hWnd, hIcon, NULL);
if (hIcon) {
// アイコンが不要になったので、クリーンアップする
DestroyIcon(hIcon);
}

以前と同様に、ITaskbarList3 *g_pTaskbarList = NULL; を取得し、CoCreate を使用します。

 CoCreateInstance(
    CLSID_TaskbarList, 
    NULL, 
    CLSCTX_INPROC_SERVER, 
    IID_PPV_ARGS(&g_pTaskbarList));

上記のコードを適切な場所で実行すると (アプリケーションをダウンロードできます)、次の画像のような状態が表示されます。左の画像ではアプリケーションにオーバーレイアイコンはありませんが、右の画像では赤色のアイコンオーバーレイが表示されています。

この機能のマネージラッパーは、Windows API Code Pack for the .NET Framework に含まれる Taskbar クラスにあります。この場合は、OverlayImage プロパティ (Taskbar.OverlayImage) を使用するだけです。単純に、次のように呼び出します。

 Taskbar.OverlayImage = 
        new OverlayImage(TaskbarDemo.Properties.Resources.Red, "Red");

これで、タスクバーボタンにオーバーレイイメージを指定することができます。この TaskbarDemo プロジェクトは WinForms のデモであり、上記のコードは TaskbarDemoMainForm.cs にあります。

また、同様の処理を WPF Window に対して実行する拡張メソッドも簡単に提供できます。適切なアイコンを入手する必要がありますが、.NET リソースを使用すればこれも簡単です。

進行状況バー

アプリケーションの最上位ウィンドウで標準の進行状況バーを使っている場合は、DMW がそれを特定し、既定でその進行状況がアプリケーションアイコン上にオーバーレイとして表示されます。ただし、アプリケーションのアイコン上に表示されるこの進行状況バーの動作はプログラムで制御することが可能です。

先ほどと同様、ネイティブのこの機能は ITaskbarList3 インターフェイスにありますが、今回は SetProgressState 関数と SetProgressValue 関数を使用します。これらの関数の機能はその名前から予想されるとおりです。SetProgressState は進行状況バーの状態 (たとえば、不確定、エラーなど) を設定します。SetProgressValue は進行状況の値を設定します。次のコードスニペットは、これらの関数の使用方法を示しています。

 case WM_TIMER:
    g_nProgress++;
    if (g_nProgress == 1)
    {
        // 最初は、進行状況の状態を不確定に設定する
        // この状態は、必要な処理の量を明らかにするための 
        // バックグラウンド計算が実行されていることを表す
        g_pTaskbarList->SetProgressState(hWnd, TBPF_INDETERMINATE);
    }
    else if (g_nProgress == MAX_PROGRESS_IND)
    {
        // 進行状況の状態を設定し、
        // 通常の進行状況として表示する処理があることを示す
        g_pTaskbarList->SetProgressValue(hWnd, 0, MAX_PROGRESS_NORMAL);
        g_pTaskbarList->SetProgressState(hWnd, TBPF_NORMAL);
    }
    else if (g_nProgress > MAX_PROGRESS_IND)
    {
        if (g_nProgress - MAX_PROGRESS_IND <= MAX_PROGRESS_NORMAL)
        {
            // バックグラウンドの処理の実行を表す、
            // 通常の進行状況を表示する
            g_pTaskbarList->SetProgressValue(
                                hWnd, 
                                g_nProgress - MAX_PROGRESS_IND, 
                                MAX_PROGRESS_NORMAL);
        }
        else
        {
            // 処理が完了したら、タイマーを停止し、進行状況の状態を 
            // リセットする
            KillTimer(hWnd, g_nTimerId);
            g_nTimerId = 0;
            g_pTaskbarList->SetProgressState(hWnd, TBPF_NOPROGRESS);
            MessageBox(hWnd, L"Done!", L"Progress Complete", MB_OK);
        }
    }
    break;

上記では、最初のタイマーチックで進行状況バーを TBPF_INDETERMINATE に設定し、その後で TBPF_NORMAL に設定しています。TBPF_NORMAL は、処理が完了するまでの推定残り時間に比例して進行状況インジケーターが左から右へ伸びていく通常の状態です。

マネージコードの場合は Windows Code Pack API を使用します。ネイティブの進行状況バーと同様、マネージコード Taskbar クラスにも進行状況バーのプロパティ (自身のクラス内) があります。これにより、現在の値、最大値、および進行状況バーの状態を設定することができます。この進行状況バーの状態 (TaskbarButtonProgressState クラスに含まれる) は、次のとおりです。

NoProgress – ネイティブの TBPF_NOPROGRESS 状態と同等
Indeterminate – ネイティブの TBPF_INDETERMINATE 状態と同等
Normal – ネイティブの TBPF_NORMAL 状態と同等
Error – ネイティブの TBPF_ERROR 状態と同等
Paused – ネイティブの TBPF_PAUSED 状態と同等

WinForms のデモについては、TaskbarDemo プロジェクトおよび TaskbarDemoMainForm.cs を参照してください。この中には、進行状況バーの更新のためにタイマーから呼び出される UpdateProgressBar 関数もあります。

 Taskbar.ProgressBar.State = 
    (TaskbarButtonProgressState)Enum.Parse(
            typeof(TaskbarButtonProgressState), 
            (string)comboBoxProgressBarStates.SelectedItem);

if (Taskbar.ProgressBar.State != TaskbarButtonProgressState.Indeterminate)
    Taskbar.ProgressBar.CurrentValue = progressBar1.Value;

ここまで見てきたとおり、コードによって進行状況バーの状態を選択することが可能です。エラー状態に変更すると、タスクバーアイコンに表示される進行状況バーの色が赤に変わります。

ファイル処理に標準の進行状況ダイアログを使用している場合は、何もしなくてもタスクバーアイコンにこの優れた進行状況バーを表示することができます (このシリーズ記事を通じて、Windows プログラミングの標準ガイドラインに従えば、多くの機能を無料で利用できることがおわかりいただけると思います)。たとえば、ファイル処理を SHFileOperation API または IFileOperation インターフェイスを使って実行すると、その処理の進行状況の情報 (エラーを含む) を示す進行状況バーがタスクバーボタン上に自動的に表示されます。この機能は Windows エクスプローラーでも採用されて大成功を収めています。

Windows 7 タスク バーの動的なオーバーレイ アイコンと進行状況バー

Windows 7 タスク バーの動的なオーバーレイ アイコンと進行状況バー

Additional resources

Windows 7 タスクバーの動的なオーバーレイアイコンと進行状況バー

Windows 7 タスクバーの動的なオーバーレイアイコンと進行状況バー