Funzione LookupIconIdFromDirectory (winuser.h)

Articolo
03/04/2024

Cerca i dati delle risorse dell'icona (RT_GROUP_ICON) o del cursore (RT_GROUP_CURSOR) per l'icona o il cursore più adatto al dispositivo di visualizzazione corrente.

Per specificare un'altezza o una larghezza desiderata, usare la funzione LookupIconIdFromDirectoryEx . Questa funzione lo chiama passando zero nei parametri cyDesired cxDesired/.

Sintassi

int LookupIconIdFromDirectory(
  [in] PBYTE presbits,
  [in] BOOL  fIcon
);

Parametri

[in] presbits

Tipo: PBYTE

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

[in] fIcon

Tipo: BOOL

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

Valore restituito

Tipo: int

Se la funzione ha esito positivo, il valore restituito è un identificatore di risorsa integer per l'icona (RT_ICON) o il cursore (RT_CURSOR) più adatto 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 dati icona (o cursore) in diversi formati dipendenti dal dispositivo e indipendenti dal dispositivo. LookupIconIdFromDirectory cerca l'icona (o il cursore) che meglio si adatta al dispositivo di visualizzazione corrente e restituisce il relativo identificatore integer. 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 integer per l'icona specifica da caricare. LookupIconIdFromDirectory restituisce un identificatore intero che corrisponde al nome della risorsa dell'icona più adatta al dispositivo di visualizzazione corrente.

Le funzioni LoadIcon, LoadCursor e LoadImage usano questa funzione per cercare i dati delle risorse specificati per l'icona o il cursore più adatto al dispositivo di visualizzazione corrente.

Requisiti

Requisito	Valore
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