Blitz3D+ Command Reference

SetStatusText ( window,text$ )

Parameters

window - window with a status bar

text$ - text to show in the status bar

Description

Shows text in a window's status bar.

Requires Extended language mode.

The status bar is the quiet feedback channel of an editor - "Ready", "World saved", "Selected: crate_02" - visible without interrupting anyone, unlike a Notify box. The text updates instantly and posts no events; UTF-8, as everywhere in the GUI.

The window needs a status bar to write into: window style bit 8, which the default CreateWindow style 15 includes. On a window created without one, the call simply does nothing.

Although declared as a function for BlitzPlus compatibility, the return value is always 0 - call it like a statement:

SetStatusText window,"Ready - resize the window or drag the splitter"

See it working in the world-editor shell sample.

See also: CreateWindow, SetGadgetText, SetGadgetToolTip, Notify.

Index