Funzione SHGetIconOverlayIndexA (shlobj_core.h)

Articolo
11/20/2024

Restituisce l'indice dell'icona di sovrapposizione nell'elenco di immagini di sistema.

Sintassi

int SHGetIconOverlayIndexA(
  [in, optional] LPCSTR pszIconPath,
                 int    iIconIndex
);

Parametri

[in, optional] pszIconPath

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null di lunghezza massima MAX_PATH che contiene il percorso completo del file che contiene l'icona.

iIconIndex

Tipo: int

Indice dell'icona nel file a cui punta pszIconPath. Per richiedere un'icona di sovrimpressione standard, impostare pszIconPath su NULLe iIconIndex su uno dei seguenti elementi:

IDO_SHGIOI_SHARE (0x0FFFFFFF)

Icona di sovrapposizione che indica una cartella condivisa.

IDO_SHGIOI_LINK (0x0FFFFFFE)

Icona di sovrimpressione che indica una cartella o un file collegato.

IDO_SHGIOI_SLOWFILE (0x0FFFFFFD)

Icona di sovrapposizione che indica un file lento.

IDO_SHGIOI_DEFAULT (0x0FFFFFFC)

Windows 7 e versioni successive. Icona di sovrimpressione che indica che l'elemento è il valore predefinito in un set. Un esempio è la stampante predefinita.

Valore restituito

Tipo: int

Restituisce l'indice dell'icona di sovrimpressione nell'elenco di immagini di sistema se l'operazione riesce o -1 in caso contrario.

Osservazioni

Le sovrimpressioni delle icone fanno parte dell'elenco di immagini di sistema. Hanno due identificatori. Il primo è un indice di sovrapposizione basato su un solo che identifica la sovrimpressione rispetto ad altre sovrimpressioni nell'elenco di immagini. L'altro è un indice 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. SHGetIconOverlayIndex restituisce l'indice di sovrimpressione. Per convertire un indice di sovrimpressione nell'indice di immagine equivalente, chiamare INDEXTOOVERLAYMASK.

Nota Dopo che l'immagine è stata caricata nell'elenco di immagini di sistema durante l'inizializzazione, non può essere modificata. Il nome file e l'indice specificati da pszIconPath e iIconIndex vengono usati solo per identificare la sovrimpressione dell'icona. SHGetIconOverlayIndex non può essere usato per modificare l'elenco di immagini di sistema.

Nota

L'intestazione shlobj_core.h definisce SHGetIconOverlayIndex come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlobj_core.h (includere Shlobj.h, Shlobj_core.h)
libreria	Shell32.lib
dll	Shell32.dll (versione 5.0 o successiva)

Vedere anche

IShellIconOverlay

IShellIconOverlayIdentifier

Condividi tramite