Partager via


Fonction LoadBitmapA (winuser.h)

[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)

Voir aussi

Fonctions bitmap

Vue d’ensemble des bitmaps

CreateBitmap

DeleteObject

DrawFrameControl

LoadCursor

LoadIcon

LoadImage

MAKEINTRESOURCE