TVM_GETITEMRECT message

Récupère le rectangle englobant d’un élément d’arborescence et indique si l’élément est visible. Vous pouvez envoyer ce message explicitement ou à l’aide de la macro TreeView_GetItemRect .

Paramètres

wParam

Valeur spécifiant la partie de l’élément pour laquelle récupérer le rectangle englobant. Si ce paramètre a la valeur TRUE, le rectangle englobant inclut uniquement le texte de l’élément. Sinon, elle inclut la ligne entière que l’élément occupe dans le contrôle d’arborescence.

lParam

Pointeur vers une structure RECT qui, lors de l’envoi du message, contient le handle de l’élément pour lequel récupérer le rectangle. Consultez l’exemple ci-dessous pour plus d’informations sur la façon de placer le handle d’élément dans ce paramètre. Après le retour du message, ce paramètre contient le rectangle englobant. Les coordonnées sont relatives à l’angle supérieur gauche du contrôle arborescence.

Valeur retournée

Si l’élément est visible et que le rectangle englobant a été récupéré avec succès, la valeur de retour est TRUE. Sinon, le message retourne FALSE et ne récupère pas le rectangle englobant.

Notes

Lors de l’envoi de ce message, le paramètre lParam contient le handle de l’élément pour lequel le rectangle est récupéré. Le handle est placé dans lParam , comme illustré dans l’exemple suivant :

RECT rc;

*(HTREEITEM*)&rc = hTreeItem;

SendMessage(hwndTreeView, TVM_GETITEMRECT, FALSE, (LPARAM)&rc);

Spécifications

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]
En-tête
Commctrl.h