Fonction LoadBitmapA (winuser.h)

Article
11/20/2024

[LoadBitmap est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il 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 de l’instance du module dont le fichier exécutable contient la 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 de bas ordre et zéro dans le mot à ordre élevé. La macro MAKEINTRESOURCE peut être utilisée pour créer cette valeur.

Valeur de retour

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 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 aux 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 bitmap	Nom 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 commençant 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 que le fichier d’en-tête Windows.h soit inclus.

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 bitmaps Menu-Item dans Utilisation de menus.

Note

L’en-tête winuser.h définit LoadBitmap comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winuser.h (include 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)