Interface ICustomDestinationList (shobjidl_core.h)

Expose des méthodes qui permettent à une application de fournir une liste de raccourcis personnalisée, y compris des destinations et des tâches, à afficher dans la barre des tâches.

Héritage

L’interface ICustomDestinationList hérite de l’interface IUnknown. ICustomDestinationList a également les types de membres suivants :

Méthodes

L’interface ICustomDestinationList a ces méthodes.

ICustomDestinationList ::AbortList Interrompt une session de génération de liste de raccourcis lancée par ICustomDestinationList ::BeginList sans valider les modifications.
ICustomDestinationList ::AddUserTasks Spécifie les éléments à inclure dans la catégorie Tâches d’une liste de raccourcis personnalisée.
ICustomDestinationList ::AppendCategory Définit une catégorie personnalisée et les destinations qu’elle contient, à inclure dans une liste de raccourcis personnalisée.
ICustomDestinationList ::AppendKnownCategory Spécifie que la catégorie Fréquent ou Récent doit être incluse dans une liste de raccourcis personnalisée.
ICustomDestinationList ::BeginList Lance une session de génération pour une liste de raccourcis personnalisée.
ICustomDestinationList ::CommitList Déclare que la liste de raccourcis lancée par un appel à ICustomDestinationList ::BeginList est terminée et prête à être affichée.
ICustomDestinationList ::D eleteList Supprime une liste de raccourcis personnalisée pour une application spécifiée.
ICustomDestinationList ::GetRemovedDestinations Récupère la liste actuelle des destinations qui ont été supprimées par l’utilisateur de la liste de raccourcis existante que cette liste de raccourcis personnalisée est destinée à remplacer.
ICustomDestinationList ::SetAppID Spécifie un ID de modèle utilisateur d’application unique (AppUserModelID) pour l’application dont le bouton de barre des tâches contiendra la liste de raccourcis personnalisée générée par les méthodes de cette interface. Cette méthode est facultative.

Remarques

Quand implémenter

Une implémentation de cette interface est fournie dans Windows en tant que CLSID_DestinationList. Cette interface n’est pas implémentée par des tiers.

Quand utiliser

Les Listes contiennent à la fois des listes de destination et de tâches.

• Les destinations sont des éléments qui apparaissent dans les catégories Récents, Fréquents ou personnalisés, en fonction de l’utilisation d’un individu. Les destinations peuvent être des fichiers, des dossiers, des sites web ou d’autres éléments basés sur du contenu, mais ne sont pas nécessairement sauvegardées par des fichiers. Les destinations peuvent être considérées comme des choses ou des noms. Les destinations peuvent être épinglées ou supprimées de la liste de raccourcis par l’utilisateur. Ils sont généralement représentés par des objets IShellItem , mais ils peuvent également être des objets IShellLink .
• Les tâches sont des actions courantes effectuées dans une application qui s’appliquent à tous les utilisateurs de cette application, quels que soient les modèles d’utilisation d’un individu. Les tâches peuvent être considérées comme des actions ou des verbes. Les tâches ne peuvent pas être épinglées ou supprimées. Ils sont représentés par des objets IShellLink .

La barre des tâches fournit à chaque bouton de la barre des tâches une liste de raccourcis. Par défaut, une liste de raccourcis contient une catégorie Récent , qui est remplie automatiquement pour les applications basées sur des fichiers via SHAddToRecentDocs ou la boîte de dialogue fichier commun. Pour remplacer la catégorie Récent par la catégorie Fréquent ou définir, ajouter et remplir ses propres catégories personnalisées, une application doit appeler les méthodes de cette interface. L’application peut également fournir ses propres tâches en fonction de l’architecture de l’application et de son utilisation prévue.

Note Une application doit être un gestionnaire inscrit pour un type de fichier pour qu’un élément de ce type apparaisse dans sa liste de raccourcis. Toutefois, il n’a pas besoin d’être le gestionnaire par défaut pour ce type de fichier.

 

Une liste de raccourcis personnalisée est destinée à présenter du contenu que l’application a jugé significatif en fonction de l’utilisation précédente de l’application ou par le biais d’une action qui a indiqué qu’un élément est important pour l’utilisateur, comme l’ajout d’un élément à une liste Favoris.

L’application doit appeler cet objet pour fournir une liste de raccourcis personnalisée à l’interface utilisateur de la barre des tâches. Le système n’interroge jamais l’application pour obtenir les informations.

Lorsqu’une application fournit une liste de raccourcis personnalisée, elle assume certaines responsabilités autour de cette liste. Les catégories personnalisées doivent être remplies d’une manière cohérente avec l’utilisation prévue d’une liste de raccourcis. La validité des éléments de la liste doit être vérifiée ou échouer correctement s’ils ont été supprimés. Si l’utilisateur supprime un élément de la liste, cette suppression doit être respectée.

Une liste de raccourcis personnalisée n’est jamais vraiment mise à jour dans le sens de la modification d’éléments dans une liste existante. Au lieu de cela, l’ancienne liste est remplacée par une nouvelle liste.

La séquence de base des appels de méthode ICustomDestinationList pour générer et afficher une liste de raccourcis personnalisée est la suivante :

1. SetAppID (obligatoire uniquement si une application fournit son propre AppUserModelID)
2. BeginList
3. AppendCategory, AppendKnownCategory, AddUserTasks ou toute combinaison de ces trois méthodes.
4. CommitList

Configuration requise

Condition requise	Valeur
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

Extensions de la barre des tâches