InsertRebarGadget

InsertRebarGadget()

Syntax

BandID = InsertRebarGadget(Rebar.i, Band.l, GadgetID.l, Text$, Width.l, MinWidth.l, Height.l, *BackgroundImage, Style.l)

Description

Inserts a gadget into a previously created Rebar.

Rebar.i is the ID/Handle of the Rebar you wish to insert the gadget into. Band.l is the Index/ID of the band you wish to insert the new gadget before and can be -1 in order to insert the gadget on a new band at the end of the Rebar.

GadgetID specifies the Windows ID of a gadget(control/window). Text$ specifies the label that will appear on the band. Width is the desired width of the band, MinWidth is the minimum width the band can be resized to and Height is the desired height of the band.

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

Style can contain optional flags, see Microsoft MSDN for details: http://msdn.microsoft.com/en-us/library/bb774393(VS.85).aspx

Also, Style can contain these ProGUI specific flags:

#RBBS_SIZEABLE        - Automatically resizes the band to fit most of the window.

#RBBS_VERTICALRESIZEABLE - Allows manual user vertical resizing of the band.

#RBBS_FIXEDBMP - When BackgroundImage points to image data this flag will keep the background in a fixed position.

Returns the new Band ID of the rebar or -1 for failure.

Rebar Index