ListBox_SetCaretIndex Makro (windowsx.h)

Artikel
10/24/2024

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. Sie können dieses Makro verwenden oder die LB_SETCARETINDEX Nachricht explizit senden.

Syntax

int ListBox_SetCaretIndex(
   HWND hwndCtl,
   int  index
);

Parameter

hwndCtl

Typ: HWND-

Ein Handle für das Steuerelement.

index

Typ: int

der nullbasierte Index des Listenfeldelements, das das Fokusrechteck erhält.

Rückgabewert

Typ: int

Wenn ein Fehler auftritt, wird der Rückgabewert LB_ERR.

Bemerkungen

Der Inhalt des Listenfelds wird gescrollt, bis das Element vollständig sichtbar ist.

Weitere Informationen finden Sie unter LB_SETCARETINDEX.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	windowsx.h

Freigeben über