BCM _ SETIMAGELIST-Meldung

Weist einem Schaltflächensteuerelement eine Bildliste zu. Sie können diese Nachricht explizit senden oder das Button _ SetImageList-Makro verwenden.

Parameter

wParam

Nicht verwendet; muss 0 (null) sein.

lParam

Ein Zeiger auf eine BUTTON _ IMAGELIST-Struktur, die Bildlisteninformationen enthält.

Rückgabewert

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

Hinweise

Hinweis

Um diese Meldung 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 Stilen.

Die Bildliste, auf die im himl-Member 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 sind 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 Tabletcomputern 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 mehr als ein Bild 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 [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Commctrl.h