macro ListView_GetItemIndexRect (commctrl.h)

Article
10/24/2024

Obtient le rectangle englobant pour tout ou partie d’un sous-élément dans l’affichage actuel d’un contrôle list-view spécifié. Utilisez cette macro ou envoyez explicitement le message LVM_GETITEMINDEXRECT.

Syntaxe

BOOL ListView_GetItemIndexRect(
  [in]      HWND        hwnd,
  [in]      LVITEMINDEX *plvii,
  [in]      LONG        iSubItem,
  [in]      LONG        code,
  [in, out] LPRECT      prc
);

Paramètres

[in] hwnd

Type : HWND

Handle du contrôle list-view.

[in] plvii

Type : LVITEMINDEX*

Pointeur vers une structure LVITEMINDEX pour l’élément parent du sous-élément. L’appelant est responsable de l’allocation de cette structure et de la définition de ses membres. plvii ne doit pas être NULL .

[in] iSubItem

Type : LONG

Index du sous-élément.

[in] code

Type : LONG

Partie du sous-élément d’affichage de liste pour laquelle récupérer le rectangle englobant. Ce paramètre doit être l’une des valeurs suivantes.

Valeur	Signification
LVIR_BOUNDS	Retourne le rectangle englobant de l’ensemble du sous-élément, y compris l’icône et l’étiquette.
LVIR_ICON	Retourne le rectangle englobant de l’icône ou de la petite icône du sous-élément.
LVIR_LABEL	Retourne le rectangle englobant du texte sous-élément.

[in, out] prc

Type : LPRECT

Pointeur vers une structure RECT pour recevoir les coordonnées. L’appelant est responsable de l’allocation de cette structure. prc ne doit pas être NULL .

Valeur de retour

Type : BOOL

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

Remarques

Si iSubItem est égal à zéro, cette macro renvoie les coordonnées du rectangle à l’élément pointé par plvii. La valeur LVIR_SELECTBOUNDS du code paramètre n’est pas prise en charge.

Exigences

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

Partager via