Fonction LBItemFromPt (commctrl.h)

Article
02/24/2024

Récupère l’index de l’élément au point spécifié dans une zone de liste.

Syntaxe

int LBItemFromPt(
  HWND  hLB,
  POINT pt,
  BOOL  bAutoScroll
);

Paramètres

hLB

Type : HWND

Handle de la zone de liste pour case activée.

pt

Type : POINT

Structure POINT qui contient les coordonnées de l’écran à case activée.

bAutoScroll

Type : BOOL

Indicateur de défilement. Si ce paramètre a la valeur TRUE et que le point se trouve directement au-dessus ou en dessous de la zone de liste, la fonction fait défiler la zone de liste d’une ligne et retourne -1. Sinon, la fonction ne fait pas défiler la zone de liste.

Valeur retournée

Type : int

Retourne l’identificateur d’élément si le point est sur un élément de liste, ou -1 dans le cas contraire.

Remarques

La fonction LBItemFromPt fait défiler la zone de liste uniquement si un délai minimal s’est écoulé depuis la dernière fois. Le minutage empêche la zone de liste de défiler trop rapidement si la fonction est appelée à plusieurs reprises dans une succession rapide, par exemple lorsque DL_DRAGGING codes de notification ou WM_MOUSEMOVE messages sont traités.

Si le point spécifié se trouve en dehors de la zone cliente de la zone de liste et que bAutoScroll a la valeur TRUE, la fonction fait défiler la zone de liste au lieu de renvoyer un identificateur d’élément.

Configuration requise

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]
Plateforme cible	Windows
En-tête	commctrl.h
Bibliothèque	Comctl32.lib
DLL	Comctl32.dll

Partager via