CreateRebar

CreateRebar()

Syntax

WindowsID = CreateRebar(ID.l, WindowID.i, *BackgroundImage, Style.l, Doublebuffer.b)

Description

Creates an empty Rebar in the window specified by WindowID. ID is the internal ID to be used and if #ProGUI_Any is used then the returned value will be the new Rebar ID.

BackgroundImage is optional and can point to image data used as the Rebar's background.

If Style contains the flag #UISTYLE_OFFICE2003,#UISTYLE_OFFICE2007 the rebar is rendered in the new Office 2003/2007 style.

Please also see SetUIColour for changing the colours used in the various styles to your own custom colours.

Style can also contain optional flags, see Microsoft MSDN for details: -

http://msdn.microsoft.com/en-us/library/bb774377(VS.85).aspx

Specify Doublebuffer as true in order to enable double buffering of rebars. Note bare in mind double buffering uses more memory and large Rebars can be very slow at refreshing. Double buffering isn't really necessary unless you want to eliminate all minor flickering.

Returns the Windows ID of the Rebar (or if #ProGUI_Any is used the Rebar ID) or zero for failure.

Whenever the Rebar is updated ProGUI will send a #REBAR_UPDATED event message to the main window's message queue. The wParam contains the new height of the Rebar and the lParam contains a handle to the Rebar that triggered the event.

Alternatively a user callback can be set instead with SetRebarUserCallback, this will also receive the #REBAR_UPDATED event message whenever the Rebar is updated.

Rebar Index