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 など) を使用する場合:
- タスク バーに、個々のタブまたはドキュメントのビューを表すサムネイルを提供します。
- グループから個々のタブまたはドキュメントのサムネイルを削除します。
- グループ内のサムネイルの順序を変更します。
- サムネイルを表示するときに、タブのサムネイルを選択した項目として設定します。
- 通知などのタスク バー アイコンにオーバーレイを適用する場合。
- アイテムのコピーやインストールなど、操作の進行状況を表示する場合。
- サムネイルにツールバーを追加する場合。
メモ アプリケーションは、プログラムによってタスク バーにピン留めすることはできません。 その機能は、ユーザーのために厳密に予約されています。
要件
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shobjidl_core.h (Shobjidl.h を含む) |