GetBitmapDimensionEx function

The GetBitmapDimensionEx function retrieves the dimensions of a compatible bitmap. The retrieved dimensions must have been set by the SetBitmapDimensionEx function.

Syntax


BOOL GetBitmapDimensionEx(
  _In_  HBITMAP hBitmap,
  _Out_ LPSIZE  lpDimension
);

Parameters

hBitmap [in]

A handle to a compatible bitmap (DDB).

lpDimension [out]

A pointer to a SIZE structure to receive the bitmap dimensions. For more information, see Remarks.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Remarks

The function returns a data structure that contains fields for the height and width of the bitmap, in .01-mm units. If those dimensions have not yet been set, the structure that is returned will have zeros in those fields.

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
SetBitmapDimensionEx
SIZE

 

 

Show: