Styles de List-View étendus

Utilisez le message LVM_SETEXTENDEDLISTVIEWSTYLE ou l’une des macros ListView_SetExtendedListViewStyle ou ListView_SetExtendedListViewStyleEx pour utiliser ces styles de contrôle d’affichage de liste étendus.

Constant Description
LVS_EX_AUTOAUTOARRANGE
Windows Vista et versions ultérieures. Organisez automatiquement les icônes si aucune position d’icône n’a été définie (similaire à LVS_AUTOARRANGE).
LVS_EX_AUTOCHECKSELECT
Windows Vista et versions ultérieures. Activez automatiquement les cases à cocher en un seul clic.
LVS_EX_AUTOSIZECOLUMNS
Windows Vista et versions ultérieures. Dimensionner automatiquement les colonnes listview.
LVS_EX_BORDERSELECT
Version 4.71 et ultérieure. Modifie la couleur de bordure lorsqu’un élément est sélectionné, au lieu de mettre en surbrillance l’élément.
LVS_EX_CHECKBOXES
Version 4.70. Active les cases à cocher pour les éléments d’un contrôle d’affichage liste. Lorsque ce style est défini, le contrôle crée et définit une liste d’images d’état avec deux images à l’aide de DrawFrameControl. L’image d’état 1 est la case non cochée et l’image d’état 2 est la case à cocher. La définition de l’image d’état sur zéro supprime la case à cocher.
Version 6.00 et ultérieure Les cases à cocher sont visibles et fonctionnelles avec tous les modes d’affichage de liste, à l’exception du mode affichage mosaïque introduit dans ComCtl32.dll version 6. Le fait de cliquer sur une case à cocher en mode Affichage mosaïque sélectionne uniquement l’élément ; l’état ne change pas.
Vous pouvez obtenir l’état de la case à cocher d’un élément donné avec ListView_GetCheckState. Pour définir l’état de vérification, utilisez ListView_SetCheckState. Si ce style est défini, le contrôle d’affichage de liste bascule automatiquement l’état de vérification lorsque l’utilisateur clique sur la case à cocher ou appuie sur la barre d’espace.
LVS_EX_COLUMNOVERFLOW
Indique qu’un bouton de dépassement de capacité doit être affiché en mode icône/vignette s’il n’y a pas suffisamment de largeur du client pour afficher l’ensemble complet d’éléments d’en-tête. Le contrôle d’affichage de liste envoie la notification LVN_COLUMNOVERFLOWCLICK lorsque le bouton de dépassement de capacité est cliqué. Cet indicateur est valide uniquement lorsque LVS_EX_HEADERINALLVIEWS est également spécifié.
LVS_EX_COLUMNSNAPPOINTS
Windows Vista et versions ultérieures. Ancrer à la largeur minimale des colonnes lorsque l’utilisateur redimensionne une colonne.
LVS_EX_DOUBLEBUFFER
Version 6.00 et ultérieure. Peint par le biais d’une double mise en mémoire tampon, ce qui réduit le scintillement. Ce style étendu permet également la sélection de marquee à fusion alpha sur les systèmes où elle est prise en charge.
LVS_EX_FLATSB
Active les barres de défilement plates dans l’affichage liste. Si vous avez besoin de davantage de contrôle sur l’apparence des barres de défilement de l’affichage liste, vous devez manipuler les barres de défilement de l’affichage de liste directement à l’aide des API de barre de défilement plate. Si les métriques système changent, vous êtes responsable de l’ajustement des métriques de barre de défilement avec FlatSB_SetScrollProp. Pour plus d’informations, consultez barres de défilement plat .
LVS_EX_FULLROWSELECT
Lorsqu’un élément est sélectionné, l’élément et tous ses sous-éléments sont mis en surbrillance. Ce style est disponible uniquement conjointement avec le style LVS_REPORT .
LVS_EX_GRIDLINES
Affiche le quadrillage autour des éléments et des sous-éléments. Ce style est disponible uniquement conjointement avec le style LVS_REPORT .
LVS_EX_HEADERDRAGDROP
Active la réorganisation des colonnes par glisser-déplacer dans un contrôle list-view. Ce style est uniquement disponible pour les contrôles d’affichage de liste qui utilisent le style LVS_REPORT .
LVS_EX_HEADERINALLVIEWS
Windows Vista et versions ultérieures. Afficher les en-têtes de colonne dans tous les modes d’affichage.
LVS_EX_HIDELABELS
Version 6.00 et ultérieure. Masque les étiquettes en mode icône et petite icône.
LVS_EX_INFOTIP
Lorsqu’un contrôle d’affichage de liste utilise le style LVS_EX_INFOTIP , le code de notification LVN_GETINFOTIP est envoyé à la fenêtre parente avant d’afficher l’info-bulle d’un élément.
LVS_EX_JUSTIFYCOLUMNS
Windows Vista et versions ultérieures. Les icônes sont alignées dans des colonnes qui utilisent l’ensemble de l’affichage.
LVS_EX_LABELTIP
Si une étiquette partiellement masquée en mode Affichage liste ne contient pas de texte d’info-bulle, le contrôle d’affichage liste déploie l’étiquette. Si ce style n’est pas défini, le contrôle d’affichage de liste se déploie en partie sous forme d’étiquettes masquées uniquement pour le mode d’icône volumineux.
LVS_EX_MULTIWORKAREAS
Si le contrôle list-view a le style LVS_AUTOARRANGE , le contrôle ne réorganise pas automatiquement ses icônes tant qu’une ou plusieurs zones de travail ne sont pas définies (voir LVM_SETWORKAREAS). Pour être efficace, ce style doit être défini avant que des zones de travail ne soient définies et que tous les éléments aient été ajoutés au contrôle.
LVS_EX_ONECLICKACTIVATE
Le contrôle d’affichage de liste envoie un code de notification LVN_ITEMACTIVATE à la fenêtre parente lorsque l’utilisateur clique sur un élément. Ce style active également le suivi à chaud dans le contrôle list-view. Le suivi à chaud signifie que lorsque le curseur se déplace sur un élément, il est mis en surbrillance, mais n’est pas sélectionné. Pour plus d’informations sur l’activation d’élément, consultez la section Notes de styles étendues List-View.
LVS_EX_REGIONAL
Version 4.71 à la version 5.80 uniquement. Non pris en charge sur Windows Vista et versions ultérieures. Définit la région de la fenêtre d’affichage de liste pour inclure uniquement les icônes et le texte de l’élément à l’aide de SetWindowRgn. Toute zone qui ne fait pas partie d’un élément est exclue de la région de fenêtre. Ce style est uniquement disponible pour les contrôles d’affichage de liste qui utilisent le style LVS_ICON .
LVS_EX_SIMPLESELECT
Version 6.00 et ultérieure. En mode icône, déplace l’image d’état du contrôle en haut à droite du rendu des grandes icônes. Dans les affichages autres que l’affichage icône, aucune modification n’est apportée. Lorsque l’utilisateur modifie l’état à l’aide de la barre d’espace, tous les éléments sélectionnés se parcourent, et non l’élément avec le focus.
LVS_EX_SINGLEROW
Version 6.00 et ultérieure. Non utilisé.
LVS_EX_SNAPTOGRID
Version 6.00 et ultérieure. En mode icône, les icônes s’alignent automatiquement dans une grille.
LVS_EX_SUBITEMIMAGES
Permet d’afficher des images pour les sous-éléments. Ce style est disponible uniquement conjointement avec le style LVS_REPORT .
LVS_EX_TRACKSELECT
Active la sélection à chaud dans un contrôle d’affichage de liste. La sélection de suivi à chaud signifie qu’un élément est automatiquement sélectionné lorsque le curseur reste sur l’élément pendant une certaine période de temps. Le délai peut être modifié à partir du paramètre système par défaut avec un message LVM_SETHOVERTIME . Ce style s’applique à tous les styles du contrôle d’affichage liste. Vous pouvez vérifier si la sélection de suivi à chaud est activée en appelant SystemParametersInfo.
LVS_EX_TRANSPARENTBKGND
Windows Vista et versions ultérieures. L’arrière-plan est peint par le parent via WM_PRINTCLIENT.
LVS_EX_TRANSPARENTSHADOWTEXT
Windows Vista et versions ultérieures. Activez le texte d’ombre uniquement sur les arrière-plans transparents.
LVS_EX_TWOCLICKACTIVATE
Le contrôle d’affichage de liste envoie un code de notification LVN_ITEMACTIVATE à la fenêtre parente lorsque l’utilisateur double-clique sur un élément. Ce style active également le suivi à chaud dans le contrôle list-view. Le suivi à chaud signifie que lorsque le curseur se déplace sur un élément, il est mis en surbrillance, mais n’est pas sélectionné. Pour plus d’informations sur l’activation d’élément, consultez la section Notes de styles étendues List-View.
LVS_EX_UNDERLINECOLD
Provoque l’affichage des éléments non chauds qui peuvent être activés avec du texte souligné. Ce style nécessite également que LVS_EX_TWOCLICKACTIVATE être défini. Pour plus d’informations sur l’activation d’élément, consultez la section Notes de styles étendues List-View.
LVS_EX_UNDERLINEHOT
Provoque l’affichage des éléments chauds qui peuvent être activés avec du texte souligné. Ce style nécessite que LVS_EX_ONECLICKACTIVATE ou LVS_EX_TWOCLICKACTIVATE également défini. Pour plus d’informations sur l’activation d’élément, consultez la section Notes de styles étendues List-View.

