macro ListView_GetItemIndexRect (commctrl.h)

  • Article

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 le message LVM_GETITEMINDEXRECT explicitement.

Syntaxe

void ListView_GetItemIndexRect(
  [in]       hwnd,
  [in]       plvii,
  [in]       iSubItem,
  [in]       code,
  [in, out]  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 avoir la valeur NULL.

[in] iSubItem

Type : LONG

Index du sous-élément.

[in] code

Type : LONG

Partie du sous-élément list-view pour laquelle récupérer le rectangle englobant. Ce paramètre peut prendre les 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 du 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 avoir la valeur NULL.

Valeur de retour

None

Remarques

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

Configuration requise

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