IMAGELISTDRAWPARAMS 구조체(commoncontrols.h)

아티클
06/08/2023

이미지 목록 그리기 작업에 대한 정보를 포함하며 IImageList::Draw 함수와 함께 사용됩니다.

구문

typedef struct _IMAGELISTDRAWPARAMS {
  DWORD      cbSize;
  HIMAGELIST himl;
  int        i;
  HDC        hdcDst;
  int        x;
  int        y;
  int        cx;
  int        cy;
  int        xBitmap;
  int        yBitmap;
  COLORREF   rgbBk;
  COLORREF   rgbFg;
  UINT       fStyle;
  DWORD      dwRop;
  DWORD      fState;
  DWORD      Frame;
  COLORREF   crEffect;
} IMAGELISTDRAWPARAMS;

멤버

cbSize

형식: DWORD

이 구조체의 크기(바이트)입니다.

himl

형식: HIMAGELIST

그릴 이미지가 포함된 이미지 목록에 대한 핸들입니다.

i

형식: int

그릴 이미지의 인덱스(0부터 시작)입니다.

hdcDst

형식: HDC

대상 디바이스 컨텍스트에 대한 핸들입니다.

x

형식: int

이미지가 그려지는 위치를 지정하는 x 좌표입니다.

y

형식: int

이미지를 그릴 위치를 지정하는 y 좌표입니다.

cx

형식: int

xBitmap 및 yBitmap으로 지정된 그리기 작업의 왼쪽 위 모서리를 기준으로 그릴 픽셀 수를 지정하는 값입니다. cx 및 cy가 0이면 그리기에서 유효한 섹션 전체를 그립니다. 메서드는 매개 변수가 유효한지 확인하지 않습니다.

cy

형식: int

xBitmap

형식: int

이미지 자체를 참조하여 그리기 작업의 왼쪽 위 모서리를 지정하는 x 좌표입니다. xBitmap의 왼쪽과 yBitmap 위에 있는 이미지의 픽셀이 표시되지 않습니다.

yBitmap

형식: int

이미지 자체를 참조하여 그리기 작업의 왼쪽 위 모서리를 지정하는 y 좌표입니다. xBitmap의 왼쪽과 yBitmap 위에 있는 이미지의 픽셀이 표시되지 않습니다.

rgbBk

형식: COLORREF

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

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

rgbFg

형식: COLORREF

이미지 전경색입니다. 이 멤버는 fStyle 에 ILD_BLEND25 또는 ILD_BLEND50 플래그가 포함된 경우에만 사용됩니다. 이 매개 변수는 애플리케이션 정의 RGB 값 또는 다음 값 중 하나일 수 있습니다.

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

fStyle

형식: UINT

그리기 스타일 및 필요에 따라 오버레이 이미지를 지정하는 플래그입니다. 오버레이 이미지에 대한 자세한 내용은 이 항목의 끝에 있는 주석 섹션을 참조하세요. 이 멤버는 하나 이상의 이미지 목록 그리기 플래그를 포함할 수 있습니다.

dwRop

형식: DWORD

래스터 작업 코드를 지정하는 값입니다. 이러한 코드는 원본 사각형의 색 데이터를 대상 사각형의 색 데이터와 결합하여 최종 색을 달성하는 방법을 정의합니다. fStyle에 ILD_ROP 플래그가 포함되지 않은 경우 이 멤버는 무시됩니다. 몇 가지 일반적인 래스터 작업 코드는 다음과 같습니다.

값	의미
한밤중	실제 팔레트에서 인덱스 0과 연결된 색을 사용하여 대상 사각형을 채웁니다. 기본 실제 색상표의 경우 이 색은 검정입니다.
DSTINVERT	대상 사각형을 반전합니다.
MERGECOPY	부울 AND 연산자를 사용하여 원본 사각형 색을 지정된 패턴과 병합합니다.
MERGEPAINT	부울 OR 연산자를 사용하여 반전된 원본 사각형 색을 대상 사각형 색과 병합합니다.
NOTSRCCOPY	반전된 원본 사각형을 대상에 복사합니다.
NOTSRCERASE	부울 OR 연산자를 사용하여 원본 및 대상 사각형 색을 결합합니다. 결과 색을 반전합니다.
PATCOPY	지정된 패턴을 대상 비트맵에 복사합니다.
PATINVERT	부울 XOR 연산자를 사용하여 지정된 패턴 색을 대상 사각형 색과 결합합니다.
PATPAINT	패턴 색을 반전된 원본 사각형 색과 결합하고 부울 OR 연산자를 사용하여 결과를 대상 사각형 색과 결합합니다.
SRCAND	부울 AND 연산자를 사용하여 원본 및 대상 사각형 색을 결합합니다.
SRCCOPY	원본 사각형을 대상 사각형에 직접 복사합니다.
SRCERASE	부울 AND 연산자를 사용하여 대상 사각형의 반전된 색을 원본 사각형 색 과 결합합니다.
SRCINVERT	부울 XOR 연산자를 사용하여 원본 및 대상 사각형 색을 결합합니다.
SRCPAINT	부울 OR 연산자를 사용하여 원본 및 대상 사각형 색을 결합합니다.
순 결을	실제 팔레트에서 인덱스 1과 연결된 색을 사용하여 대상 사각형을 채웁니다. 이 색은 기본 물리적 색상표의 경우 흰색입니다.

fState

형식: DWORD

그리기 상태를 지정하는 플래그입니다. 이 멤버는 하나 이상의 이미지 목록 상태 플래그를 포함할 수 있습니다. 이 멤버를 사용하려면 comctl32.dll 버전 6을 사용해야 합니다. 설명을 참조하세요.

Frame

형식: DWORD

알파 혼합 효과와 함께 사용됩니다.

ILS_ALPHA 사용하는 경우 이 멤버는 알파 채널의 값을 보유합니다. 이 값은 0에서 255까지일 수 있으며 0은 완전히 투명하고 255는 완전히 불투명합니다.

이 멤버를 사용하려면 comctl32.dll 버전 6을 사용해야 합니다. 설명을 참조하세요.

crEffect

형식: DWORD

네온 및 그림자 효과에 사용되는 색입니다. 이 멤버를 사용하려면 comctl32.dll 버전 6을 사용해야 합니다. 설명을 참조하세요.

설명

오버레이 이미지는 이 구조체의 i 멤버에 지정된 기본 이미지 위에 그려지는 이미지입니다. 오버레이 이미지를 지정하려면 비트 OR 연산자를 사용하여 fStyle 을 INDEXTOOVERLAYMASK 매크로와 결합하여 매크로에서 오버레이 이미지의 1 기반 인덱스를 전달합니다. 이 이미지는 이전에 ImageList_SetOverlayImage API를 사용하여 오버레이 이미지로 지정되어야 합니다.

fStyle에서 오버레이 이미지를 추출하려면 비트 AND 연산자를 사용하여 fStyle을 ILD_OVERLAYMASK 값으로 마스킹합니다.

Comctl32.dll 버전 6은 재배포할 수 없습니다. Comctl32.dll 버전 6을 사용하려면 매니페스트에 지정해야 합니다. 매니페스트에 대한 자세한 내용은 시각적 스타일 사용을 참조하세요.

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	commoncontrols.h(Commctrl.h 포함)

다음을 통해 공유

IMAGELISTDRAWPARAMS 구조체(commoncontrols.h)

구문

멤버

설명

요구 사항

피드백

추가 리소스