Méthode IShellFolder2 ::GetDefaultColumn (shobjidl_core.h)

Article
08/26/2023

Obtient les colonnes de tri et d’affichage par défaut.

Syntaxe

HRESULT GetDefaultColumn(
  [in]  DWORD dwRes,
  [out] ULONG *pSort,
  [out] ULONG *pDisplay
);

Paramètres

[in] dwRes

Type : DWORD

Réservé. Définit la valeur zéro.

[out] pSort

Type : ULONG*

Pointeur vers une valeur qui reçoit l’index de la colonne triée par défaut.

[out] pDisplay

Type : ULONG*

Pointeur vers une valeur qui reçoit l’index de la colonne d’affichage par défaut.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur COM dans le cas contraire.

Remarques

Notes à l’utilisateur

Les deux index de colonne retournés par cette méthode sont destinés à être utilisés par une application qui présente une vue de dossier de ce dossier.

La colonne spécifiée par pSort est celle qui doit être utilisée pour trier les éléments du dossier. Pour déterminer l’ordre de tri d’une paire d’éléments, transmettez leurs PIDL à CompareIDs. Spécifiez la colonne en définissant le paramètre lParam de CompareIDs sur la valeur pointée par pSort.

Si une vue n’affiche qu’une seule chaîne pour représenter un élément, elle doit être extraite de la colonne spécifiée par pDisplay. Transmettez l’index de colonne et le PIDL de l’élément à IShellFolder2 ::GetDetailsOf pour récupérer la chaîne.

Notes aux implémenteurs

Cette méthode fait partie de l’implémentation de l’objet de dossier d’une extension d’espace de noms. Il est généralement appelé par un objet d’affichage de dossier pour demander à l’objet dossier quelle colonne dans Microsoft Windows Explorer vue Détails doit être utilisée pour trier les éléments dans le dossier. Par exemple, un objet dossier qui représente un journal des transactions peut définir pSort sur la colonne qui affiche l’heure de la transaction. Les éléments seront ensuite triés selon le moment où la transaction a eu lieu, plutôt que par nom.

Certains clients peuvent appeler cette méthode pour demander l’index de la colonne avec les noms qui doivent être affichés dans l’arborescence. Définissez pDisplay sur l’index de colonne approprié. Le client obtient ensuite les noms d’affichage en appelant IShellFolder2 ::GetDetailsOf.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)
DLL	Shell32.dll (version 5.0 ou ultérieure)

Partager via