Fonction LookupIconIdFromDirectory (winuser.h)
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 |
Voir aussi
Conceptuel
Référence