BCM_SETIMAGELIST Nachricht

Weist einem Schaltflächensteuerelement eine Bildliste zu. Sie können diese Nachricht explizit senden oder das makro Button_SetImageList verwenden.

Parameter

wParam

Nicht verwendet; muss null sein.

lParam

Ein Zeiger auf eine BUTTON_IMAGELIST-Struktur , die Bildlisteninformationen enthält.

Rückgabewert

Wenn die Nachricht erfolgreich ist, gibt sie TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Bemerkungen

Hinweis

Um diese Nachricht verwenden zu können, müssen Sie ein Manifest angeben, das Comclt32.dll Version 6.0 angibt. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.

Die Bildliste, auf die im Himlelement der BUTTON_IMAGELIST-Struktur verwiesen wird, sollte entweder ein einzelnes Bild enthalten, das für alle Zustände verwendet werden soll, oder einzelne Bilder für jeden Zustand. Die folgenden Zustände werden in vssym32.h definiert.

enum PUSHBUTTONSTATES {
    PBS_NORMAL = 1,
    PBS_HOT = 2,
    PBS_PRESSED = 3,
    PBS_DISABLED = 4,
    PBS_DEFAULTED = 5,
    PBS_STYLUSHOT = 6,
};

Beachten Sie, dass PBS_STYLUSHOT nur auf Tablet-Computern verwendet wird.

Jeder Wert ist ein Index für das entsprechende Bild in der Bildliste. Wenn nur ein Bild vorhanden ist, wird es für alle Zustände verwendet. Wenn die Bildliste mehrere Bilder enthält, entspricht jeder Index einem Zustand der Schaltfläche. Wenn kein Bild für jeden Zustand bereitgestellt wird, wird für diese Zustände ohne Bilder nichts gezeichnet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Header	Commctrl.h