SetBitmapDimensionEx

3.1

  BOOL SetBitmapDimensionEx(hbm, nX, nY, lpSize)    
  HBITMAP hbm; /* handle of bitmap, */  
  int nX; /* bitmap width */
  int nY; /* bitmap height */
  SIZE FAR* lpSize; /* address of structure for prev. dimensions */

The SetBitmapDimensionEx function assigns the preferred size to a bitmap, in 0.1-millimeter units. The graphics device interface (GDI) does not use these values, except to return them when an application calls the GetBitmapDimensionEx function.

Parameters

hbm

Identifies the bitmap.

nX

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

nY

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

lpSize

Points to a SIZE structure. The previous bitmap dimensions are placed in this structure. If lpSize is NULL, nothing is returned. The SIZE structure has the following form:

typedef struct tagSIZE {
    int cx;
    int cy;
} SIZE;

For a full description of this structure, see the Microsoft Windows Programmer's Reference, Volume 3.

Return Value

The return value is nonzero if the function is successful. Otherwise, it is zero.