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

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

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

반환 값

형식: 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에 도입됨)