다음을 통해 공유


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

이미지의 왼쪽 위 모서리를 기준으로 그릴 이미지 부분의 너비입니다. dxdy가 0이면 함수는 전체 이미지를 그립니다. 함수는 매개 변수가 유효한지 확인하지 않습니다.

dy

형식: int

이미지의 왼쪽 위 모서리를 기준으로 그릴 이미지 부분의 높이입니다. dxdy가 0이면 함수는 전체 이미지를 그립니다. 함수는 매개 변수가 유효한지 확인하지 않습니다.

rgbBk

형식: COLORREF

이미지의 배경색입니다. 이 매개 변수는 애플리케이션 정의 RGB 값 또는 다음 값 중 하나일 수 있습니다.

의미
CLR_NONE
배경색이 없습니다. 이미지가 투명하게 그려집니다.
CLR_DEFAULT
기본 배경색입니다. 이미지는 이미지 목록의 배경색을 사용하여 그려집니다.

rgbFg

형식: COLORREF

이미지의 전경색입니다. 이 매개 변수는 애플리케이션 정의 RGB 값 또는 다음 값 중 하나일 수 있습니다.

의미
CLR_NONE
혼합 색이 없습니다. 이미지는 대상 디바이스 컨텍스트의 색과 혼합됩니다.
CLR_DEFAULT
기본 전경색입니다. 이미지는 시스템 강조 색을 전경색으로 사용하여 그려집니다.

fStyle

형식: UINT

그리기 스타일 및 선택적으로 오버레이 이미지입니다. 오버레이 이미지 인덱스를 지정하는 방법에 대한 자세한 내용은 이 항목의 끝에 있는 주석 섹션을 참조하세요. 이 매개 변수는 오버레이 이미지 인덱스와 다음 값 중 하나 이상의 조합일 수 있습니다.

의미
ILD_BLEND
ILD_BLEND25
rgbFg에서 지정한 혼합 색과 25% 혼합하여 이미지를 그립니다. 이미지 목록에 마스크가 포함되어 있지 않으면 이 값은 영향을 미치지 않습니다.
ILD_BLEND50
rgbFg에서 지정한 혼합 색과 50% 혼합하여 이미지를 그립니다. 이미지 목록에 마스크가 포함되어 있지 않으면 이 값은 영향을 미치지 않습니다.
ILD_FOCUS
ILD_IMAGE
오버레이에 마스크를 그릴 필요가 없는 경우 이 플래그를 설정합니다. 이 플래그를 사용하면 ImageList_DrawEx 마스크를 무시하고 이미지만 그립니다.
ILD_MASK
마스크를 그립니다.
ILD_NORMAL
이미지 목록의 배경색을 사용하여 이미지를 그립니다. 배경색이 CLR_NONE 값이면 마스크를 사용하여 이미지를 투명하게 그립니다.
ILD_SELECTED
ILD_TRANSPARENT
배경색과 상관없이 마스크를 사용하여 이미지를 투명하게 그립니다. 이미지 목록에 마스크가 포함되어 있지 않으면 이 값은 영향을 미치지 않습니다.

반환 값

형식: BOOL

성공하면 0이 아닌 값을 반환하고 그렇지 않으면 0을 반환합니다.

설명

오버레이 이미지는 i 매개 변수에 지정된 기본 이미지 위에 투명하게 그려집니다. fStyle 매개 변수에 오버레이 이미지를 지정하려면 INDEXTOOVERLAYMASK 매크로를 사용하여 오버레이 이미지의 한 기반 인덱스를 이동합니다. OR 연산자를 사용하여 매크로의 반환 값을 fStyle 매개 변수에 지정된 그리기 스타일 플래그와 논리적으로 결합합니다. 먼저 ImageList_SetOverlayImage 함수를 사용하여 이 이미지를 오버레이 이미지로 지정해야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 commctrl.h
라이브러리 Comctl32.lib
DLL Comctl32.dll