IShellIconOverlay 인터페이스(shlobj_core.h)

네임스페이스 확장에서 포함하는 개체에 대한 아이콘 오버레이를 지정하는 데 사용되는 메서드를 노출합니다.

상속

IShellIconOverlay 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IShellIconOverlay 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IShellIconOverlay 인터페이스에는 이러한 메서드가 있습니다.

IShellIconOverlay::GetOverlayIconIndex 시스템 이미지 목록에서 아이콘 오버레이의 인덱스 를 가져옵니다.
IShellIconOverlay::GetOverlayIndex 시스템 이미지 목록에서 오버레이 인덱스 를 가져옵니다.

설명

아이콘 오버레이는 Shell 개체를 나타내는 아이콘의 왼쪽 아래 모서리에 배치된 작은 이미지입니다. 일반적으로 아이콘에 몇 가지 추가 정보를 추가하는 데 사용됩니다. 일반적으로 사용되는 아이콘 오버레이는 파일 또는 폴더 아이콘이 바로 가기를 나타낸다는 것을 나타내는 작은 화살표입니다.

아이콘 오버레이는 시스템 이미지 목록의 일부입니다. 두 개의 식별자가 있습니다. 하나는 이미지 목록의 다른 오버레이를 기준으로 오버레이를 식별하는 1 기반 오버레이 인덱스입니다. 다른 하나는 실제 이미지를 식별하는 이미지 인덱스입니다. 이러한 두 인덱스는 ImageList::SetOverlayImage를 사용하여 개인 이미지 목록에 아이콘 오버레이를 추가할 때 각각 iOverlay 및 iImage 매개 변수에 할당하는 값과 동일합니다.

개체에 대한 아이콘을 표시하기 전에 Shell은 연결된 폴더의 IShellIconOverlay 인터페이스를 호출하여 개체의 아이콘에 오버레이가 있어야 하는지 여부를 쿼리합니다. 일반적으로 IShellIconOverlay::GetOverlayIndex 를 호출하여 오버레이의 오버레이 인덱스를 요청합니다. 경우에 따라 셸이 IShellIconOverlay::GetOverlayIconIndex 를 호출하여 오버레이의 이미지 인덱스를 요청할 수 있습니다. 아이콘 오버레이를 지정하려면 메서드가 요청된 인덱스 를 반환해야 합니다. 그렇지 않으면 S_FALSE 반환합니다.

아이콘 오버레이를 지정하려면 두 메서드 모두 먼저 SHGetIconOverlayIndex를 호출하여 시스템 이미지 목록에서 오버레이의 오버레이 인덱스를 검색해야 합니다. SHGetIconOverlayIndex가 처음으로 호출되면 셸은 파일 내에서 오버레이의 파일 이름과 인덱스를 사용하여 이미지를 시스템 이미지 목록에 추가합니다. 오버레이가 시스템 이미지 목록에 있으면 셸은 파일 이름 및 인덱스만 식별자로 사용합니다. SHGetIconOverlayIndex를 사용하여 여러 표준 시스템 오버레이의 오버레이 인덱스를 검색할 수도 있습니다. IShellIconOverlay::GetOverlayIndex 는 단순히 셸에 오버레이 인덱스를 반환합니다. IShellIconOverlay::GetOverlayIconIndex 는 INDEXTOOVERLAYMASK 매크로를 사용하여 오버레이 인덱스를 해당하는 이미지 인덱스로 변환해야 합니다.

시스템에서 지원할 수 있는 다양한 아이콘 오버레이 처리기의 수는 시스템 이미지 목록의 아이콘 오버레이에 사용할 수 있는 공간의 양에 따라 제한됩니다. 현재 아이콘 오버레이에 할당된 슬롯이 15개 있으며, 그 중 일부는 시스템에서 예약되어 있습니다. 이러한 이유로 아이콘 오버레이는 만족스러운 대안이 없는 경우에만 지정해야 합니다.

이 인터페이스는 개체에 대한 아이콘 오버레이를 지정해야 하는 네임스페이스 확장에 의해 구현됩니다.

이 인터페이스는 일반적으로 애플리케이션에서 사용되지 않습니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h