ITaskbarList3 インターフェイス (shobjidl_core.h)

  • [アーティクル]

Windows 7 で追加されたタスク バー ボタンの統合起動と切り替え機能をサポートするメソッドを公開することで 、ITaskbarList2 を拡張します。 この機能には、タブ付きアプリケーションの個々のタブ、サムネイル ツールバー、通知と状態のオーバーレイ、進行状況インジケーターに基づくサムネイル表現と切り替えターゲットが含まれます。

継承

ITaskbarList3 インターフェイスは、ITaskbarList2 から継承します。 ITaskbarList3 には、次の種類のメンバーもあります。

メソッド

ITaskbarList3 インターフェイスには、これらのメソッドがあります。

 
ITaskbarList3::RegisterTab

アプリケーションのタスク バー グループポップアップに表示する新しいタブまたはドキュメントのサムネイルが提供されたことをタスク バーに通知します。
ITaskbarList3::SetOverlayIcon

タスク バー ボタンにオーバーレイを適用して、アプリケーションの状態または通知をユーザーに示します。
ITaskbarList3::SetProgressState

タスク バー ボタンに表示される進行状況インジケーターの種類と状態を設定します。
ITaskbarList3::SetProgressValue

タスク バー ボタンでホストされている進行状況バーを表示または更新して、完全な操作が完了した特定の割合を表示します。
ITaskbarList3::SetTabActive

タブまたはドキュメント ウィンドウがアクティブウィンドウにされたことをタスク バーに通知します。
ITaskbarList3::SetTabOrder

タブ付きドキュメント インターフェイス (TDI) または複数ドキュメント インターフェイス (MDI) アプリケーションのグループ ポップアップに新しいサムネイルを挿入するか、既存のサムネイルをアプリケーションのグループ内の新しい位置に移動します。
ITaskbarList3::SetThumbnailClip

タスク バーにウィンドウのサムネイルとして表示するウィンドウのクライアント領域の一部を選択します。
ITaskbarList3::SetThumbnailTooltip

タスク バー ボタンポップアップの個々のプレビュー サムネイルにマウス ポインターが置かれたときに表示されるヒントのテキストを指定または更新します。
ITaskbarList3::ThumbBarAddButtons

タスク バー ボタン ポップアップ内のウィンドウのサムネイル画像に、指定したボタンのセットを含むサムネイル ツール バーを追加します。
ITaskbarList3::ThumbBarSetImageList

タスク バーボタンポップアップのウィンドウのサムネイル画像に埋め込まれたツールバーのボタン画像を含む画像リストを指定します。
ITaskbarList3::ThumbBarUpdateButtons

ウィンドウの現在の状態で必要に応じて、サムネイル ツール バーのボタンを表示、有効化、無効化、または非表示にします。 サムネイル ツール バーは、タスク バー ボタンポップアップのウィンドウのサムネイル画像に埋め込まれたツール バーです。
ITaskbarList3::UnregisterTab

アプリケーションでタブまたはドキュメントが閉じられたときに、アプリケーションのプレビュー グループからサムネイルを削除します。

解説

このインターフェイスには、継承元の ITaskbarList インターフェイスと ITaskbarList2 インターフェイスのメソッドも用意されています。

実装するタイミング

このインターフェイスの実装は、CLSID_TaskbarListとして Windows で提供されます。 このインターフェイスは、サード パーティによって実装されていません。

使用するタイミング

このインターフェイスのメソッドを使用して、次の操作を行います。
  • タスク バーにウィンドウをグループとして表示している TDI アプリケーション (Windows インターネット エクスプローラーなど) または MDI アプリケーション (Microsoft Excel など) を使用する場合:
    • タスク バーに、個々のタブまたはドキュメントのビューを表すサムネイルを提供します。
    • グループから個々のタブまたはドキュメントのサムネイルを削除します。
    • グループ内のサムネイルの順序を変更します。
    • サムネイルを表示するときに、タブのサムネイルを選択した項目として設定します。
  • 通知などのタスク バー アイコンにオーバーレイを適用する場合。
  • アイテムのコピーやインストールなど、操作の進行状況を表示する場合。
  • サムネイルにツールバーを追加する場合。
アプリケーションにウィンドウが表示されると、タスク バー ボタンがシステムによって作成されます。 ボタンが配置されると、タスク バーは 、タスク バーにタスク バー ボタンの作成 メッセージをウィンドウに送信します。 アプリケーションで RegisterWindowMessage(L"TaskbarButtonCreated") を呼び出し、そのメッセージを wndproc で処理する必要があります。 アプリケーションが ITaskbarList3 メソッドを呼び出す前に、そのメッセージを受信する必要があります。
メモ アプリケーションは、プログラムによってタスク バーにピン留めすることはできません。 その機能は、ユーザーのために厳密に予約されています。
 

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)

関連項目

ITaskbarList2

タスク バーの拡張機能