SAS Component Language Dictionary

ISGRAY

Reports whether a FRAME entry control or choice group is grayed

Category:

Control or Field

Syntax
Details
Examples
	Example 1: Determining Whether an Extended Table Row Is Grayed
	Example 2: Finding the Number of Stations in a Choice Group
See Also

Syntax

rc=ISGRAY(var-name<,station<,row>>);

rc

contains the return code for the operation:

1	the specified station is grayed
0	the specified station is not grayed, or no station in the choice group is grayed
m	the number of stations that are grayed, when an entire choice group is not grayed
-n	the total number of stations, when an entire choice group is grayed.

Type: Numeric

var-name

is the window control or choice group to be tested.

Type: Character

station

is the number of the choice group station or the button in a radio box. Station must be greater than 0 and must be no greater than the total number of buttons in a radio box or the number of stations in a choice group.

Type: Numeric

row

is the number of the row when the control or choice group is in the scrollable section of an extended table. Row is valid for PROGRAM entries. Specify row only when you want to determine whether the station is gray from outside the extended table's getrow or putrow section.

Type: Numeric

Details

Window controls can also use the _isGray method.

Because choice groups can be defined only in SAS/AF software, you cannot use ISGRAY in FSEDIT or FSVIEW programs.

Examples

Example 1: Determining Whether an Extended Table Row Is Grayed

Test whether the choice group WINE at the third row of an extended table is grayed:

if (isgray('wine',0,3)) then
      do;
       ...SCL program statements...
      end;

Example 2: Finding the Number of Stations in a Choice Group

Find out how many stations are defined for a choice group:

rc=gray('wine');
   total=abs(isgray('wine'));