SHGetImageList 함수(shellapi.h)
이미지 목록을 검색합니다.
구문
SHSTDAPI SHGetImageList(
[in] int iImageList,
[in] REFIID riid,
[out] void **ppvObj
);
매개 변수
[in] iImageList
형식: int
목록에 포함된 이미지 형식입니다. 다음 값 중 하나입니다.
SHIL_LARGE(0x0)
0x0. 이미지 크기는 일반적으로 32x32 픽셀입니다. 그러나 표시 속성의 모양 탭에 있는 효과 섹션에서 큰 아이콘 사용 옵션을 선택하면 이미지는 48x48픽셀입니다.
SHIL_SMALL(0x1)
0x1. 이러한 이미지는 셸 표준 16x16의 작은 아이콘 크기이지만 사용자가 크기를 사용자 지정할 수 있습니다.
SHIL_EXTRALARGE(0x2)
0x2. 이러한 이미지는 Shell 표준 초대형 아이콘 크기입니다. 일반적으로 48x48이지만 사용자가 크기를 사용자 지정할 수 있습니다.
SHIL_SYSSMALL(0x3)
0x3. 이러한 이미지는 SM_CYSMICON 호출된 SM_CXSMICON 및 GetSystemMetrics를 사용하여 호출된 GetSystemMetrics에 의해 지정된 크기입니다.
SHIL_JUMBO(0x4)
0x4. Windows Vista 이상. 이미지는 일반적으로 256x256픽셀입니다.
SHIL_LAST
유효성 검사를 위해 유효한 가장 큰 플래그 값입니다.
[in] riid
형식: REFIID
일반적으로 IID_IImageList 이미지 목록 인터페이스 식별자에 대한 참조입니다.
[out] ppvObj
형식: void**
이 메서드가 반환되면 는 riid에서 요청된 인터페이스 포인터를 포함합니다. 일반적으로 IImageList입니다.
반환 값
형식: HRESULT
이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
ppv 매개 변수에 반환된 것과 같은 IImageList 포인터 형식은 필요에 따라 HIMAGELIST로 캐스팅할 수 있습니다. 예를 들어 목록 보기에서 사용할 수 있습니다. 반대로 HIMAGELIST 를 IImageList에 대한 포인터로 캐스팅할 수 있습니다.
Windows Vista를 기준으로 프로세스가 dpi 인식으로 표시된 경우 SHIL_SMALL, SHIL_LARGE 및 SHIL_EXTRALARGE 크기가 dpi(인치당 점)로 표시됩니다. 이러한 형식을 dpi 인식으로 설정하려면 SetProcessDPIAware를 호출합니다. SHIL_JUMBO dpi 인식 설정에 관계없이 256픽셀로 고정됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shellapi.h |
| DLL | Shell32.dll |
| API 세트 | ext-ms-win-shell-shell32-l1-2-2(Windows 10 버전 10.0.14393에 도입됨) |