IExtractIconW 인터페이스(shlobj_core.h)
클라이언트가 폴더의 개체 중 하나와 연결된 아이콘을 검색할 수 있도록 하는 메서드를 노출합니다.
상속
IExtractIcon 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IExtractIcon 에는 다음과 같은 유형의 멤버도 있습니다.
메서드
IExtractIconW 인터페이스에는 이러한 메서드가 있습니다.
| IExtractIconW::Extract 지정된 위치에서 아이콘 이미지를 추출합니다. (유니코드) |
| IExtractIconW::GetIconLocation 아이콘의 위치 및 인덱스 를 가져옵니다. (유니코드) |
설명
개체의 아이콘을 검색하는 방법에는 두 가지가 있습니다. 가장 간단한 방법은 SHGetFileInfo를 호출하는 것입니다. 그러나 이 방법은 융통성이 없으며 속도가 느릴 수 있습니다. 항목 아이콘을 검색하는 보다 유연하고 효율적인 방법은 IExtractIcon을 사용하는 것입니다. 셸은 IExtractIcon 을 사용하여 폴더의 내용을 표시할 때 아이콘을 검색합니다. IExtractIcon을 사용하여 개체의 아이콘을 검색하려면 다음을 수행합니다.
- 개체가 포함된 폴더의 IShellFolder 인터페이스에 대한 포인터를 가져옵니다.
- 개체의 PIDL(항목 식별자 목록)에 대한 포인터와 IExtractIcon(IID_IExtractIcon)의 인터페이스 ID를 사용하여 IShellFolder::GetUIObjectOf를 호출합니다. 폴더는 아이콘 추출을 처리하는 개체를 만들고 개체의 IExtractIcon 인터페이스 포인터를 반환합니다.
- IExtractIcon::GetIconLocation을 호출하여 아이콘의 위치를 검색합니다.
- IExtractIcon::Extract를 호출하여 아이콘의 핸들을 검색합니다.
네임스페이스 확장은IExtractIcon 을 구현하여 개체에 대한 아이콘을 제공합니다. 클라이언트는 폴더의 IShellFolder::GetUIObjectOf 메서드를 호출하여 폴더의 개체에 대한 IExtractIcon 인터페이스 포인터를 가져옵니다. IShellFolder::GetUIObjectOf 구현은 아이콘 추출을 처리하고 개체의 IExtractIcon 인터페이스에 대한 포인터를 반환하는 개체를 만들어야 합니다.
아이콘 처리기는IExtractIcon도 구현합니다. 아이콘 처리기는 파일 형식의 멤버에 아이콘을 동적으로 할당할 수 있는 Shell 확장 처리기의 형식입니다.
애플리케이션이 SHGetFileInfo보다 개체의 아이콘을 검색하는 보다 유연한 방법이 필요한 경우 이 인터페이스를 호출합니다.
참고
shlobj_core.h 헤더는 IExtractIcon을 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | shlobj_core.h |