ImageList_Draw

ImageList_Draw

지정된 디바이스 콘텍스트에 이미지 리스트의 아이템을 묘화 합니다.

BOOL ImageList_Draw(
    HIMAGELIST himl,  // 이미지 리스트의 핸들
    int   index,      // 이미지의 인덱스
    HDC   hdcDest,    // 묘화처 디바이스 콘텍스트
    int   x,          // 묘화처x좌표
    int   y,          // 묘화처y좌표
    UINT  fStyle      // 묘화 스타일
);

COMCTL32.DLL

인수

himl

이미지 리스트의 핸들을 지정합니다.

index

묘화 하는 이미지의 인덱스를 지정합니다.

hdcDest

묘화처의 디바이스 콘텍스트의 핸들을 지정합니다.

x, y

묘화처의 좌표를 지정합니다.

fStyle

묘화 스타일을 지정합니다.또, 오버레이 이미지의 인덱스를 맞추어 지정할 수 있습니다.

묘화 스타일은 이하의 값을 지정합니다.

치	의미
0x0000 (ILD_NORMAL)	이미지 리스트의 백그라운드 칼라를 사용해 이미지를 묘화 합니다.백그라운드 칼라가 CLR_NONE (0xFFFFFFFF) (이)라면, 이미지는 마스크를 사용해 투명하게 묘화 됩니다.
0x0001 (ILD_TRANSPARENT)	이미지 리스트의 백그라운드 칼라에 관계없이, 마스크를 사용해 투명하게 묘화 됩니다.마스크를 사용하지 않는 경우는 이 플래그는 무시됩니다.
0x0002 (ILD_BLEND25, ILD_FOCUS)	시스템의 강조 표시색을 25% 혼합하고, 이미지를 묘화 합니다.이미지 리스트가 마스크를 가지고 있지 않을 때는, 이 값은 유효하지는 않습니다.
0x0004 (ILD_BLEND50, ILD_SELECTED, ILD_BLEND)	시스템의 강조 표시색을 50% 혼합하고, 이미지를 묘화 합니다.이미지 리스트가 마스크를 가지고 있지 않을 때는, 이 값은 유효하지는 않습니다.
0x0010 (ILD_MASK)	마스크를 묘화 합니다.

오버레이 이미지를 사용하는 경우는, 오버레이 이미지의 인덱스를 8 비트분만큼 왼쪽 비트 시프트 한 것을 OR 결합하는 것으로 지정합니다.미리 ImageList_SetOverlayImage 함수를 이용해 오버레이 이미지를 지정해 두지 않으면 안됩니다.

반환값

성공하면 0 이외의 값이 돌아갑니다.

실패하면 0 하지만 돌아갑니다.

대응 정보

Windows 95 이후 / Windows NT 3.51 이후