아이콘 오버레이 처리기를 구현하는 방법

아이콘 오버레이 처리기는 DLL로 구현된 COM(In-process Component Object Model) 개체입니다. IUnknown: IShellIconOverlayIdentifier 외에 하나의 인터페이스를 내보냅니다. 이 인터페이스에는 IShellIconOverlayIdentifier::GetOverlayInfo, IShellIconOverlayIdentifier::GetPriority 및 IShellIconOverlayIdentifier::IsMemberOf의 세 가지 메서드가 있습니다.

지침

1단계: GetOverlayInfo 구현

GetOverlayInfo 메서드는 초기화 중에 먼저 호출됩니다. 메서드는 아이콘 오버레이 이미지를 포함하는 파일의 정규화된 경로와 파일 내의 인덱스(0부터 시작)를 반환합니다. 그런 다음 셸은 이미지를 시스템 이미지 목록에 추가합니다. 아이콘 오버레이는 .exe, .dll 및 .ico를 비롯한 표준 파일 형식에 포함될 수 있습니다.

초기화가 완료되면 셸은 처리기의 아이콘 오버레이를 표시해야 할 때 GetOverlayInfo 를 호출합니다. 메서드는 초기화 중에 수행한 것과 동일한 파일 이름 및 인덱스 를 반환해야 합니다. 셸은 파일에서 이미지를 로드하는 대신 시스템 이미지 목록에 캐시된 이미지를 사용하지만 아이콘 오버레이는 파일 이름과 인덱스로 식별됩니다.

2단계: GetPriority 구현

GetPriority 메서드는 초기화 중에만 호출됩니다. 처리기의 아이콘 오버레이에 우선 순위 값을 할당합니다. 값의 범위는 0에서 100까지이며, 여기서 100은 가장 낮은 우선 순위입니다. 이 우선 순위 값의 목적은 셸이 단일 개체에 대해 여러 아이콘 오버레이를 지정할 때 발생하는 충돌을 resolve 데 도움이 되는 것입니다. 셸은 먼저 내부 규칙 집합을 사용하여 우선 순위가 가장 높은 아이콘 오버레이를 결정합니다. 이러한 규칙이 충돌을 resolve 않으면 GetPriority에 의해 아이콘 오버레이에 할당된 값이 우선 순위를 결정합니다.

GetPriority에서 설정한 우선 순위 값은 관련 없는 아이콘 오버레이 처리기 간의 충돌을 resolve 신뢰할 수 있는 방법이 아닙니다. 처리기가 다른 처리기에서 사용하는 우선 순위 값을 확인할 수 있는 방법은 없습니다. 일반적으로 값을 0으로 설정해야 합니다. 그러나 우선 순위 값은 동일한 개체에 대한 아이콘 오버레이 아이콘을 요청할 수 있는 두 개 이상의 아이콘 오버레이 처리기를 구현한 경우에 유용합니다. 우선 순위 값을 적절하게 설정하면 요청된 아이콘 오버레이 중 어떤 것이 표시될지 지정할 수 있습니다.

3단계: IsMemberOf 구현

Shell은 IsMemberOf 메서드를 호출하여 특정 개체에 대한 처리기의 아이콘 오버레이를 표시해야 하는지 여부를 결정합니다. Shell은 메서드에 해당 이름을 전달하여 개체를 지정합니다. 처리기가 아이콘 오버레이를 표시하려는 경우 IsMemberOf 는 S_OK 반환합니다. 그렇지 않으면 S_FALSE 반환합니다.

아이콘 오버레이 처리기는 일반적으로 특정 파일 그룹과 함께 작동합니다. 일반적인 예는 특정 파일 이름 확장명으로 식별되는 파일 형식입니다. 아이콘 오버레이 처리기는 파일 형식의 모든 파일에 대해 아이콘 오버레이를 요청할 수 있습니다. 일부 처리기는 파일 형식의 파일이 특정 상태인 경우에만 아이콘 오버레이를 요청합니다. 그러나 아이콘 오버레이 처리기는 선택한 모든 개체에 대해 해당 아이콘 오버레이를 자유롭게 요청할 수 있습니다.