Interface ITaskbarList3 (shobjidl_core.h)

  • Article

É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.
Lorsqu’une application affiche une fenêtre, son bouton de barre des tâches est créé par le système. Lorsque le bouton est en place, la barre des tâches envoie un message TaskbarButtonCreated à la fenêtre. Votre application doit appeler RegisterWindowMessage(L"TaskbarButtonCreated ») et gérer ce message dans son wndproc. Ce message doit être reçu par votre application avant qu’elle appelle une méthode ITaskbarList3 .
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)

Voir aussi

ITaskbarList2

Extensions de la barre des tâches