The CONTROL tag is used to create a new toobar control. There are various control types and styles as defined by the control's type and style parameters.
Background color. Will set the background color of some controls types like Edit & combo boxes, static text etc. (requires v2.4.1 or later)
color
Text color. Will set the font color of certain controls like Edit & Combo boxes, static text etc. (requires v2.4.1 or later)
id
Control ID. Used to referece the control in functions.
type
Control Type. The valid values are toolbar, static, edit, combo, button, image, radio, checkbox, links, favorites, browser
style
Control style. The style can be a combination of one or more of the following values:
rightalign, leftalign, rtlreading
readonly, password, number, uppercase, lowercase
flat, left, right, center, top, bottom, vcenter
caption
Control caption. Captions are only used with some control types: static, radio, checkbox and button. For all other control types the caption is ignored.
action
Action to take or commands to execute when the control is activated, clicked etc.
disabled
Can have a value of either 1 or 0. The control is disabled if 1.
border
Defines the control border style. The border can have one of the following values: 0,1,solid,client,modal,sunken
hidden
Specifies whether the control is hidden or visible. The possoible values are:
0 - Control is hidden
1 - Control is Visible
2 - Control is Always visible and can not be hidden.
valign
Vertical alignment. The possible values are: top, bottom, center. The default alignment is top.
vspace
Vertical offset in pixels
hspace
Horizontal offset in pixels.
height
Control height in pixels.
width
Control width in pixels.
iconwidth
Toolbar icon width in pixels. (only used with toolbar controls)
iconheight
Toolbar icon height in pixels. (only used with toolbar controls)
value
Control value
global
If set to 1, the control's value will be global. Global values are shared between controls with the same id of different toolbars.
cache
Cache timeout in hours.
onbeginload
Action to take when a new page is about to be loaded.
onload
Action to take when new page finishes loading.
onchage
Action to take when the control's value changes
Remarks:
The Cache parameter is only used if a trigger of a function is used to access data from an external URL. It specifies how long a cached copy can be used before needing to re-request the page. The value is in hours, however hour fractions can also be specified where 0.5 would correspond to 30 minutes.
Compatibility
bgcolor and color parameters are supported in verison 2.4.1 and above.