macro ListView_SetIconSpacing (commctrl.h)

Définit l’espacement entre les icônes dans les contrôles d’affichage de liste définis sur le style LVS_ICON. Vous pouvez utiliser cette macro ou envoyer explicitement le message LVM_SETICONSPACING.

Syntaxe

DWORD ListView_SetIconSpacing(
   HWND hwndLV,
   int  cx,
   int  cy
);

Paramètres

hwndLV

Type : HWND

Handle vers un contrôle d’affichage de liste.

cx

Type : int

Distance, en pixels, à définir entre les icônes de l’axe x.

cy

Type : int

Distance, en pixels, à définir entre les icônes sur l’axe y.

Valeur de retour

Type : DWORD

Retourne une valeur DWORD qui contient la valeur précédente

Remarques

Les paramètres cx et cy sont relatifs au coin supérieur gauche d’une bitmap d’icône. Par conséquent, pour définir l’espacement entre les icônes qui ne se chevauchent pas, le cx ou valeurs cy doivent inclure la taille de l’icône, ainsi que la quantité d’espace vide souhaité entre les icônes. Les valeurs qui n’incluent pas la largeur de l’icône entraînent des chevauchements.

Lors de la définition de l’espacement des icônes, cx et cy doivent être définis sur 4 ou plus. Les valeurs plus petites ne produisent pas la disposition souhaitée. Vous pouvez réinitialiser cx et cy à l’espacement par défaut en définissant les deux valeurs sur -1. Cette approche vous permet uniquement de réinitialiser les deux paramètres par défaut. Vous ne pouvez pas réinitialiser uniquement cx ou cy au paramètre par défaut en définissant l’un d’eux sur -1.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	commctrl.h