Structure SHCOLUMNINFO (shlobj.h)

Article
03/02/2024

Contient des informations sur les propriétés d’une colonne. Il est utilisé par IColumnProvider ::GetColumnInfo.

Syntaxe

typedef struct {
  SHCOLUMNID scid;
  VARTYPE    vt;
  DWORD      fmt;
  UINT       cChars;
  DWORD      csFlags;
  WCHAR      wszTitle[MAX_COLUMN_NAME_LEN];
  WCHAR      wszDescription[MAX_COLUMN_DESC_LEN];
} SHCOLUMNINFO, *LPSHCOLUMNINFO;

Membres

scid

Type : SHCOLUMNID

Structure SHCOLUMNID qui identifie de manière unique la colonne.

vt

Type : VARTYPE

Type VARIANT natif des données de la colonne.

fmt

Type : DWORD

Format d’affichage liste. Ce membre est normalement défini sur LVCFMT_LEFT.

cChars

Type : UINT

Largeur par défaut de la colonne, en caractères.

csFlags

Type : DWORD

Indicateurs indiquant l’état de colonne par défaut. Il peut s’agir d’une combinaison des indicateurs suivants.

SHCOLSTATE_TYPE_STR

Chaîne.

SHCOLSTATE_TYPE_INT

Entier.

SHCOLSTATE_TYPE_DATE

Une date.

SHCOLSTATE_ONBYDEFAULT

Par défaut, dans la vue Détails de Windows Explorer, même si l’utilisateur n’a pas sélectionné la colonne. Si cet indicateur est défini, la colonne s’affiche pour tous les dossiers. Il n’existe aucun moyen de forcer l’affichage d’une colonne par dossier.

SHCOLSTATE_SLOW

Le calcul est lent. Les Explorer Windows doivent récupérer les données de manière asynchrone et effectuer le calcul sur un thread d’arrière-plan.

SHCOLSTATE_EXTENDED

Fourni par un gestionnaire, et non par l’objet dossier.

SHCOLSTATE_SECONDARYUI

Non affiché dans le menu contextuel, mais répertorié dans la boîte de dialogue Plus...

SHCOLSTATE_HIDDEN

Non affiché dans l’interface utilisateur.

wszTitle[MAX_COLUMN_NAME_LEN]

Type : WCHAR[MAX_COLUMN_NAME_LEN]

Chaîne Unicode terminée par null avec le titre de la colonne. Il ne doit pas contenir plus de MAX_COLUMN_NAME_LEN caractères, y compris la valeur NULL de fin.

wszDescription[MAX_COLUMN_DESC_LEN]

Type : WCHAR[MAX_COLUMN_DESC_LEN]

Chaîne Unicode terminée par null avec la description de la colonne. Il ne doit pas contenir plus de MAX_COLUMN_DESC_LEN caractères, y compris la valeur NULL de fin.

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]
En-tête	shlobj.h

Voir aussi

IColumnProvider ::GetColumnInfo

Partager via