SAS Component Language Dictionary

_FRAME_

Contains the identifier of either the FRAME entry that contains the control or the FRAME entry that is being used as a method

Category:

System Variable

Details
Example
See Also

Details

_FRAME_ is a system variable that is provided automatically by the FRAME entry in SAS/AF software. A space is automatically created for it in the SCL data vector (SDV). _FRAME_ contains the identifier of the FRAME entry that contains a component. Otherwise, it contains the identifier of the FRAME that is running.

You can use this variable to send methods to a FRAME entry from a control's method. For example, a control method can send a _refresh method to the FRAME entry, causing the FRAME entry to refresh its display.

Example

Suppose the entry FIRST.FRAME contains an icon. The icon's _select method is defined to run the SAS/AF FRAME entry SECOND.FRAME, which contains the following program:

INIT:
      /* Send a method to the current FRAME */
   _CFRAME_._setMsg('Running the Select method');
return;
TERM:
      /* Send a method to the FRAME that */
      /* contains the icon               */
   _FRAME_._setMsg('Select method has finished.');
return;

When FIRST.FRAME displays and a user selects the icon, SECOND.FRAME displays with the message "Running the Select method". After the user ends from SECOND.FRAME, FIRST.FRAME displays the message "Select method has finished." This is accomplished by sending the _setMsg method to _CFRAME_ (the FRAME entry that is currently running) in the INIT section and by sending _setMsg to _FRAME_ (the FRAME entry that contains the icon) in the TERM section.