Funzione LookupIconIdFromDirectoryEx (winuser.h)

Articolo
05/25/2023

Cerca attraverso l'icona (RT_GROUP_ICON) o i dati delle risorse (RT_GROUP_CURSOR) per l'icona o il cursore che meglio si adatta al dispositivo di visualizzazione corrente.

Se esistono più immagini nel gruppo di risorse, questo metodo usa i criteri seguenti per scegliere un'immagine:

L'immagine più vicina ma non supera le dimensioni richieste è selezionata.
Se sono presenti due o più immagini di tale dimensione, viene scelta quella corrispondente alla profondità di colore dello schermo.
Se nessuna immagine corrisponde esattamente alla profondità di colore dello schermo, l'immagine con la maggiore profondità di colore che non supera la profondità di colore del display viene scelta. Se tutto supera la profondità del colore, viene scelto quello con la profondità di colore più bassa.

Sintassi

int LookupIconIdFromDirectoryEx(
  [in] PBYTE presbits,
  [in] BOOL  fIcon,
  [in] int   cxDesired,
  [in] int   cyDesired,
  [in] UINT  Flags
);

Parametri

[in] presbits

Tipo: PBYTE

Dati della directory dell'icona o del cursore. Poiché questa funzione non convalida i dati delle risorse, causa un errore di protezione generale o restituisce un valore non definito se i presbit non puntano ai dati delle risorse validi.

[in] fIcon

Tipo: BOOL

Indica se viene cercata un'icona o un cursore. Se questo parametro è TRUE, la funzione sta cercando un'icona; se il parametro è FALSE, la funzione sta cercando un cursore.

[in] cxDesired

Tipo: int

Larghezza desiderata, in pixel, dell'icona. Se questo parametro è zero, la funzione usa il valore SM_CXICON o SM_CXCURSOR metrica di sistema.

[in] cyDesired

Tipo: int

Altezza desiderata, in pixel, dell'icona. Se questo parametro è zero, la funzione usa il valore della metrica di sistema SM_CYICON o SM_CYCURSOR .

[in] Flags

Tipo: UINT

Combinazione dei valori seguenti.

Valore	Significato
LR_DEFAULTCOLOR 0x00000000	Usa il formato di colore predefinito.
LR_MONOCHROME 0x00000001	Crea un'icona monocromatica o un cursore.

Valore restituito

Tipo: int

Se la funzione ha esito positivo, il valore restituito è un identificatore di risorsa intero per l'icona (RT_ICON) o il cursore (RT_CURSOR) che meglio si adatta al dispositivo di visualizzazione corrente.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Un file di risorse di tipo RT_GROUP_ICON (RT_GROUP_CURSOR indica i cursori) contiene i dati dell'icona (o del cursore) in diversi formati dipendenti dal dispositivo e indipendenti dal dispositivo. LookupIconIdFromDirectoryEx cerca il file di risorse per l'icona (o il cursore) che meglio si adatta al dispositivo di visualizzazione corrente e restituisce il relativo identificatore intero. Le funzioni FindResource e FindResourceEx usano la macro MAKEINTRESOURCE con questo identificatore per individuare la risorsa nel modulo.

La directory dell'icona viene caricata da un file di risorse con tipo di risorsa RT_GROUP_ICON (o RT_GROUP_CURSOR per i cursori) e un nome di risorsa intero per l'icona specifica (RT_ICON) o il cursore (RT_CURSOR) da caricare. Le funzioni LoadResource e CreateIconFromResourceEx possono essere usate per creare un'icona o un cursore corrispondenti.

Le funzioni LoadIcon, LoadImage e LoadCursor usano questa funzione per cercare i dati delle risorse specificati per l'icona o il cursore che meglio si adattano al dispositivo di visualizzazione corrente. LoadIconWithScaleDown usa criteri di ricerca alternativi per una soluzione ottimale.

Esempio

Per un esempio, vedere Condivisione delle risorse icona.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll