Child Classes

The class defines the appearance and behavior of the control. The classes are:

button	pushbutton
check box	check box
combobox	combination of edit and listbox
combodrop	dropdown combo box
combolist	combination of edit and listbox
edit	single line edit box
editm	multiline edit box
groupbox	group box
isigraph	graphics box
isipicture	picture from a BMP, WMF, or ICO file
listbox	list box
radiobutton	radio button
scrollbar	horizontal scrollbar
scrollbarv	vertical scrollbar
static	static text
staticbox	display box
progress	progress bar
richedit	single line rich edit control
richeditm	multiline rich edit control
spin	horizontal spin button
spin	vertical spin button
tab	tab control
trackbar	horizontal trackbar
trackbarv	vertical trackbar

button
A button simply initiates a Windows event when pushed. Possible styles are:

bs_defpushbutton	the default pushbutton. Pressing Enter has the same effect as clicking this button.
bs_ownerdraw	a button with a picture from a graphics file

checkbox
A checkbox allows a two way selection - checked or unchecked. The only style is:

bs_lefttext

the caption is displayed on the left, instead of on the right.

Use the set command to set the value of a checkbox, for example, to check control cb:

   wd 'set cb 1'

The result of wd'q' contains the current value of each check box.

combobox
combodrop
combolist
A combobox is a combination of a listbox and an edit box. You can enter a response into the edit box, or select a response from the listbox. You may select only one item in a combobox.

A combodrop is similar to a combobox, but initially shows only the edit box, and allows the list box to appear when selected.

A combolist is similar to a combobox, except that you may select only from the list box, and may not enter any response into the edit box.

Class styles are:

cbs_autohscroll	allow horizontal scrolling of the edit box
cbs_sort	sort entries alphabetically

Use the set command to set the possible selections in a checkbox. This can be a list of names, that may be delimited by LF, EAV or ". For example:

   wd 'set cbox red green blue brown'
   wd 'set cbox "red" "green" "blue" "brown"'
   wd 'set cbox ',; (;:'red green blue brown') ,each LF

Use setselect to set the selection. For example, the following sets item 2:

   wd 'setselect cbox 2'

The result of wd'q' contains the current value and selection of each combobox. For example:

...
+------------+-----------------------------+
|cbox        |blue                         |
+------------+-----------------------------+
|cbox_select |2                            |
+------------+-----------------------------+

edit
editm
An edit control is a single-line box, and an editm control is a multiline box, in which text can be displayed and edited. Edit control styles are:

es_autohscroll	use horizontal scroll bars if required
es_autovscroll	use vertical scroll bars if required
es_center	center text
es_lowercase	lowercase text only
es_readonly	display text as read-only
es_right	right justify text in control
es_uppercase	uppercase text only

Use the set command to write text to an edit control. For example:

   wd 'set edit *Jeremy Fisher'

The result of wd'q' contains the current text for each edit box, and indices of any selected text:

...
+------------+-----------------------------+
|edit        |Peter Rabbit                 |
+------------+-----------------------------+
|edit_select |6 12                         |
+------------+-----------------------------+

groupbox
A groupbox control is a box used to group controls, most often radiobuttons. There are no class styles.

isigraph
An isigraph control is a window that can display graphics. First create an isigraph control, then use graphics commands to create and display the graphics. All graphics commands start with g. Graphics are displayed only when the gshow command is given.

Graphics commands apply to the currently selected isigraph control. The graphics window has coordinates running from (0,0) in the bottom left hand corner to (1000,1000) at the top right.

See the demos, Studio|Demos|isigraph.

isipicture
An isipicture control displays an image from a file. The file may be a DIB (device independent bitmap), WMF (Windows metafile) or ICO (icon file). DIB files usually have a file extension of .bmp.

The set command sets the filename. For example, to display the J logo icon:

   wd 'set isipicture *system\examples\data\j.ico'

listbox
A listbox control displays a list of items that can be selected by the user. Listbox control styles are:

