Función LoadBitmapW (winuser.h)

Artículo
11/20/2024

[ LoadBitmap está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. 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 LoadBitmapW(
  [in] HINSTANCE hInstance,
  [in] LPCWSTR   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 alto. 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 se produce un error en la función, el valor devuelto es NULL.

Observaciones

Si el mapa de bits al que apunta el lpBitmapName parámetro 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 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 de para eliminar cada identificador de mapa de bits devuelto por la función LoadBitmap de .

Ejemplos

Para obtener un ejemplo, vea Ejemplo de mapas de bits de Menu-Item en Usar 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winuser.h (incluya Windows.h)
biblioteca de	User32.lib
DLL de	User32.dll
conjunto de API de	ext-ms-win-ntuser-draw-l1-1-1 (introducido en Windows 8.1)