Interfaccia IShellIconOverlay (shlobj_core.h)

Espone i metodi utilizzati da un'estensione dello spazio dei nomi per specificare sovrapposizioni di icone per gli oggetti in esso contenuti.

Ereditarietà

L'interfaccia IShellIconOverlay eredita dall'interfaccia IUnknown . IShellIconOverlay include anche questi tipi di membri:

Metodi

L'interfaccia IShellIconOverlay include questi metodi.

Commenti

Le sovrapposizioni di icone sono immagini di piccole dimensioni posizionate nell'angolo inferiore sinistro dell'icona che rappresenta un oggetto Shell. Vengono in genere usati per aggiungere alcune informazioni aggiuntive all'icona. Una sovrapposizione di icone di uso comune è la piccola freccia che indica che un file o un'icona di cartella rappresenta un collegamento.

Le sovrimpressioni delle icone fanno parte dell'elenco di immagini di sistema. Hanno due identificatori. Uno è un indice di sovrimpressione in base uno che identifica la sovrimpressione rispetto ad altre sovrimpressioni nell'elenco di immagini. L'altro è un indice di immagine che identifica l'immagine effettiva. Questi due indici sono equivalenti ai valori assegnati rispettivamente ai parametri iOverlay e iImage , quando si aggiunge una sovrapposizione di icone a un elenco di immagini private con ImageList::SetOverlayImage.

Prima di visualizzare l'icona per un oggetto, Shell chiama l'interfaccia IShellIconOverlay della cartella associata per eseguire una query se l'icona dell'oggetto deve avere una sovrimpressione. In genere chiama IShellIconOverlay::GetOverlayIndex per richiedere l'indice di sovrapposizione della sovrimpressione. In alcuni casi, Shell potrebbe chiamare IShellIconOverlay::GetOverlayIconIndex per richiedere l'indice dell'immagine della sovrimpressione. Per specificare una sovrapposizione di icone, i metodi devono restituire l'indice richiesto. In caso contrario, restituiscono S_FALSE.

Per specificare una sovrapposizione di icone, entrambi i metodi devono prima recuperare l'indice di sovrimpressione nell'elenco di immagini di sistema chiamando SHGetIconOverlayIndex. Quando SHGetIconOverlayIndex viene chiamato per la prima volta, shell usa il nome file e l'indice della sovrimpressione all'interno del file per aggiungere l'immagine all'elenco di immagini di sistema. Quando una sovrimpressione si trova nell'elenco di immagini di sistema, shell usa semplicemente il nome del file e l'indice come identificatore. È anche possibile usare SHGetIconOverlayIndex per recuperare l'indice di sovrapposizione di diverse sovrimpressioni di sistema standard. IShellIconOverlay::GetOverlayIndex restituisce semplicemente l'indice di sovrimpressione alla shell. IShellIconOverlay::GetOverlayIconIndex deve usare la macro INDEXTOOVERLAYMASK per convertire l'indice di sovrapposizione nell'indice immagine equivalente.

Il numero di gestori di sovrapposizione di icone diversi che il sistema può supportare è limitato dalla quantità di spazio disponibile per le sovrimpressioni delle icone nell'elenco delle immagini di sistema. Attualmente sono disponibili quindici slot assegnati per le sovrapposizioni di icone, alcune delle quali sono riservate dal sistema. Per questo motivo, le sovrimpressioni delle icone devono essere specificate solo se non sono presenti alternative soddisfacenti.

Questa interfaccia viene implementata dalle estensioni dello spazio dei nomi che devono specificare sovrapposizioni di icone per i relativi oggetti.

Questa interfaccia non viene in genere usata dalle applicazioni.

Requisiti