SetBitmapDimensionEx

La función SetBitmapDimensionEx asigna dimensiones a un mapa de bits. Estas dimensiones pueden ser usadas por aplicaciones; sin embargo, no pueden ser usadas por Windows.

Sintaxis

BOOL SetBitmapDimensionEx(
    HBITMAP hBitmap,  // manipulador de mapa de bits
    int nWidth,       // anchura del mapa de bits en décimas de mm
    int nHeight,      // altura del mapa de bits en décimas de mm
    LPSIZE lpSize     // dirección de la estructura para las dimensiones originales
   );

Parámetros:

hBitmap: identifica el mapa de bits. El mapa de bits no puede ser un mapa de bits de sección DIB.

nWidth: especifica la anchura, en décimas de milímetro, del mapa de bits.

nHeight: especifica la altura, en décimas de milímetro, del mapa de bits.

lpSize: puntero a estructura SIZE que recibirá las dimensiones previas del mapa de bits. Este puntero puede ser NULL.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener más información sobre el error, llamar a la función GetLastError.

Observaciones

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 sea un mapa de bits creado por la función CreateDIBSection. Si el mapa de bits es una sección dib, la función SetBitmapDimensionEx falla.