macro ListView_SetIconSpacing (commctrl.h)

  • Article

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

Syntaxe

void ListView_SetIconSpacing(
   hwndLV,
   cx,
   cy
);

Paramètres

hwndLV

Type : HWND

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

cx

Type : int

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

cy

Type : int

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

Valeur de retour

None

Remarques

Les paramètres cx et cy sont relatifs au coin supérieur gauche d’une image bitmap d’icône. Par conséquent, pour définir l’espacement entre les icônes qui ne se chevauchent pas, les valeurs cx ou cy doivent inclure la taille de l’icône, plus la quantité d’espace vide souhaitée 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 affectant à l’un d’eux la valeur -1.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête commctrl.h