Méthode IHeaderCtrl ::InsertColumn (mmc.h)

Article
03/04/2024

Ajoute une colonne à un volet de résultats par défaut.

Syntaxe

HRESULT InsertColumn(
  [in] int     nCol,
  [in] LPCWSTR title,
  [in] int     nFormat,
  [in] int     nWidth
);

Paramètres

[in] nCol

Index de base zéro de la colonne en cours d’insertion.

[in] title

Valeur qui spécifie la chaîne qui représente le titre de la colonne en cours d’insertion. Cette chaîne peut avoir une longueur maximale de MAX_PATH caractères.

[in] nFormat

Valeur qui spécifie la position du texte dans la colonne. Pour la colonne zéro, nFormat doit être LVCFMT_LEFT. Cette valeur doit être l’une des suivantes :

LVCFMT_LEFT

Le texte est aligné à gauche.

LVCFMT_CENTER

Le texte est aligné au centre.

LVCFMT_RIGHT

Le texte est aligné à droite.

Note Pour utiliser les constantes LVCFMT_* , incluez CommCtrl.h dans votre fichier source.

[in] nWidth

Valeur qui spécifie la largeur de la colonne en pixels. Cette valeur doit être l’une des suivantes :

MMCLV_AUTO

MMC détermine automatiquement la largeur de la colonne en fonction de sa chaîne de titre.

HIDE_COLUMN

Introduit dans MMC 1.2. La colonne est insérée, mais elle est masquée. N’oubliez pas que l’utilisateur peut rendre la colonne visible lors de la personnalisation d’un affichage de liste.

Pour les composants logiciels enfichables créés avec le Kit de développement logiciel (SDK) MMC 1.2, mais qui sont chargés dans une version antérieure de MMC, HIDE_COLUMN est interprété comme une largeur nulle. L’utilisateur peut élargir la colonne en la faisant glisser avec la souris.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Remarques

MMC ne conserve pas en mémoire les modifications apportées à un jeu de colonnes en raison de l’action de IHeaderCtrl ::InsertColumn. Par conséquent, les composants logiciels enfichables doivent mettre à jour les données de configuration de colonnes persistantes après l’insertion de colonnes dans un ensemble de colonnes. Pour plus d’informations, consultez IHeaderCtrl2 et Persistance des colonnes.

Notes aux appelants

Les appels à InsertColumn échouent si des éléments ont déjà été insérés dans la vue des résultats.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	mmc.h
DLL	Mmcndmgr.dll

Voir aussi

IHeaderCtrl

IHeaderCtrl2 et persistance des colonnes

Partager via