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. |