Blitz3D+ Command Reference

GadgetHeight ( gadget )

Parameters

gadget - gadget to read the size of

Description

Returns a gadget's height.

Requires Extended language mode.

Reads the gadget's outer height in logical 96-DPI units - the value from creation or SetGadgetShape, kept current by any SetGadgetLayout rules that have stretched it since. Read it after a window resize to see what the layout rules produced.

Like GadgetWidth, this is the outer size: a group's usable interior is ClientHeight, which for a window also excludes the frame, menu and status bar. Stack children against the parent's ClientHeight, not its GadgetHeight.

For canvases, the drawing buffer's physical pixel height comes from CanvasPixelHeight instead - bigger than this logical height on a high-DPI monitor.

The world editor shell sample shows the layout work these getters support.

See also: GadgetWidth, GadgetY, ClientHeight, CanvasPixelHeight, SetGadgetShape.

Index