ImageList_Draw 함수(commctrl.h)
지정된 디바이스 컨텍스트에서 이미지 목록 항목을 그립니다.
구문
BOOL ImageList_Draw(
HIMAGELIST himl,
int i,
HDC hdcDst,
int x,
int y,
UINT fStyle
);
매개 변수
himl
형식: HIMAGELIST
이미지 목록에 대한 핸들입니다.
i
형식: int
그릴 이미지의 인덱스(0부터 시작)입니다.
hdcDst
형식: HDC
대상 디바이스 컨텍스트에 대한 핸들입니다.
x
형식: int
지정된 디바이스 컨텍스트 내에서 그릴 x 좌표입니다.
y
형식: int
지정된 디바이스 컨텍스트 내에서 그릴 y 좌표입니다.
fStyle
형식: UINT
그리기 스타일 및 선택적으로 오버레이 이미지입니다. 오버레이 이미지 인덱스를 지정하는 방법에 대한 자세한 내용은 이 항목의 끝에 있는 주석 섹션을 참조하세요. 이 매개 변수는 오버레이 이미지 인덱스와 다음 값 중 하나 이상의 조합일 수 있습니다.
| 값 | 의미 |
|---|---|
|
|
|
25%를 시스템 강조 색과 혼합하여 이미지를 그립니다. 이미지 목록에 마스크가 포함되어 있지 않으면 이 값은 영향을 미치지 않습니다. |
|
50%를 시스템 강조 색과 혼합하여 이미지를 그립니다. 이미지 목록에 마스크가 포함되어 있지 않으면 이 값은 영향을 미치지 않습니다. |
|
|
|
오버레이에 마스크를 그릴 필요가 없는 경우 이 플래그를 설정합니다. 이 플래그를 사용하면 ImageList_DrawEx 마스크를 무시하고 이미지만 그립니다. |
|
마스크를 그립니다. |
|
이미지 목록의 배경색을 사용하여 이미지를 그립니다. 배경색이 CLR_NONE 값이면 마스크를 사용하여 이미지를 투명하게 그립니다. |
|
|
|
배경색과 상관없이 마스크를 사용하여 이미지를 투명하게 그립니다. 이미지 목록에 마스크가 포함되어 있지 않으면 이 값은 영향을 미치지 않습니다. |
반환 값
형식: BOOL
성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다.
설명
오버레이 이미지는 i 매개 변수에 지정된 기본 이미지 위에 투명하게 그려집니다. fStyle 매개 변수에 오버레이 이미지를 지정하려면 INDEXTOOVERLAYMASK 매크로를 사용하여 오버레이 이미지의 1 기반 인덱스를 이동합니다. OR 연산자를 사용하여 매크로의 반환 값을 fStyle 매개 변수에 지정된 그리기 스타일 플래그와 논리적으로 결합합니다. 먼저 ImageList_SetOverlayImage 함수를 사용하여 이 이미지를 오버레이 이미지로 지정해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | commctrl.h |
| 라이브러리 | Comctl32.lib |
| DLL | Comctl32.dll |
| API 세트 | ext-ms-win-shell-comctl32-init-l1-1-1(Windows 10 버전 10.0.14393에 도입됨) |