다음을 통해 공유

이미지 목록

  • 아티클

이 섹션에는 이미지 목록과 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다.

개요

주제 목차
이미지 목록 이미지 목록은 동일한 크기의 이미지 컬렉션으로, 각각 인덱스로 참조할 수 있습니다.

함수

주제 목차
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_AddIconImageList_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 끌 이미지를 표시하거나 숨깁니다.
그리기 지정된 디바이스 컨텍스트에서 이미지 목록 항목을 그립니다.
EndDrag 끌기 작업을 종료합니다.
GetBkColor 이미지 목록의 현재 배경색을 가져옵니다.
GetDragImage 끌기 이미지에 사용되는 임시 이미지 목록을 가져옵니다. 또한 이 함수는 끌기 위치를 기준으로 현재 끌기 위치와 끌기 이미지의 오프셋을 검색합니다.
getIcon 이미지에서 아이콘을 만들고 이미지 목록에 마스크를 만듭니다.
GetIconSize 이미지 목록의 이미지 크기를 가져옵니다. 이미지 목록의 모든 이미지는 동일한 차원을 갖습니다.
GetImageCount 이미지 목록의 이미지 수를 가져옵니다.
GetImageInfo 이미지에 대한 정보를 가져옵니다.
GetImageRect 이미지의 경계 사각형을 가져옵니다.
GetItemFlags 이미지의 플래그를 가져옵니다.
GetOverlayImage 오버레이 마스크로 사용되는 이미지 목록에서 지정된 이미지를 검색합니다.
병합 두 개의 기존 이미지를 결합하여 새 이미지를 만듭니다. 또한 이 메서드는 이미지를 저장할 새 이미지 목록을 만듭니다.
제거 이미지 목록에서 이미지를 제거합니다.
바꾸기 이미지 목록의 이미지를 새 이미지로 대체합니다.
ReplaceIcon 이미지를 아이콘 또는 커서로 대체합니다.
SetBkColor 이미지 목록의 배경색을 설정합니다. 이 메서드는 이미지 목록에 아이콘을 추가하거나 IImageList::AddMasked 메서드를 사용하여 흑백 비트맵을 추가하는 경우에만 작동합니다. 마스크가 없으면 전체 이미지가 그려지고 배경색이 표시되지 않습니다.
SetDragCursorImage 일반적으로 마우스 커서 이미지인 지정된 이미지를 현재 끌기 이미지와 결합하여 새 끌기 이미지를 만듭니다.
SetIconSize 이미지 목록의 이미지 크기를 설정하고 목록에서 모든 이미지를 제거합니다.
SetImageCount 기존 이미지 목록의 크기를 조정합니다.
setOverlayImage 오버레이 마스크로 사용되는 이미지 목록에 지정된 이미지를 추가합니다. 이미지 목록에는 버전 4.70 이전 버전 최대 4개의 오버레이 마스크가 있고 버전 4.71 이상에서는 최대 15개의 오버레이 마스크가 있을 수 있습니다. 메서드는 지정된 이미지에 오버레이 마스크 인덱스를 할당합니다.

구조

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