LB_SETCARETINDEX Nachricht

Legt das Fokusrechteck auf das Element am angegebenen Index in einem Listenfeld mit mehrfacher Auswahl fest. Wenn das Element nicht sichtbar ist, wird es in die Ansicht gescrollt.

Parameter

wParam

Gibt den nullbasierten Index des Listenfeldelements an, das das Fokusrechteck empfangen soll.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): Der wParam-Parameter ist auf 16-Bit-Werte beschränkt. Dies bedeutet, dass Listenfelder nicht mehr als 32.767 Elemente enthalten dürfen. Obwohl die Anzahl der Elemente eingeschränkt ist, wird die Gesamtgröße der Elemente in einem Listenfeld nur durch den verfügbaren Arbeitsspeicher begrenzt.

lParam

Wenn dieser Wert FALSE ist, wird ein Bildlauf für das Element ausgeführt, bis es vollständig sichtbar ist. wenn es TRUE ist, wird ein Bildlauf für das Element ausgeführt, bis es zumindest teilweise sichtbar ist.

Rückgabewert

Wenn ein Fehler auftritt, lautet der Rückgabewert LB_ERR (-1). Andernfalls wird LB_OKAY (0) zurückgegeben.

Bemerkungen

Wenn diese Nachricht an ein Listenfeld mit einzeler Auswahl gesendet wird, das kein ausgewähltes Element enthält, wird der Caretindex auf das durch den wParam-Parameter angegebene Element festgelegt. Wenn das Listenfeld für die Einzelauswahl ein ausgewähltes Element enthält, gibt das Listenfeld LB_ERR zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Winuser.h (windows.h einschließen)

Siehe auch

LB_GETCARETINDEX