SetBitmapDimensionEx function

The SetBitmapDimensionEx function assigns preferred dimensions to a bitmap. These dimensions can be used by applications; however, they are not used by the system.

Syntax

BOOL SetBitmapDimensionEx(
  HBITMAP hbm,
  int     w,
  int     h,
  LPSIZE  lpsz
);

Parameters

hbm

A handle to the bitmap. The bitmap cannot be a DIB-section bitmap.

w

The width, in 0.1-millimeter units, of the bitmap.

h

The height, in 0.1-millimeter units, of the bitmap.

lpsz

A pointer to a SIZE structure to receive the previous dimensions of the bitmap. This pointer can be NULL.

Return Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

An application can retrieve the dimensions assigned to a bitmap with the SetBitmapDimensionEx function by calling the GetBitmapDimensionEx function.

The bitmap identified by hBitmap cannot be a DIB section, which is a bitmap created by the CreateDIBSection function. If the bitmap is a DIB section, the SetBitmapDimensionEx function fails.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See Also

Bitmap Functions

Bitmaps Overview

CreateDIBSection

GetBitmapDimensionEx

SIZE