Freigeben über


LB_SETCARETINDEX message

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

Parameters

wParam

Gibt den nullbasierten Index des Listenfeldelements an, das das Fokusrechteck empfängt.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : The wParam parameter is limited to 16-bit values. Dies bedeutet, dass Listenfelder nicht mehr als 32.767 Elemente enthalten dürfen. Obwohl die Anzahl der Elemente eingeschränkt ist, ist die Gesamtgröße in Byte der Elemente in einem Listenfeld nur durch den verfügbaren Arbeitsspeicher begrenzt.

lParam

If this value is FALSE, the item is scrolled until it is fully visible; if it is TRUE, the item is scrolled until it is at least partially visible.

Return value

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

Remarks

If this message is sent to a single-selection list box that does not contain a selected item, the caret index is set to the item specified by the wParam parameter. Wenn das Listenfeld mit einer Auswahl ein ausgewähltes Element enthält, gibt das Listenfeld LB_ERR zurück.

Requirements

Requirement Value
Mindest unterstützter Client
Windows Vista [nur Desktop-Apps]
Unterstützter Mindestserver
Windows Server 2003 [Nur Desktop-Apps]
Header
Winuser.h (enthalten Windows.h)

See also

LB_GETCARETINDEX