Función SetBitmapDimensionEx (wingdi.h)

La función SetBitmapDimensionEx asigna dimensiones preferidas a un mapa de bits. Estas dimensiones pueden ser utilizadas por aplicaciones; sin embargo, el sistema no los usa.

Sintaxis

BOOL SetBitmapDimensionEx(
  [in]  HBITMAP hbm,
  [in]  int     w,
  [in]  int     h,
  [out] LPSIZE  lpsz
);

Parámetros

[in] hbm

Identificador del mapa de bits. El mapa de bits no puede ser un mapa de bits de sección DIB.

[in] w

Ancho, en unidades de 0,1 milímetros, del mapa de bits.

[in] h

Alto, en unidades de 0,1 milímetros, del mapa de bits.

[out] lpsz

Puntero a una estructura SIZE para recibir las dimensiones anteriores del mapa de bits. Este puntero puede ser NULL.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

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

Comentarios

Una aplicación puede recuperar las dimensiones asignadas a un mapa de bits con la función SetBitmapDimensionEx mediante una llamada a la función GetBitmapDimensionEx .

El mapa de bits identificado por hBitmap no puede ser una sección DIB, que es un mapa de bits creado por la función CreateDIBSection . Si el mapa de bits es una sección DIB, se produce un error en la función SetBitmapDimensionEx .

Requisitos

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	wingdi.h (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll

Consulte también

Funciones de mapa de bits

Información general sobre mapas de bits

CreateDIBSection

GetBitmapDimensionEx

SIZE