commctrl.h

Función LBItemFromPt

Recupera el índice del ítem en el punto especificado de un list box.

Sintaxis

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

Parámetros

hLB: Un manipulador al list box a verificar.

pt: Una estructura POINT que contiene las coordenadas de pantalla a verificar.

bAutoScroll: Una bandera de desplazamiento. Si este parámetro es TRUE y el punto está directamente encima o debajo del list box, la función desplaza el list box una línea y retorna -1. En caso contrario, la función no desplaza el list box.

Valor de retorno

Devuelve el identificador del ítem si el punto está sobre un ítem de la lista, o -1 en caso contrario.

Observaciones

La función LBItemFromPt solo desplaza el list box si ha transcurrido una mínima cantidad de tiempo desde que lo hizo por última vez. Este tiempo evita que el list box se desplace demasiado rápido si la función es invocada repetidamente en una rápida sucesión —por ejemplo, cuando se procesan códigos de notificación DL_DRAGGING o mensajes WM_MOUSEMOVE.

Si el punto especificado está fuera del área de cliente del list box y bAutoScroll es TRUE, la función desplaza el contenido del list box en lugar de devolver un identificado de ítem.