Guide pratique pour utiliser les vues de vignettes
Cette rubrique montre comment définir l’affichage en mosaïque pour un contrôle d’affichage de liste. En mode vignette, chaque élément est représenté par une grande icône avec une ou plusieurs lignes de texte d’accompagnement. Pour obtenir une illustration, consultez À propos des contrôles List-View.
Bon à savoir
Technologies
Prérequis
- C/C++
- Programmation de l’interface utilisateur Windows
Instructions
Définissez les paramètres d’affichage généraux de l’affichage par vignette à l’aide de la macro ListView_SetTileViewInfo . Utilisez la structure LVTILEVIEWINFO qui est passée à cette macro pour spécifier la position du texte par rapport à l’icône, la taille de chaque vignette (y compris le texte qui l’accompagne) et le nombre maximal de lignes de texte.
Si vous ne souhaitez pas que les vignettes soient automatiquement dimensionnées, vous devez définir LVTVIF_FIXEDSIZE dans le membre dwFlags et LVTVIM_TILESIZE dans le membre dwMask de LVTILEVIEWINFO, ainsi que fournir les dimensions dans le membre sizeTile .
L’exemple de code C++ suivant définit les informations d’affichage par vignette d’un contrôle d’affichage de liste afin qu’un maximum de deux sous-éléments soient affichés pour chaque élément. Il définit également la taille de chaque vignette.
SIZE size = { 100, 50 };
LVTILEVIEWINFO tileViewInfo = {0};
tileViewInfo.cbSize = sizeof(tileViewInfo);
tileViewInfo.dwFlags = LVTVIF_FIXEDSIZE;
tileViewInfo.dwMask = LVTVIM_COLUMNS | LVTVIM_TILESIZE;
tileViewInfo.cLines = 2;
tileViewInfo.sizeTile = size;
ListView_SetTileViewInfo(hWndListView, &tileViewInfo);
Pour chaque élément de la liste, vous pouvez définir d’autres paramètres lorsque l’élément est inséré dans la liste ou version ultérieure. La structure LVITEM utilisée avec ListView_InsertItem contient des membres qui spécifient les colonnes de données à afficher sous l’élément et leur alignement. Ces mêmes paramètres d’affichage se trouvent également dans la structure LVTILEINFO utilisée avec ListView_SetTileInfo.
Notes
Le terme « Colonnes » fait ici référence non pas à l’affichage des colonnes en mode vignette, mais plutôt aux sous-éléments, qui sont affichés dans les colonnes en mode Détails.
Rubriques connexes