SAS Component Language Dictionary

UNGRAY

Ungrays a window element

Category:

Control or Field

Syntax
Details
Example
See Also

Syntax

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

rc

contains the return code for the operation:

0	successful
0	unsuccessful

Type: Numeric

var-name

is the control or choice group to be ungrayed.

Type: Character

station

is the number of a field within the choice group or the number of a button within the radio box.

Type: Numeric

row

is the number of a row when the choice group is in the scrollable section of an extended table. The row parameter is valid for PROGRAM entries but not for FRAME entries. Specify row only when you want to ungray a station from outside the extended table's getrow or putrow section.

Type: Numeric

Details

You can use UNGRAY along with GRAY to control the availability of a choice group, a station, or a window element, based on the program flow.

When a window element is ungrayed, it becomes unprotected and reverts to its normal color. An ungrayed window element can once again receive input such as mouse clicks. FRAME entry controls can also use the _ungray method.

Example

Make a station available only when the value of variable DEPT is ADMIN:

if (dept='ADMIN') then
      rc=ungray('personal',3);
   else
      rc=gray('personal',3);