Función LoadBitmapA (winuser.h)

Artículo
08/27/2023

[LoadBitmap está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use LoadImage y DrawFrameControl.]

La función LoadBitmap carga el recurso de mapa de bits especificado desde el archivo ejecutable de un módulo.

Sintaxis

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

Parámetros

[in] hInstance

Identificador de la instancia del módulo cuyo archivo ejecutable contiene el mapa de bits que se va a cargar.

[in] lpBitmapName

Puntero a una cadena terminada en null que contiene el nombre del recurso de mapa de bits que se va a cargar. Como alternativa, este parámetro puede constar del identificador de recursos en la palabra de orden bajo y cero en la palabra de orden superior. La macro MAKEINTRESOURCE se puede usar para crear este valor.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el identificador del mapa de bits especificado.

Si la función no se realiza correctamente, el valor devuelto es NULL.

Comentarios

Si el mapa de bits al que apunta el parámetro lpBitmapName no existe o no hay memoria suficiente para cargar el mapa de bits, se produce un error en la función.

LoadBitmap crea un mapa de bits compatible de la pantalla, que no se puede seleccionar en una impresora. Para cargar un mapa de bits que puede seleccionar en una impresora, llame a LoadImage y especifique LR_CREATEDIBSECTION para crear una sección dib. Se puede seleccionar una sección de DIB en cualquier dispositivo.

Una aplicación puede usar la función LoadBitmap para acceder a mapas de bits predefinidos. Para ello, la aplicación debe establecer el parámetro hInstance en NULL y el parámetro lpBitmapName en uno de los valores siguientes.

Nombre del mapa de bits	Nombre del mapa de bits
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

Los nombres de mapa de bits que comienzan por OBM_OLD representan mapas de bits usados por versiones de 16 bits de Windows anteriores a 3.0.

Para que una aplicación use cualquiera de las constantes de OBM_, la constante OEMRESOURCE debe definirse antes de que se incluya el archivo de encabezado Windows.h.

La aplicación debe llamar a la función DeleteObject para eliminar cada identificador de mapa de bits devuelto por la función LoadBitmap .

Ejemplos

Para obtener un ejemplo, vea Ejemplo de Menu-Item mapas de bits en Uso de menús.

Nota

El encabezado winuser.h define LoadBitmap como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluya Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-draw-l1-1-1 (introducido en Windows 8.1)