Función LBItemFromPt (commctrl.h)

Recupera el índice del elemento en el punto especificado de un cuadro de lista.

Sintaxis

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

Parámetros

hLB

Tipo: HWND

Identificador de la casilla de lista que se va a activar.

pt

Tipo: POINT

Estructura POINT que contiene las coordenadas de pantalla que se van a comprobar.

bAutoScroll

Tipo: BOOL

Marca de desplazamiento. Si este parámetro es TRUE y el punto está directamente encima o debajo del cuadro de lista, la función desplaza el cuadro de lista por una línea y devuelve -1. De lo contrario, la función no desplaza el cuadro de lista.

Valor devuelto

Tipo: int

Devuelve el identificador de elemento si el punto está sobre un elemento de lista o -1 de lo contrario.

Comentarios

La función LBItemFromPt solo desplaza el cuadro de lista si ha transcurrido una cantidad mínima de tiempo desde que lo hizo por última vez. El tiempo impide que el cuadro de lista se desplace demasiado rápidamente si se llama a la función repetidamente en una sucesión rápida; por ejemplo, cuando se procesan DL_DRAGGING códigos de notificación o mensajes de WM_MOUSEMOVE .

Si el punto especificado está fuera del área cliente del cuadro de lista y bAutoScroll es TRUE, la función desplaza el cuadro de lista en lugar de devolver un identificador de elemento.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commctrl.h
Library	Comctl32.lib
Archivo DLL	Comctl32.dll