Partager via

macro ListView_SetItemPosition (commctrl.h)

  • Article

Déplace un élément vers une position spécifiée dans un contrôle d’affichage de liste (en icône ou en mode petite icône). Vous pouvez utiliser cette macro ou envoyer explicitement le message LVM_SETITEMPOSITION.

Syntaxe

BOOL ListView_SetItemPosition(
   HWND hwndLV,
   int  i,
   int  x,
   int  y
);

Paramètres

hwndLV

Type : HWND

Handle du contrôle list-view.

i

Type : int

Index de l’élément d’affichage de liste.

x

Type : int

Nouvelle position x du coin supérieur gauche de l’élément, en coordonnées d’affichage.

y

Type : int

Nouvelle position y du coin supérieur gauche de l’élément, en coordonnées d’affichage.

Valeur de retour

Type : BOOL

Retourne TRUE en cas de réussite ou FALSE sinon.

Remarques

Si le contrôle d’affichage de liste a le style LVS_AUTOARRANGE, le contrôle d’affichage de liste est organisé après la définition de la position de l’élément.

Sur Windows Vista, l’appel de cette macro sur un contrôle d’affichage de liste avec le style LVS_AUTOARRANGE ne fait rien, et la valeur de retour est FALSE.

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