BCM_SETIMAGELIST訊息

將影像清單指派給按鈕控制項。 您可以明確傳送此訊息，或使用 Button_SetImageList 宏。

參數

wParam

未使用;必須是零。

lParam

包含影像清單資訊的 BUTTON_IMAGELIST 結構的指標。

傳回值

如果訊息成功，則會傳回 TRUE。 否則會傳回 FALSE。

備註

注意

若要使用此訊息，您必須提供指定 Comclt32.dll 6.0 版的資訊清單。 如需資訊清單的詳細資訊，請參閱 啟用視覺樣式。

BUTTON_IMAGELIST結構之himl成員中所參考的影像清單應該包含要用於所有狀態的單一影像，或每個狀態的個別影像。 下列狀態定義于 vssym32.h 中。

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

請注意，PBS_STYLUSHOT僅適用于平板電腦。

每個值都是影像清單中適當影像的索引。 如果只有一個影像存在，則會用於所有狀態。 如果影像清單包含多個影像，則每個索引都會對應至按鈕的一個狀態。 如果未為每個狀態提供影像，則不會針對沒有影像的那些狀態繪製任何專案。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	Commctrl.h