macro ListView_GetSubItemRect (commctrl.h)

  • Article

Obtient des informations sur le rectangle qui entoure un sous-élément dans un contrôle list-view. Vous pouvez utiliser cette macro (recommandée) ou envoyer explicitement le message LVM_GETSUBITEMRECT. Cette macro est destinée à être utilisée uniquement sur les contrôles d’affichage de liste qui utilisent le style LVS_REPORT.

Syntaxe

BOOL ListView_GetSubItemRect(
   HWND   hwnd,
   int    iItem,
   int    iSubItem,
   int    code,
   LPRECT prc
);

Paramètres

hwnd

Type : HWND

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

iItem

Type : int

Index de l’élément parent du sous-élément.

iSubItem

Type : int

Index de base unique du sous-élément.

code

Type : int

Partie du sous-élément d’affichage de liste pour lequel récupérer les informations de rectangle englobant. Cette valeur peut être l’une des suivantes :

Valeur Signification
LVIR_BOUNDS
 Retourne le rectangle englobant de l’élément entier, y compris l’icône et l’étiquette.
LVIR_ICON
 Retourne le rectangle englobant de l’icône ou de la petite icône.
LVIR_LABEL
 Retourne le rectangle englobant de l’élément entier, y compris l’icône et l’étiquette. Cela est identique à LVIR_BOUNDS.

prc

Type : LPRECT

Pointeur vers une structure de RECT qui reçoit les informations du rectangle englobant sous-élément.

Valeur de retour

Type : BOOL

Retourne une valeur différente de zéro si elle réussit ou zéro dans le cas contraire.

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