GetBitmapDimensionEx function (wingdi.h)

Article
02/22/2024

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 hbit,
  [out] LPSIZE  lpsize
);

Parameters

[in] hbit

A handle to a compatible bitmap (DDB).

[out] lpsize

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

Requirement	Value
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