Radio Box: _isGray

Radio Box: _isGray

Reports whether a specified button or the entire radio box is grayed

Syntax
Details
Example

Syntax

CALL NOTIFY (radio-box-name, '_isGray', is-grayed<, button-number>);

Argument Type Description

is-grayed
N returns a value indicating the status of the button(s):

1 the specified button is grayed

0 the specified button is not grayed. If button-number is omitted, no button in the radio box is grayed.

-n all buttons are grayed, where n is the total number of buttons

m
m buttons are grayed

button-number
N specifies the button number. If button-number is included, is-grayed returns either 0 or 1.

Argument	Type	Description
is-grayed	N	returns a value indicating the status of the button(s):
		1	the specified button is grayed
		0	the specified button is not grayed. If button-number is omitted, no button in the radio box is grayed.
		-n	all buttons are grayed, where n is the total number of buttons
		m	m buttons are grayed
button-number	N	specifies the button number. If button-number is included, is-grayed returns either 0 or 1.

Details

Unlike _isGray in the Widget class, this method has the optional button-number argument and may return values of -n and m for the is-grayed argument.

Example

_isGray determines whether the third button in RBOX1 is currently grayed:

   call notify('rbox1','_is_gray_',isgray,3);
   if isgray=1 then
      _msg_='The third button is currently
             grayed.';
   else
      _msg_='The third button is not 
             currently grayed.';

Chapter Contents
Previous
Next
Top of Page