SAS Component Language Dictionary

DISPLAYED

Reports whether a control or field is currently visible

Category:

Control or Field

Syntax
Details
Example
See Also

Syntax

rc=DISPLAYED(wvar-name);

rc

indicates whether the FRAME entry control or field is visible:

1	visible
0	not visible

Type: Numeric

wvar-name

is the name of a control or field. This name cannot be an element of an array or an expression. An invalid wvar-name halts the program.

Type: Character

Details

In SAS/AF applications, DISPLAYED reports whether a control is currently visible or whether it has the NONDISPLAY attribute. In FSEDIT, DISPLAYED tells you whether a field is visible on the current screen of a multiscreen application, regardless of whether the control has the NONDISPLAY attribute. This function is useful in multiscreen applications in which the application developer wants to be on a specific screen for a field.

If a control is not currently displayed, then your application can use the EXECCMD routine to issue scrolling commands to change the screen position or to issue scrolling commands that are specific to the procedure (for example, the =n command in the FSEDIT procedure).

The control or field cannot be an element of an array. To report this information for an array element, use FIELD instead.

FRAME entry controls can also use the _isDisplayed or _isHidden method.

Example

Test whether the SALARY field is displayed on the current screen of an FSEDIT application. If not, issue an FSEDIT scrolling command to display the screen that contains the field:

if (displayed(salary)=0) then
   call execcmd('=salary');