이 섹션에는 이미지 목록과 함께 사용되는 프로그래밍 요소에 대한 정보가 포함되어 있습니다.
개요
| 주제 | 목차 |
|---|---|
| 이미지 목록 | 이미지 목록은 동일한 크기의 이미지 컬렉션으로, 각각 인덱스로 참조할 수 있습니다. |
함수
| 주제 | 목차 |
|---|---|
| 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 함수와 함께 사용됩니다. |