STM_SETIMAGE 메시지
애플리케이션은 새 이미지를 정적 컨트롤과 연결하기 위해 STM_SETIMAGE 메시지를 보냅니다.
매개 변수
-
wParam
-
정적 컨트롤과 연결할 이미지 형식을 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
값 의미 - IMAGE_BITMAP
비트맵. - IMAGE_CURSOR
커서. - IMAGE_ENHMETAFILE
향상된 메타파일. - IMAGE_ICON
아이콘. -
lParam
-
정적 컨트롤과 연결할 이미지에 대한 핸들입니다.
반환 값
반환 값은 이전에 정적 컨트롤과 연결된 이미지에 대한 핸들입니다(있는 경우). 그렇지 않으면 NULL입니다.
설명
이미지를 정적 컨트롤과 연결하려면 컨트롤에 적절한 스타일이 있어야 합니다. 다음 표는 각 이미지 형식에 필요한 스타일을 보여 줍니다.
| 이미지 형식 | 정적 컨트롤 스타일 |
|---|---|
| IMAGE_BITMAP | SS_BITMAP |
| IMAGE_CURSOR | SS_ICON |
| IMAGE_ENHMETAFILE | SS_ENHMETAFILE |
| IMAGE_ICON | SS_ICON |
중요
Microsoft Win32 컨트롤 버전 6에서 STM_SETIMAGE 메시지를 사용하여 정적 컨트롤에 전달된 비트맵은 후속 STM_SETIMAGE 메시지에서 반환된 비트맵과 동일했습니다. 클라이언트는 정적 컨트롤에 전송된 모든 비트맵을 삭제할 책임이 있습니다.
Windows XP에서 STM_SETIMAGE 메시지에 전달된 비트맵에 알파가 0이 아닌 픽셀이 포함된 경우 정적 컨트롤은 비트맵의 복사본을 가져옵니다. 이 복사된 비트맵은 다음 STM_SETIMAGE 메시지에 의해 반환됩니다. 클라이언트 코드는 정적 컨트롤에 전달된 비트맵을 독립적으로 추적할 수 있지만 STM_SETIMAGE 메시지에서 반환된 비트맵을 확인하고 해제하지 않으면 비트맵이 누출됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 헤더 |
|