Keyword Definitions

The following table describes, in alphabetic order, all of the keywords you can use as optional parameters in PICK BASIC subroutines. Defaults are shown with an asterisk (*) character.

ABBRDATE

HELV10

MODELESS

RADIO GROUP

BITMAP

HIDDENMSG

MORE

READONLY

BORDER

HIDE

NAMECOL

READWRITE *

BORDERNONE

HSCROLL

NAMEROW

RIGHT

BORDERNORM

HSCROLLBAR

NOCASECONVERT*

SCALED*

BORDERON

ICON

NOCOL

SCULPTURE

BORDEROFF

INITSELECT

NODELETE

SELECT*

BORDERTHICK

INTRANGE

NOROW

SHADOWED

BORDERTHIN

LABELED

NONE*

SHORTDATE

CENTER

LABLEPOS

NOSELECT

SHOW*

CHECKED

LEFT

NOSORT

SORT

CLIPPED

LINELEN

NOTITLE

TABBED

COLOUR

LINESOFF

NUMCOL

TERMITE*

DISPLAYMSG

LONGDATE

NUMROW

TOPBOX

FILEID

LOWER

PASSWORD

UNCHECKED

FRAME

MAX

PUSH

UNGRAYED*

GRAYED

MIN

PUSHEDIN

UPPER

HELV8

MODAL

PUSHEDOUT

VSCROLL

 

 

 

VSCROLLBAR

Keywords defined

ABBRDATE

Validation for a date entered in abbreviated format, for a validated edit box. For example, DD/MM/.

BITMAP

Followed by a .bmp file name, associated with LABELED (if specified).

BORDER

Border  type: follow with the type of border required. i.e. BORDER, followed by NONE, NORM, THIN, or THICK.

BORDERNONE

No border for a secondary window.

BORDERNORM

Create a normal border for a secondary window.

BORDERON

Control is surrounded by a box, extending 4 pixels above and below the normal box. You cannot have two bordered controls on consecutive lines.

BORDEROFF

Control is not surrounded by a box.

BORDERTHICK

Create a thick border for a secondary window.

BORDERTHIN

Create a thin border for a secondary window.

CENTER

Text is center-justified for labels within its boundary.

CHECKED

Control is checked when displayed. (RADIO, CHECK controls) Only one radio button within its group will be checked, even if all are set with checked set. (the last to be loaded).

CLIPPED

Clips bitmap to image co-ordinates (does not re-scale).

COLOUR

Colour of a secondary window.

DISPLAYMSG

Display the normal text in the string list. This is returned by PIX.GUI.READ.VALUE.

FILEID

The following keywords will be the file ID (e.g. HOST.EXE) and the next keyword will be the resource number  (e.g. 103).

FRAME

No border.

GRAYED

Control is inactive when created

HELV8

Control uses the Helvetica 8  font to display the text

HELV10

Control uses the Helvetica 10 font to display the text

HIDDENMSG

Display the hidden text in the string list. This is returned by PIX.GUI.READ.VALUE

HIDE

Control is hidden when created

HSCROLL

Control has ability to scroll horizontally

HSCROLLBAR

Control has horizontal scroll bar attached

ICON

If ICON specified then the following keywords will be the Icon: .ico file, associated with LABELED if specified.

INITSELECT

If specified, the following keyword will be the item in the string list to be highlighted when control gains focus. e.g. If a string called LETTER contained items  'A' to  'G' and  'C' was selected to be highlighted, when displayed the item  'C' would be highlighted. i.e.  'INITSELECT, C '.

INTRANGE

When specified, gives an integer number range for validated edit boxes. Range is defined by the following two keywords lownum and highnum.

LABELED

If labeled with a bitmap then text (label) appears with the bitmap.

LABLEPOS

If LABLEPOS specified then the following keywords will be the (X,Y) position of the label. e.g. LABLEPOS, 10,10.

LEFT

Text associated with Radio and Check controls is placed to the left of the control or Text will be Left justified for Labels within its boundary.

LINELEN

If LINELEN specified then the following keyword will be the maximum number of characters allowed to be entered. This is the total limit, not just the limit on a single line. (Multi-line edit box user take note) Default is 64K characters.

For example, LINELEN, 30 will set the maximum line length to 30.

LONGDATE

Validated date entered in long format, for a validated edit box. For example, 12 December 1994

LOWER

Convert returning text to lower case.

MAX

Creates a maximize box for a secondary window.

MIN

Creates a minimize box for a secondary window.

MODAL

The control is modal.

MODELESS

The control is modeless.

MORE

Sets how many elements the list box will hold, for incremental list boxes. Follow this by the number of elements. You can use this feature to create list boxes with room for many entries, and create corresponding string lists with only a few items. This allows you to update the list box incrementally as the user scrolls downwards.

NOCASECONVERT*

Text returned from control is not case-converted.

NONE

No shadow.

NOSELECT

Contents not selected when control receives focus.

NOSORT

String list is not sorted when loaded into a list/combo box.

NOTITLE

Set no title for a secondary window.

PASSWORD

Text is encrypted to display password character. Default set to #.

PUSH

Displays image with a button border. When image pushed by user, the border colours are swapped.

PUSHEDIN

Image sunken.

PUSHEDOUT

Image raised.

RADIO GROUP

This is the Control ID of the group for a set of radio buttons. You will not need to specify this group using the GROUP control type if placed as a keyword.

READONLY

Control is read-only. No changes can be made to the data.

READWRITE

Control is read/write. Changes can be made to the data.

RIGHT

Text associated with radio and check controls is placed to the right of the control (or text is right-justified for labels within its boundary).

SCALED

Scales bitmap to image co-ordinates.

SCULPTURE

Control is surrounded with sculpted line drawing.

SELECT

Contents selected when control receives focus.

SHADOWED

Give image a shadow.

SHORTDATE

Validation for a date entered in short format, for a validated edit box. For example, DD/MM/YY.

SHOW

Control is shown when created.

SORT

String list is alphabetically sorted when loaded into a list/combo box

TABBED

Allows you to present your list box in tabular columns. The String list loaded needs each column of data separated by a TAB. e.g.  'STRING, Andy<TAB>18, Francis<TAB>13' where <TAB> is char(9). 

TERMITE

Control uses the TERMiTE display font to display the text

TOPBOX

If specified, the following keyword will be the item in the string list to be placed at the top of the box. e.g. If a string called LETTERS contained items  'A' to  'Z' and  'F' was selected to be at the top of the box, when displayed the user could scroll back to  'A' . If not specified then  'A' would be at the top of the box. i.e.  'TOPBOX, F '.

UNCHECKED

Control is not checked when displayed. (RADIO, CHECK Controls) One radio button within its group will have the CHECKED state even if all are set with NO Check set (the last to be loaded).

UNGRAYED

Control is active when created.

UPPER

Convert returning text to upper case.

VSCROLL

Control has ability to scroll vertically.

VSCROLLBAR

Control has vertical scroll bar attached.