Fonction LookupIconIdFromDirectory (winuser.h)

Article
05/25/2023

Recherche dans les données de ressource d’icône (RT_GROUP_ICON) ou de curseur (RT_GROUP_CURSOR) l’icône ou le curseur qui correspond le mieux à l’appareil d’affichage actuel.

Pour spécifier une hauteur ou une largeur souhaitée, utilisez la fonction LookupIconIdFromDirectoryEx . Cette fonction l’appelle en passant zéro dans les paramètrescyDesiredcxDesired/.

Syntaxe

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

Paramètres

[in] presbits

Type : PBYTE

Données du répertoire de l’icône ou du curseur. Étant donné que cette fonction ne valide pas les données de ressource, elle provoque une erreur de protection générale (GP) ou retourne une valeur non définie si les prébits ne pointent pas vers des données de ressource valides.

[in] fIcon

Type : BOOL

Indique si une icône ou un curseur est recherché. Si ce paramètre a la valeur TRUE, la fonction recherche une icône ; si le paramètre a la valeur FALSE, la fonction recherche un curseur.

Valeur retournée

Type : int

Si la fonction réussit, la valeur de retour est un identificateur de ressource entier pour l’icône (RT_ICON) ou le curseur (RT_CURSOR) qui correspond le mieux à l’appareil d’affichage actuel.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Un fichier de ressources de type RT_GROUP_ICON (RT_GROUP_CURSOR indique des curseurs) contient des données d’icône (ou de curseur) dans plusieurs formats dépendants de l’appareil et indépendants de l’appareil. LookupIconIdFromDirectory recherche dans le fichier de ressources l’icône (ou le curseur) qui correspond le mieux à l’appareil d’affichage actuel et retourne son identificateur entier. Les fonctions FindResource et FindResourceEx utilisent la macro MAKEINTRESOURCE avec cet identificateur pour localiser la ressource dans le module.

Le répertoire d’icônes est chargé à partir d’un fichier de ressources avec le type de ressource RT_GROUP_ICON (ou RT_GROUP_CURSOR pour les curseurs) et un nom de ressource entier pour l’icône spécifique à charger. LookupIconIdFromDirectory retourne un identificateur entier qui est le nom de ressource de l’icône qui correspond le mieux à l’appareil d’affichage actuel.

Les fonctions LoadIcon, LoadCursor et LoadImage utilisent cette fonction pour rechercher dans les données de ressource spécifiées l’icône ou le curseur qui correspond le mieux à l’appareil d’affichage actuel.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll