Metodo IExtractIconA::Extract (shlobj_core.h)

  • Articolo

Estrae un'immagine icona dalla posizione specificata.

Sintassi

HRESULT Extract(
  [in]            PCSTR pszFile,
                  UINT  nIconIndex,
  [out, optional] HICON *phiconLarge,
  [out, optional] HICON *phiconSmall,
                  UINT  nIconSize
);

Parametri

[in] pszFile

Tipo: PCTSTR

Puntatore a una stringa con terminazione Null che specifica la posizione dell'icona.

nIconIndex

Tipo: UINT

Indice dell'icona nel file a cui punta pszFile.

[out, optional] phiconLarge

Tipo: HICON*

Puntatore a un valore HICON che riceve l'handle per l'icona grande. Questo parametro può essere NULL.

[out, optional] phiconSmall

Tipo: HICON*

Puntatore a un valore HICON che riceve l'handle per l'icona piccola. Questo parametro può essere NULL.

nIconSize

Tipo: UINT

Dimensioni desiderate dell'icona, in pixel. La parola bassa contiene le dimensioni dell'icona grande e la parola alta contiene le dimensioni dell'icona piccola. Le dimensioni specificate possono essere la larghezza o l'altezza. La larghezza di un'icona è sempre uguale all'altezza.

Valore restituito

Tipo: HRESULT

Restituisce S_OK se la funzione ha estratto l'icona o S_FALSE se l'applicazione chiamante deve estrarre l'icona.

Commenti

La posizione dell'icona e l'indice sono gli stessi valori restituiti dal metodo IExtractIcon::GetIconLocation . Se la funzione IExtractIcon::Extract restituisce S_FALSE, questi valori devono specificare un nome di file icona e un indice che formano parametri legali per una chiamata a ExtractIcon. Se IExtractIcon::Extract non restituisce S_FALSE, non devono essere effettuate ipotesi sui significati dei parametri pszFile e nIconIndex .

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h
DLL Shell32.dll (versione 4.0 o successiva)

Vedi anche

IExtractIcon