LBItemFromPt-Funktion (commctrl.h)

Ruft den Index des Elements am angegebenen Punkt in einem Listenfeld ab.

Syntax

C++

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

Parameter

hLB

Typ: HWND

Ein Handle für das zu überprüfende Listenfeld.

pt

Typ: POINT

Eine POINT-Struktur , die die zu überprüfenden Bildschirmkoordinaten enthält.

bAutoScroll

Typ: BOOL

Ein Bildlaufflag. Wenn dieser Parameter TRUE ist und sich der Punkt direkt über oder unterhalb des Listenfelds befindet, scrollt die Funktion das Listenfeld um eine Zeile und gibt -1 zurück. Andernfalls scrollt die Funktion nicht im Listenfeld.

Rückgabewert

Typ: int

Gibt den Elementbezeichner zurück, wenn sich der Punkt über einem Listenelement befindet, oder andernfalls -1.

Hinweise

Die LBItemFromPt-Funktion scrollt nur im Listenfeld, wenn seit der letzten Ausführung eine minimale Zeit vergangen ist. Die Zeitsteuerung verhindert, dass das Listenfeld zu schnell scrollt, wenn die Funktion wiederholt in schneller Folge aufgerufen wird, z. B. wenn DL_DRAGGING Benachrichtigungscodes oder WM_MOUSEMOVE Nachrichten verarbeitet werden.

Wenn sich der angegebene Punkt außerhalb des Clientbereichs des Listenfelds befindet und bAutoScrolltrue ist, scrollt die Funktion im Listenfeld, anstatt einen Elementbezeichner zurückzugeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	commctrl.h
Bibliothek	Comctl32.lib
DLL	Comctl32.dll