이미지 목록

이 섹션에서는 이미지 목록에 사용되는 프로그래밍 요소에 대한 정보를 제공합니다.

개요

항목	콘텐츠
이미지 목록	이미지 목록은 동일한 크기의 이미지 컬렉션으로 각 이미지는 해당 인덱스로 참조할 수 있습니다.

Functions

항목	콘텐츠
HIMAGELIST_QueryInterface	이미지 목록의 HIMAGELIST 핸들에 해당하는 IImageList 또는 IImageList2 개체에 대한 포인터를 검색합니다.
ImageList_Add	이미지 목록에 하나의 이미지 또는 여러 이미지를 추가합니다.
ImageList_AddMasked	이미지 목록에 하나의 이미지 또는 여러 이미지를 추가하여 지정된 비트맵에서 마스크를 생성합니다.
ImageList_BeginDrag	이미지 끌기를 시작합니다.
ImageList_CoCreateInstance	이미지 목록의 단일 인스턴스를 만들고 해당 인스턴스에 대한 인터페이스 포인터를 반환합니다.
ImageList_Copy	지정된 이미지 목록 내의 이미지를 복사합니다.
ImageList_Create	새 이미지 목록을 만듭니다.
ImageList_Destroy	이미지 목록을 제거합니다.
ImageList_DragEnter	창 내의 지정된 위치에 끌기 이미지를 표시합니다.
ImageList_DragLeave	지정된 창의 잠금을 해제하고 끌기 이미지를 숨겨 창을 업데이트할 수 있습니다.
ImageList_DragMove	끌어서 놓기 작업 중에 끌기 이미지를 이동합니다. 이 함수는 일반적으로 WM_MOUSEMOVE 메시지에 대한 응답으로 호출됩니다.
ImageList_DragShowNolock	끌기 이미지를 표시하거나 숨깁니다.
ImageList_Draw	지정된 디바이스 컨텍스트에서 이미지 목록 항목을 그립니다.
ImageList_DrawEx	지정된 디바이스 컨텍스트에서 이미지 목록 항목을 그립니다. 이 함수는 지정된 그리기 스타일을 사용하고 이미지를 지정된 색과 혼합합니다.
ImageList_DrawIndirect	IMAGELISTDRAWPARAMS 구조체를 기반으로 이미지 목록 이미지를 그립니다.
ImageList_Duplicate	기존 이미지 목록의 복제본을 만듭니다.
ImageList_EndDrag	끌기 작업을 종료합니다.
ImageList_GetBkColor	이미지 목록의 현재 배경색을 검색합니다.
ImageList_GetDragImage	끌기 이미지에 사용되는 임시 이미지 목록을 검색합니다. 또한 이 함수는 현재 끌기 위치와 끌기 위치를 기준으로 끌어온 이미지의 오프셋을 검색합니다.
ImageList_GetIcon	이미지에서 아이콘을 만들고 이미지 목록의 마스크를 만듭니다.
ImageList_GetIconSize	이미지 목록에서 이미지 차원을 검색합니다. 이미지 목록의 모든 이미지는 차원이 동일합니다.
ImageList_GetImageCount	이미지 목록의 이미지 수를 검색합니다.
ImageList_GetImageInfo	이미지에 대 한 정보를 검색합니다.
ImageList_LoadImage	지정된 비트맵에서 이미지 목록을 만듭니다.
ImageList_Merge	기존의 두 이미지를 결합하여 새 이미지를 만듭니다. 또한 이 함수는 이미지를 저장할 새 이미지 목록을 만듭니다.
ImageList_Read	스트림에서 이미지 목록을 읽습니다.
ImageList_ReadEx	스트림에서 이미지 목록을 읽고 이미지 목록에 대한 인터페이스를 반환합니다.
ImageList_Remove	이미지 목록에서 이미지를 제거합니다.
ImageList_Replace	이미지 목록에 있는 이미지를 새 이미지로 바꿉니다.
ImageList_ReplaceIcon	이미지를 아이콘 또는 커서로 바꿉니다.
ImageList_SetBkColor	이미지 목록의 배경색을 설정합니다. 이 함수는 아이콘을 추가하거나 흑백 비트맵이 있는 ImageList_AddMasked를 사용하는 경우에만 적용됩니다. 마스크가 없으면 전체 이미지가 그려지므로 배경색이 표시되지 않습니다.
ImageList_SetColorTable	이미지 목록의 색 테이블을 설정합니다.
ImageList_SetDragCursorImage	지정된 이미지(일반적으로 마우스 커서 이미지)를 현재 끌기 이미지와 결합하여 새 끌기 이미지를 만듭니다.
ImageList_SetIconSize	이미지 목록의 이미지 차원을 설정하고 목록에서 모든 이미지를 제거합니다.
ImageList_SetImageCount	기존 이미지 목록의 크기를 조정합니다.
ImageList_SetOverlayImage	오버레이 마스크로 사용할 이미지 목록에 지정된 이미지를 추가합니다. 이미지 목록에는 버전 4.70 이하에서 최대 4개, 버전 4.71에서 최대 15개의 오버레이 마스크를 포함할 수 있습니다. 이 함수는 지정된 이미지에 오버레이 마스크 인덱스를 할당합니다.
ImageList_Write	스트림에 이미지 목록을 씁니다.
ImageList_WriteEx	스트림에 이미지 목록을 씁니다.

매크로

