BCM_SETIMAGELIST 메시지

단추 컨트롤에 이미지 목록을 할당합니다. 이 메시지를 명시적으로 보내거나 Button_SetImageList 매크로를 사용할 수 있습니다.

매개 변수

wParam

사용되지 않음, 0이어야 합니다.

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