lbs_extendsel	extended select holding down the Shift key
lbs_multicolumn	display in multiple columns
lbs_multiplesel	allow multiple selections
lbs_ownerdrawfixed	create an ownerdrawn listbox
lbs_sort	sort entries alphabetically

Use the set command to put items in the listbox (as in combobox above).

In the result of wd'q', multiple selections are delimited by LF. For example:

+--------------+-----------------------------+
|listbox       |green blue brown             |
+--------------+-----------------------------+
|listbox_select|1 2 3                        |
+--------------+-----------------------------+

progress
A progress control displays a bar used to indicate the status of a program. Use the set command to set values between 0 and 100. For example, to indicate the half way stage:

   wd 'set pg 50'

radiobutton
radiobutton controls typically allow a single selection from a group of controls. Selecting one control switches the others off. The only style is:

bs_lefttext

the caption is displayed on the left, instead of on the right.

Use the set command to set the value of a radiobutton, for example, to check control rb:

   wd 'set rb 1'

The result of wd'q' contains the current value of each radiobutton.

richedit
richeditm
A richedit control is a single line edit box, and a richeditm control is a multiline edit box, each containing rich edit text. Class styles are:

es_autohscroll	use horizontal scroll bars if required
es_autovscroll	use vertical scroll bars if required
es_center	center text
es_readonly	display text as read-only
es_right	right justify text in control
es_sunken	display sunken

For more information, see the Richedit Control section later in this chapter.

scrollbar
scrollbarv
A scrollbar control displays a horizontal scrollbar, and a scrollbarv displays a vertical scrollbar. There are no class styles.

The set command sets four values for the scrollbar: leftmost (or top) position, current position, rightmost (or bottom) position, and the size of change resulting from a click in the area between the thumbbox and either end of the scrollbar.

   wd 'set sb 0 500 1000 50'

A single parameter sets the current position:

   wd 'set sb 600'

Clicking a scrollbar signals an event. The result of wd'q' has the current position of the scrollbar. For example:

...
+----------+----------------------------+
|sb        |550                         |
+----------+----------------------------+

spin
spinv
A spin control displays two arrows horizontally, and a spinv control displays the arrows vertically. Clicking an arrow initiates a Windows event, and the result of wd'q' is _1 for the down or left arrow, 1 for the up or right arrow.

static
A static control is used to display text. It is never active. Static control styles are:

ss_center	center text
ss_leftnowordwrap	left justify, no word wrap
ss_noprefix	allow & characters in control
ss_right	right justify text
ss_simple	static text control

staticbox
A static control is used to display boxes with various types of frames and backgrounds. It is never active. Staticbox control styles are:

ss_blackframe	black frame
ss_blackrect	black rectangle
ss_etchedframe	etched frame
ss_etchedhorz	etched horizontally only
ss_etchedvert	etched vertically only
ss_grayframe	gray frame
ss_grayrect	gray rectangle
ss_sunken	sunken
ss_whiteframe	white frame
ss_whiterect	white rectangle

tab
A tab control is used to display several Windows controls on tab forms. Class styles are:

tcs_button	display tabs as buttons
tcs_multiline	allow tabs to be displayed in several lines

For more information, see the Tab Control section later in this chapter.

trackbar
trackbarv
A trackbar control displays a horizontal trackbar, and a trackbarv displays a vertical trackbar. Class styles are:

tbs_autoticks	display tick marks along control
tbs_both	display tick marks on both sides of control
tbs_enableselrange	enables setselect to mark a range on the trackbar
tbs_left	display thumb pointing to left / tick marks on left
tbs_nothumb	do not display a thumb control
tbs_noticks	do not display any tick marks
tbs_top	display thumb pointing to top / tick marks on top

The set command sets up to five values for the trackbar: leftmost (or top) position, current position, rightmost (or bottom) position, and the size of change resulting from a click in the area between the thumbbox and either end of the trackbar, and line size.

   wd 'set tb 0 3 20 1 1'

A single parameter sets the current position:

   wd 'set tb 4'

Clicking a trackbar signals an event. The result of wd'q' has the current position of the trackbar. For example:

...
+------------+--------------------------+
|tb          |4                         |
+------------+--------------------------+