Export (0) Print
Expand All

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(
  _In_   HBITMAP hBitmap,
  _In_   int nWidth,
  _In_   int nHeight,
  _Out_  LPSIZE lpSize
);

Parameters

hBitmap [in]

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

nWidth [in]

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

nHeight [in]

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

lpSize [out]

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]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Bitmaps Overview
Bitmap Functions
CreateDIBSection
GetBitmapDimensionEx
SIZE

 

 

Community Additions

ADD
Show:
© 2014 Microsoft