Notes

Notes

Comctl32.dll version 6 n’est pas redistribuable, mais elle est incluse dans Windows. Pour utiliser Comctl32.dll version 6, spécifiez-le dans un manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

Un élément devient chaud lorsque la souris pointe dessus. Si le suivi à chaud est activé, les éléments chauds sont mis en surbrillance, mais l’utilisateur doit toujours cliquer sur l’élément au moins une fois pour le sélectionner. L’activation d’un élément entraîne l’envoi d’une notification LVN_ITEMACTIVATE par le contrôle d’affichage de liste. Un élément peut être sélectionné lorsqu’il est dans un état dans lequel un seul clic le sélectionne.

Si le style LVS_EX_ONECLICKACTIVATE est défini, un seul clic est nécessaire pour sélectionner un élément, de sorte que tous les éléments peuvent être sélectionnés. Si le style LVS_EX_TWOCLICKACTIVATE est défini, deux clics sont nécessaires pour sélectionner un élément. Avec ce style, l’élément ne peut être sélectionné qu’après avoir cliqué une seule fois.

La définition du style LVS_EX_UNDERLINEHOT entraîne le soulignement du texte d’un élément actif qui peut être sélectionné. La définition du style LVS_EX_UNDERLINECOLD entraîne le soulignement du texte des éléments qui ne sont pas chauds, mais qui peuvent être sélectionnés.

Spécifications

Condition requise Valeur
En-tête
CommCtrl.h

Voir aussi

Styles de List-View étendus