Interface ITaskbarList3 (shobjidl_core.h)
Étend ITaskbarList2 en exposant les méthodes qui prennent en charge les fonctionnalités unifiées de bouton de lancement et de basculement de la barre des tâches ajoutées dans Windows 7. Cette fonctionnalité inclut des représentations de miniatures et des cibles de basculement basées sur des onglets individuels dans une application à onglets, des barres d’outils de miniatures, des superpositions de notification et de status et des indicateurs de progression.
Héritage
L’interface ITaskbarList3 hérite de ITaskbarList2. ITaskbarList3 a également les types de membres suivants :
Méthodes
L’interface ITaskbarList3 a ces méthodes.
| ITaskbarList3::RegisterTab Informe la barre des tâches qu’une nouvelle miniature d’onglet ou de document a été fournie pour être affichée dans le menu volant du groupe de barre des tâches d’une application. |
| ITaskbarList3::SetOverlayIcon Applique une superposition à un bouton de la barre des tâches pour indiquer une status d’application ou une notification à l’utilisateur. |
| ITaskbarList3::SetProgressState Définit le type et l’état de l’indicateur de progression affiché sur un bouton de barre des tâches. |
| ITaskbarList3::SetProgressValue Affiche ou met à jour une barre de progression hébergée dans un bouton de barre des tâches pour afficher le pourcentage spécifique de l’opération complète. |
| ITaskbarList3::SetTabActive Informe la barre des tâches qu’un onglet ou une fenêtre de document a été créé comme fenêtre active. |
| ITaskbarList3::SetTabOrder Insère une nouvelle miniature dans un menu volant de groupe DDI (Interface de document à onglets) ou MDI (Multi-Document Interface) ou déplace une miniature existante vers une nouvelle position dans le groupe de l’application. |
| ITaskbarList3::SetThumbnailClip Sélectionne une partie de la zone cliente d’une fenêtre à afficher comme miniature de cette fenêtre dans la barre des tâches. |
| ITaskbarList3::SetThumbnailTooltip Spécifie ou met à jour le texte de l’info-bulle qui s’affiche lorsque le pointeur de la souris repose sur une miniature d’aperçu individuelle dans un menu volant de bouton de la barre des tâches. |
| ITaskbarList3::ThumbBarAddButtons Ajoute une barre d’outils de miniatures avec un ensemble spécifié de boutons à l’image miniature d’une fenêtre dans un menu volant de bouton de la barre des tâches. |
| ITaskbarList3::ThumbBarSetImageList Spécifie une liste d’images qui contient des images de bouton pour une barre d’outils incorporée dans une image miniature d’une fenêtre dans un menu volant de bouton de barre des tâches. |
| ITaskbarList3::ThumbBarUpdateButtons Affiche, active, désactive ou masque les boutons dans une barre d’outils miniatures en fonction de l’état actuel de la fenêtre. Une barre d’outils de miniatures est une barre d’outils incorporée dans une image miniature d’une fenêtre dans un menu volant de bouton de barre des tâches. |
| ITaskbarList3::UnregisterTab Supprime une miniature du groupe d’aperçus d’une application lorsque cet onglet ou ce document est fermé dans l’application. |
Remarques
Cette interface fournit également les méthodes des interfaces ITaskbarList et ITaskbarList2 , dont elle hérite.
Quand implémenter
Une implémentation de cette interface est fournie dans Windows en tant que CLSID_TaskbarList. Cette interface n’est pas implémentée par des tiers.Quand utiliser
Utilisez les méthodes de cette interface pour effectuer les opérations suivantes :- Lorsque vous utilisez une application TDI (telle que Windows Internet Explorer) ou une application MDI (telle que Microsoft Excel) qui affiche ses fenêtres en tant que groupe dans la barre des tâches :
- Fournissez à la barre des tâches une miniature qui représente l’affichage d’un onglet ou d’un document individuel.
- Supprimez la miniature d’un onglet ou d’un document individuel du groupe.
- Modifiez l’ordre des miniatures dans le groupe.
- Définissez une miniature d’onglet comme élément sélectionné lorsque les miniatures sont affichées.
- Lors de l’application d’une superposition à une icône de barre des tâches, telle qu’une notification.
- Lors de l’affichage de la progression d’une opération, telle que la copie ou l’installation d’un élément.
- Lors de l’ajout d’une barre d’outils à une miniature.
Note Les applications ne peuvent pas s’épingler par programmation à la barre des tâches. Cette fonctionnalité est strictement réservée à l’utilisateur.
Configuration requise
| Client minimal pris en charge | Windows 7 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 R2 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shobjidl_core.h (incluez Shobjidl.h) |