>> << Ndx Usr Pri Phr Dic Rel Voc !: wd Help User

# 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                         |
    +------------+--------------------------+

>> << Ndx Usr Pri Phr Dic Rel Voc !: wd Help User