Fonction LoadBitmapA (winuser.h)

Article
08/27/2023

[LoadBitmap est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt LoadImage et DrawFrameControl.]

La fonction LoadBitmap charge la ressource bitmap spécifiée à partir du fichier exécutable d’un module.

Syntaxe

HBITMAP LoadBitmapA(
  [in] HINSTANCE hInstance,
  [in] LPCSTR    lpBitmapName
);

Paramètres

[in] hInstance

Handle du instance du module dont le fichier exécutable contient l’image bitmap à charger.

[in] lpBitmapName

Pointeur vers une chaîne terminée par null qui contient le nom de la ressource bitmap à charger. Ce paramètre peut également se composer de l’identificateur de ressource dans le mot d’ordre inférieur et de zéro dans le mot d’ordre élevé. La macro MAKEINTRESOURCE peut être utilisée pour créer cette valeur.

Valeur retournée

Si la fonction réussit, la valeur de retour est le handle de la bitmap spécifiée.

Si la fonction échoue, la valeur de retour est NULL.

Remarques

Si la bitmap pointée vers par le paramètre lpBitmapName n’existe pas ou si la mémoire est insuffisante pour charger la bitmap, la fonction échoue.

LoadBitmap crée une bitmap compatible de l’affichage, qui ne peut pas être sélectionnée sur une imprimante. Pour charger une bitmap que vous pouvez sélectionner sur une imprimante, appelez LoadImage et spécifiez LR_CREATEDIBSECTION pour créer une section DIB. Une section DIB peut être sélectionnée sur n’importe quel appareil.

Une application peut utiliser la fonction LoadBitmap pour accéder à des bitmaps prédéfinies. Pour ce faire, l’application doit définir le paramètre hInstance sur NULL et le paramètre lpBitmapName sur l’une des valeurs suivantes.

Nom de bitmap	Nom de bitmap
OBM_BTNCORNERS	OBM_OLD_RESTORE
OBM_BTSIZE	OBM_OLD_RGARROW
OBM_CHECK	OBM_OLD_UPARROW
OBM_CHECKBOXES	OBM_OLD_ZOOM
OBM_CLOSE	OBM_REDUCE
OBM_COMBO	OBM_REDUCED
OBM_DNARROW	OBM_RESTORE
OBM_DNARROWD	OBM_RESTORED
OBM_DNARROWI	OBM_RGARROW
OBM_LFARROW	OBM_RGARROWD
OBM_LFARROWD	OBM_RGARROWI
OBM_LFARROWI	OBM_SIZE
OBM_MNARROW	OBM_UPARROW
OBM_OLD_CLOSE	OBM_UPARROWD
OBM_OLD_DNARROW	OBM_UPARROWI
OBM_OLD_LFARROW	OBM_ZOOM
OBM_OLD_REDUCE	OBM_ZOOMD

Les noms bitmap qui commencent par OBM_OLD représentent les bitmaps utilisées par les versions 16 bits de Windows antérieures à 3.0.

Pour qu’une application utilise l’une des constantes OBM_, la constante OEMRESOURCE doit être définie avant d’inclure le fichier d’en-tête Windows.h.

L’application doit appeler la fonction DeleteObject pour supprimer chaque handle bitmap retourné par la fonction LoadBitmap .

Exemples

Pour obtenir un exemple, consultez Exemple de Menu-Item bitmaps dans Utilisation des menus.

Notes

L’en-tête winuser.h définit LoadBitmap comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

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
Ensemble d’API	ext-ms-win-ntuser-draw-l1-1-1 (introduit dans Windows 8.1)