_CFRAME_

_CFRAME_

Contains the identifier of the FRAME entry that is currently executing

Category: System Variable

Details
Example
See Also

Details

_CFRAME_ is a system variable that is provided automatically for FRAME entries. _CFRAME_ has a valid value only when a FRAME entry's SCL code is running or when a FRAME entry or component method is running.

Example

Suppose the entry FIRST.FRAME contains an icon. The icon's _select method is defined to run 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('The 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 "The 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.

See Also

_FRAME_

Chapter Contents
Previous
Next
Top of Page