Xbasic

UI_TOOLBAR Function

Syntax

N ui_toolbar(C script_names [,C title [,L has_tabs]])

Arguments

Selection

A number ranging from 0 to the number of elements in Choice_List minus one.

script_names

A CR-LF delimited list of choices to appear on the toolbar.

title

Optional. The title of the toolbar.

has_tabs

Optional. Default = .F. .T. = Toolbar has tabs. .F. = Toolbar does not have tabs.

Description

The UI_TOOLBAR() function runs a script that in turn displays a toolbar populated with the selections provided in Choice_List and returns the user's selection. Because the script displays the toolbar, the programmer does not receive a pointer to the toolbar.

The user must manually close the toolbar.
images/UI_TOOLBAR().gif

Example 

dim list as C
list = <<%str%
Button 1
Button 2
Button 3
Button 4
%str%
ui_toolbar(list, "UI_TOOLBAR() ")

Limitations

Desktop applications only.

See Also