Funzione SHGetIconOverlayIndexA (shlobj_core.h)

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 contenente il percorso completo del file contenente l'icona.

iIconIndex

Tipo: int

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

IDO_SHGIOI_SHARE (0x0FFFFFFF)

Icona di sovrapposizione che indica una cartella condivisa.

IDO_SHGIOI_LINK (0x0FFFFFFE)

Icona di sovrapposizione 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 sovrapposizione 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 sovrapposizione nell'elenco di immagini di sistema se ha esito positivo o -1 in caso contrario.

Commenti

Le sovrimpressione delle icone fanno parte dell'elenco di immagini di sistema. Hanno due identificatori. Il primo è un indice di sovrapposizione basato su uno che identifica la sovrapposizione rispetto ad altre sovrimpressione nell'elenco di immagini. L'altro è un indice di immagine che identifica l'immagine effettiva. Questi due indici sono equivalenti ai valori assegnati ai parametri iOverlay e iImage , rispettivamente, quando si aggiunge una sovrapposizione di icone a un elenco di immagini private con ImageList_SetOverlayImage. SHGetIconOverlayIndex restituisce l'indice di sovrapposizione. Per convertire un indice di sovrapposizione nell'indice di immagine equivalente, chiamare INDEXTOOVERLAYMASK.

Requisiti

Vedi anche

IShellIconOverlay

IShellIconOverlayIdentifier