ListView_SetImageList Makro (commctrl.h)

Artikel
10/24/2024

Weist einem Listenansicht-Steuerelement eine Bildliste zu. Sie können dieses Makro verwenden oder die LVM_SETIMAGELIST Nachricht explizit senden.

Syntax

HIMAGELIST ListView_SetImageList(
   HWND       hwnd,
   HIMAGELIST himl,
   int        iImageList
);

Parameter

hwnd

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

himl

Typ: HIMAGELIST

Ein Handle zur Bildliste, die zugewiesen werden soll.

iImageList

Typ: int

Der Typ der Bildliste. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
LVSIL_NORMAL	Bildliste mit großen Symbolen.
LVSIL_SMALL	Bildliste mit kleinen Symbolen.
LVSIL_STATE	Bildliste mit Statusbildern.
LVSIL_GROUPHEADER	Bildliste für Gruppenkopf.

Rückgabewert

Typ: HIMAGELIST

Gibt das Handle an die Bildliste zurück, die dem Steuerelement zuvor zugeordnet war, wenn dies erfolgreich war, oder NULL- andernfalls.

Bemerkungen

Die aktuelle Bildliste wird zerstört, wenn das Listenansicht-Steuerelement zerstört wird, es sei denn, die LVS_SHAREIMAGELISTS Formatvorlage ist festgelegt. Wenn Sie diese Meldung verwenden, um eine Bildliste durch eine andere zu ersetzen, muss Ihre Anwendung alle anderen Bildlisten als die aktuelle löschen.

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-	commctrl.h

Freigeben über