ImageList_DrawEx 함수(commctrl.h)
지정된 디바이스 컨텍스트에서 이미지 목록 항목을 그립니다. 이 함수는 지정된 그리기 스타일을 사용하고 이미지를 지정된 색과 혼합합니다.
구문
BOOL ImageList_DrawEx(
HIMAGELIST himl,
int i,
HDC hdcDst,
int x,
int y,
int dx,
int dy,
COLORREF rgbBk,
COLORREF rgbFg,
UINT fStyle
);
매개 변수
himl
형식: HIMAGELIST
이미지 목록에 대한 핸들
i
형식: int
그릴 이미지의 인덱스입니다.
hdcDst
형식: HDC
대상 디바이스 컨텍스트에 대한 핸들입니다.
x
형식: int
지정된 디바이스 컨텍스트 내에서 그릴 x 좌표입니다.
y
형식: int
지정된 디바이스 컨텍스트 내에서 그릴 y 좌표입니다.
dx
형식: int
이미지의 왼쪽 위 모서리를 기준으로 그릴 이미지 부분의 너비입니다. dx 및 dy가 0이면 함수는 전체 이미지를 그립니다. 함수는 매개 변수가 유효한지 확인하지 않습니다.
dy
형식: int
이미지의 왼쪽 위 모서리를 기준으로 그릴 이미지 부분의 높이입니다. dx 및 dy가 0이면 함수는 전체 이미지를 그립니다. 함수는 매개 변수가 유효한지 확인하지 않습니다.
rgbBk
형식: COLORREF
이미지의 배경색입니다. 이 매개 변수는 애플리케이션 정의 RGB 값 또는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
배경색이 없습니다. 이미지가 투명하게 그려집니다. |
|
기본 배경색입니다. 이미지는 이미지 목록의 배경색을 사용하여 그려집니다. |
rgbFg
형식: COLORREF
이미지의 전경색입니다. 이 매개 변수는 애플리케이션 정의 RGB 값 또는 다음 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
혼합 색이 없습니다. 이미지는 대상 디바이스 컨텍스트의 색과 혼합됩니다. |
|
기본 전경색입니다. 이미지는 시스템 강조 색을 전경색으로 사용하여 그려집니다. |
fStyle
형식: UINT
그리기 스타일 및 선택적으로 오버레이 이미지입니다. 오버레이 이미지 인덱스를 지정하는 방법에 대한 자세한 내용은 이 항목의 끝에 있는 주석 섹션을 참조하세요. 이 매개 변수는 오버레이 이미지 인덱스와 다음 값 중 하나 이상의 조합일 수 있습니다.
반환 값
형식: BOOL
성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다.
설명
오버레이 이미지는 i 매개 변수에 지정된 기본 이미지 위에 투명하게 그려집니다. fStyle 매개 변수에 오버레이 이미지를 지정하려면 INDEXTOOVERLAYMASK 매크로를 사용하여 오버레이 이미지의 한 기반 인덱스를 이동합니다. OR 연산자를 사용하여 매크로의 반환 값을 fStyle 매개 변수에 지정된 그리기 스타일 플래그와 논리적으로 결합합니다. 먼저 ImageList_SetOverlayImage 함수를 사용하여 이 이미지를 오버레이 이미지로 지정해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | commctrl.h |
| 라이브러리 | Comctl32.lib |
| DLL | Comctl32.dll |
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기