Partager via

Interface IColumnProvider (shlobj.h)

  • Article

Expose des méthodes qui permettent l’ajout de colonnes personnalisées dans l’affichage Détails de Windows Explorer.

Note La prise en charge d’IColumnProvider a été supprimée à partir de Windows Vista. Le système de propriétés Windows est utilisé à sa place. Consultez Système de propriétés Windows pour obtenir des documents conceptuels qui expliquent l’utilisation du nouveau système.
 

Héritage

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

Méthodes

L’interface IColumnProvider a ces méthodes.

 
IColumnProvider::GetColumnInfo

Demande des informations sur une colonne.
IColumnProvider::GetItemData

Demande des données de colonne pour un fichier spécifié.
IColumnProvider::Initialize

Initialise une interface IColumnProvider.

Remarques

L’affichage Détails de Windows Explorer affiche généralement plusieurs colonnes standard. Chaque colonne répertorie des informations, telles que la taille ou le type de fichier, pour chaque fichier du dossier actif. Il peut également y avoir un certain nombre de colonnes que l’utilisateur peut choisir d’afficher. Lorsque l’utilisateur clique avec le bouton droit sur l’un des en-têtes de colonne, une liste des colonnes disponibles s’affiche dans une boîte de dialogue. En créant un objet de fournisseur de colonnes qui exporte l’interface IColumnProvider, vous pouvez ajouter des colonnes personnalisées à cette boîte de dialogue pour les afficher par Windows Explorer. Par exemple, une collection de fichiers qui contiennent de la musique peut utiliser un fournisseur de colonnes pour afficher les colonnes répertoriant l’artiste et la pièce contenues dans chaque fichier.

Un fournisseur de colonnes est un objet global appelé chaque fois que Windows Explorer affiche la vue Détails. Windows Explorer interroge tous les fournisseurs de colonnes inscrits pour connaître leurs caractéristiques de colonne. Si l’utilisateur a sélectionné l’une des colonnes du fournisseur de colonnes, Windows Explorer interroge le fournisseur de colonnes pour obtenir les données associées pour chaque fichier du dossier. Il affiche ensuite toutes les colonnes sélectionnées.

En règle générale, les fournisseurs de colonnes sont utilisés pour afficher une ou plusieurs colonnes personnalisées pour un type de fichier particulier. Lorsqu’un fournisseur de colonnes reçoit une demande de données, il la fournit si le fichier est membre de son type pris en charge. Sinon, elle ignore la demande en retournant S_FALSE.

Les colonnes sont identifiées par une structure SHCOLUMNID qui contient une paire fmtid/pid . Si possible, utilisez des fmtidset des pidsexistants. Si un dossier contient des fichiers de plusieurs types de fichiers, les données de différents types peuvent être fusionnées dans la même colonne. Par instance, la propriété Author de l’ensemble de propriétés d’informations récapitulatives peut être utilisée à des fins très diverses. Si vous utilisez une structure SHCOLUMNID personnalisée, la colonne affiche les données uniquement pour les fichiers qui sont membres du type pris en charge. Si le dossier contient d’autres fichiers, leurs entrées sont vides.

Implémentez un objet qui exporte cette interface lorsque vous souhaitez afficher une ou plusieurs colonnes personnalisées dans l’affichage Détails de Windows Explorer. Windows Explorer appelle les méthodes d’interface pour demander les informations dont il a besoin pour afficher la colonne. La procédure utilisée par Windows Explorer est la suivante :

  1. Appelez IColumnProvider::Initialize pour spécifier le dossier à afficher.
  2. Appelez IColumnProvider::GetColumnInfo pour récupérer les caractéristiques de la colonne.
  3. Si la colonne a été sélectionnée par l’utilisateur, appelez IColumnProvider::GetItemData pour chaque fichier du dossier afin de récupérer les données qui appartiennent à l’entrée de colonne du fichier.
En plus de l’inscription COM (Component Object Model) normale, l’objet fournisseur de colonnes doit également être inscrit auprès de Windows Explorer. Pour ce faire, ajoutez à cette clé une sous-clé nommée avec la forme de chaîne du GUID de l’objet. 
HKEY_CLASSES_ROOT
   Folder
      shellex
         ColumnHandlers

Cette interface est appelée par Windows Explorer. Il n’est généralement pas utilisé par les applications.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj.h