Buttons

Subroutine	Function
PIX.GUI.LOAD.TEXTBUTTON	Creating a text push-button
PIX.GUI.LOAD.PUSHBUTTON	Creating an image push-button
PIX.GUI.LOAD.CHECKBUTTON	Creating a check box
PIX.GUI.LOAD.RADIOBUTTON	Creating a radio button

Creating a text push-button

To create a push button holding a text label, call the following subroutine from your application:

PIX.GUI.LOAD.TEXTBUTTON (GUI.APP.NAME, CONTROL.DETAILS, STRING)

Where:

CONTROL.DETAILS = Control ID, TEXTBUTTON, X, Y, W, H, Label, {Key1,...Keyn}

Where:

Control ID	The unique name for the text button.
TEXTBUTTON	Text literal TEXTBUTTON.
X	The X co-ordinate of the left of the button.
Y	The Y co-ordinate of the top of the button.
W	Width of the button (characters).
H	Height of the button (characters).
Label	Textual label associated with that button.
Key1...Keyn	Additional parameters if required, in any order - see below.

The following extra keyword parameters are available:

HIDE	SHOW *	GRAYED	UNGRAYED *
TERMITE*	HELV8	HELV10	SYSTEM

Default settings are denoted by *, see Keyword Definitions for definitions.

Alternatively, you can use the PIX.GUI.CONTROL.LOAD subroutine, see Loading all types of controls.

Note: To highlight a specific character in the text label as the Accelerator Key, precede the character with an ampersand (&). For example, 'Pro&Cess '.

Text Push-Buttons Program Example

Note: This example shows the lines of code split up for ease of readability - one line of code would normally be displayed on one line.

061    CALL PIX.GUI.LOAD.TEXTBUTTON
("","FILE,TEXTBUTTON,65,2,9,2,&File,HELV10","")
062 CALL PIX.GUI.LOAD.TEXTBUTTON ("","CANCEL,TEXTBUTTON,65,5,9,2,Cancel","")
063 CALL PIX.GUI.LOAD.TEXTBUTTON("" ,"ADD,TEXTBUTTON,65,11,9,2,Add","")

Creating an image push-button

To create a push button holding an image, call the following subroutines from your application:

CALL PIX.GUI.LOAD.PUSHBUTTON (GUI.APP.NAME, CONTROL.DETAILS, STRING)

Where:

CONTROL.DETAILS	Control ID, PUSHBUTTON, X, Y, W, H, Label, {Key1,...Keyn}

Where:

Control ID	The unique name for the push button.
PUSHBUTTON	Text literal PUSHBUTTON.
X	The X co-ordinate of the left of the button.
Y	The Y co-ordinate of the top of the button.
W	Width of the button (characters).
H	Height of the button (characters).
Label	Textual label associated with that button.
Key1...Keyn	Additional parameters if required, in any order - see below.

The following extra keyword parameters are available:

HIDE	SHOW *	GRAYED	UNGRAYED*
PUSH*	FRAME	PUSHEDIN	PUSHEDOUT
SHADOWED	NONE	LABELLED	BITMAP *
ICON	FILEID	LABELPOS	TERMITE
HELV8	HELV10	FILE	ID
SYSTEM	SUBS	FILETYPE	FILE

Default settings are denoted by *. See Keyword Definitions for definitions.

Alternatively, you can use the PIX.GUI.CONTROL.LOAD subroutine described on Loading all types of controls.

Image Push-Buttons Program Example

067 CALL PIX.GUI.LOAD.PUSHBUTTON("","HELP,PUSHBUTTON,
65,8,9,2,\bitmaps\f1help.bmp","")

Creating a check box

To create a check box, call the following subroutine from your application:

CALL PIX.GUI.LOAD.CHECKBUTTON (GUI.APP.NAME, CONTROL.DETAILS, STRING)

Where:

CONTROL.DETAILS = Control ID, CHECK, X, Y, W, H, Label, {Key1,...Keyn}

Where:

Control ID	The unique name for the check box.
CHECK	Text literal CHECK.
X	The X co-ordinate of the left of the check box.
Y	The Y co-ordinate of the top of the check box.
W	Width of the box (characters).
H	Height of the box (characters).
Label	Textual label associated with that box.
Key1...Keyn	Additional parameters if required, in any order.

The following extra keyword parameters are available:

HIDE	SHOW *	GRAYED	UNGRAYED *
TERMITE*	SYSTEM	HELV8	HELV10
LEFT	RIGHT *	CHECKED	UNCHECKED *

Default settings are denoted by *. See Keyword Definitions for definitions. Alternatively, you can use the PIX.GUI.CONTROL.LOAD subroutine described on Loading all types of controls.

Check Boxes Program Example

Note: This example shows the lines of code split up for ease of readability - one line of code would normally be displayed on one line.

115     PIX.GUI.LOAD.CHECKBUTTON ("","CAR,CHECK,47,10,10,1,
    Car Park,Helv10,LEFT","")
116     CALL PIX.GUI.LOAD.CHECKBUTTON("","CAT,
    CHECK,47,11,10,1,Catalogue,Helv10,LEFT","")

Creating a radio button

To create a radio button, call the following subroutine from your application:

CALL PIX.GUI.LOAD.RADIOBUTTON (GUI.APP.NAME, CONTROL.DETAILS, STRING)

Where:

CONTROL.DETAILS	Control ID, RADIO, X, Y, W, H, Label, {Key1,...Keyn}

Where:

Control ID	The unique name for the radio button.
RADIO	Text literal RADIO.
X	The X co-ordinate of the left of the button.
Y	The Y co-ordinate of the top of the button.
W	Width of the button (characters).
H	Height of the button (characters).
Label	Textual label associated with that button.
Key1...Keyn	Additional parameters if required, in any order.

The following extra keyword parameters are available:

HIDE	SHOW *	GRAYED	UNGRAYED *	RADIO GROUP
TERMITE *	SYSTEM	HELV8	HELV10
LEFT	RIGHT *	CHECKED	UNCHECKED *

Default settings are denoted by *. See Keyword Definitions for definitions.

Alternatively, you can use the PIX.GUI.CONTROL.LOAD subroutine described on Loading all types of controls.

Radio Buttons Program Example

Note: This example shows the lines of code split up for ease of readability - one line of code would normally be displayed on one line.

110 CALL PIX.GUI.LOAD.RADIOBUTTON("","DOG,RADIO,33,10,10,1,
Dog,Helv10,LEFT,CHECK,SEX","")
111 CALL PIX.GUI.LOAD.RADIOBUTTON ("","BITCH,RADIO,33,11,10,1,Bitch,Helv10,LEFT,SEX","")