항목	콘텐츠
ImageList_AddIcon	이미지 목록에 아이콘 또는 커서를 추가합니다. ImageList_AddIcon 함수는 ImageList_ReplaceIcon 함수를 호출합니다.
ImageList_ExtractIcon	ImageList_GetIcon 함수를 호출하여 이미지 목록의 이미지 및 마스크를 기반으로 아이콘 또는 커서를 만듭니다.
ImageList_LoadBitmap	ImageList_LoadImage 함수를 호출하여 지정된 비트맵 리소스에서 이미지 목록을 만듭니다.
ImageList_RemoveAll	ImageList_Remove 함수를 호출하여 이미지 목록에서 모든 이미지를 제거합니다.
INDEXTOOVERLAYMASK	ImageList_Draw 함수에서 사용할 수 있도록 오버레이 마스크의 인덱스를 준비합니다.

인터페이스

항목	콘텐츠
IImageList	이미지 목록으로 조작하고 상호 작용하는 메서드를 공개합니다. IImageList를 사용하려면 매니페스트에서 Comctl32.dll 버전 6을 지정합니다. 이 작업을 수행하지 않으면 기본적으로 Comctl32.dll 버전 5가 사용되며 IImageList가 예기치 않은 동작을 표시할 수 있습니다. 매니페스트에 대한 자세한 내용은 비주얼 스타일 사용을 참조하세요.

메서드

항목	콘텐츠
추가	이미지 목록에 하나의 이미지 또는 여러 이미지를 추가합니다.
AddMasked	이미지 목록에 하나의 이미지 또는 여러 이미지를 추가하여 지정된 비트맵에서 마스크를 생성합니다.
BeginDrag	이미지 끌기를 시작합니다.
복제	기존 이미지 목록을 복제합니다.
복사	지정된 이미지 목록에서 이미지를 복사합니다.
DragEnter	끌어서 놓기 작업 중에 지정된 창의 업데이트를 잠그고 창 내의 지정된 위치에 끌기 이미지를 표시합니다.
DragLeave	지정된 창의 잠금을 해제하고 끌기 이미지를 숨겨 창의 업데이트를 활성화합니다.
DragMove	끌어서 놓기 작업 중에 끌기 이미지를 이동합니다. 이 함수는 일반적으로 WM_MOUSEMOVE 메시지에 대한 응답으로 호출됩니다.
DragShowNolock	끌기 이미지를 표시하거나 숨깁니다.
Draw	지정된 디바이스 컨텍스트에서 이미지 목록 항목을 그립니다.
EndDrag	끌기 작업을 종료합니다.
GetBkColor	이미지 목록의 현재 배경색을 가져옵니다.
GetDragImage	끌기 이미지에 사용되는 임시 이미지 목록을 가져옵니다. 또한 이 함수는 현재 끌기 위치와 끌기 위치를 기준으로 끌어온 이미지의 오프셋을 검색합니다.
GetIcon	이미지에서 아이콘을 만들고 이미지 목록의 마스크를 만듭니다.
GetIconSize	이미지 목록의 이미지 차원을 가져옵니다. 이미지 목록의 모든 이미지는 차원이 동일합니다.
GetImageCount	이미지 목록의 이미지 수를 가져옵니다.
GetImageInfo	이미지 정보를 가져옵니다.
GetImageRect	이미지의 경계 사각형을 가져옵니다.
GetItemFlags	이미지의 플래그를 가져옵니다.
GetOverlayImage	오버레이 마스크로 사용되는 이미지 목록에서 지정된 이미지를 검색합니다.
Merge	기존의 두 이미지를 결합하여 새 이미지를 만듭니다. 또한 이 메서드는 이미지를 저장할 새 이미지 목록을 만듭니다.
제거	이미지 목록에서 이미지를 제거합니다.
바꾸기	이미지 목록에 있는 이미지를 새 이미지로 바꿉니다.
ReplaceIcon	이미지를 아이콘 또는 커서로 바꿉니다.
SetBkColor	이미지 목록의 배경색을 설정합니다. 이 메서드는 이미지 목록에 아이콘을 추가하거나 IImageList::AddMasked 메서드를 사용하여 흑백 비트맵을 추가하는 경우에만 작동합니다. 마스크가 없으면 전체 이미지가 그려지고 배경색이 표시되지 않습니다.
SetDragCursorImage	지정된 이미지(일반적으로 마우스 커서 이미지)를 현재 끌기 이미지와 결합하여 새 끌기 이미지를 만듭니다.
SetIconSize	이미지 목록의 이미지 차원을 설정하고 목록에서 모든 이미지를 제거합니다.
SetImageCount	기존 이미지 목록의 크기를 조정합니다.
SetOverlayImage	오버레이 마스크로 사용되는 이미지 목록에 지정된 이미지를 추가합니다. 이미지 목록에는 공용 컨트롤 버전 4.70에서 최대 4개, 버전 4.71 이상에서 최대 15개의 오버레이 마스크를 포함할 수 있습니다. 메서드는 지정된 이미지에 오버레이 마스크 인덱스를 할당합니다.

구조체

항목	콘텐츠
IMAGEINFO	이미지 목록의 이미지 정보를 포함합니다. 이 구조체는 IImageList::GetImageInfo 함수와 함께 사용됩니다.
IMAGELISTDRAWPARAMS	이미지 목록 그리기 작업에 대한 정보를 포함하며 IImageList::Draw 함수와 함께 사용됩니다.