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