Interface IShellIconOverlay (shlobj_core.h)

Expõe métodos que são usados por uma extensão de namespace para especificar sobreposições de ícone para os objetos que ela contém.

Herança

A interface IShellIconOverlay herda da interface IUnknown . IShellIconOverlay também tem estes tipos de membros:

Métodos

A interface IShellIconOverlay tem esses métodos.

Comentários

As sobreposições de ícone são pequenas imagens colocadas no canto inferior esquerdo do ícone que representa um objeto Shell. Normalmente, elas são usadas para adicionar algumas informações extras ao ícone. Uma sobreposição de ícone comumente usada é a pequena seta que indica que um ícone de arquivo ou pasta representa um atalho.

As sobreposições de ícone fazem parte da lista de imagens do sistema. Eles têm dois identificadores. Um deles é um índice de sobreposição baseado em um que identifica a sobreposição em relação a outras sobreposições na lista de imagens. O outro é um índice de imagem que identifica a imagem real. Esses dois índices são equivalentes aos valores que você atribui aos parâmetros iOverlay e iImage , respectivamente, quando você adiciona uma sobreposição de ícone a uma lista de imagens privadas com ImageList::SetOverlayImage.

Antes de exibir o ícone de um objeto, o Shell chama a interface IShellIconOverlay da pasta associada para consultar se o ícone do objeto deve ter uma sobreposição. Normalmente, ele chama IShellIconOverlay::GetOverlayIndex para solicitar o índice de sobreposição da sobreposição. Em alguns casos, o Shell pode chamar IShellIconOverlay::GetOverlayIconIndex para solicitar o índice de imagem da sobreposição. Para especificar uma sobreposição de ícone, os métodos devem retornar o índice solicitado. Caso contrário, retornarão S_FALSE.

Para especificar uma sobreposição de ícone, ambos os métodos devem primeiro recuperar o índice de sobreposição da sobreposição na lista de imagens do sistema chamando SHGetIconOverlayIndex. Quando SHGetIconOverlayIndex é chamado pela primeira vez, o Shell usa o nome de arquivo e o índice da sobreposição dentro do arquivo para adicionar a imagem à lista de imagens do sistema. Depois que uma sobreposição estiver na lista de imagens do sistema, o Shell simplesmente usará o nome e o índice do arquivo como um identificador. Você também pode usar SHGetIconOverlayIndex para recuperar o índice de sobreposição de várias sobreposições padrão do sistema. IShellIconOverlay::GetOverlayIndex simplesmente retorna o índice de sobreposição para o Shell. IShellIconOverlay::GetOverlayIconIndex deve usar a macro INDEXTOOVERLAYMASK para converter o índice de sobreposição no índice de imagem equivalente.

O número de manipuladores de sobreposição de ícones diferentes aos quais o sistema pode dar suporte é limitado pela quantidade de espaço disponível para sobreposições de ícones na lista de imagens do sistema. Atualmente, há quinze slots alocados para sobreposições de ícone, alguns dos quais são reservados pelo sistema. Por esse motivo, as sobreposições de ícone devem ser especificadas somente se não houver alternativas satisfatórias.

Essa interface é implementada por extensões de namespace que precisam especificar sobreposições de ícone para seus objetos.

Normalmente, essa interface não é usada por aplicativos.

Requisitos