Programming Guide - Actian

How You Can Invoke FramesIf the object is associated with a field in the child frame, OpenROAD does notdisplay the new value in the field until the current event block in the parentframe completes. To cause the value to be updated before the end of theevent block, use the Flush method immediately after the openframestatement. For more information about the Flush method, see the LanguageReference Guide online help.Note: The openframe statement does not include a byref option. This isavailable for the callframe statement only. For more information, see How YouCan Transfer Control to a New Frame: Callframe Statement (see page 100).How You Can Communicate Between Open FramesBecause the calling frame remains open when a called frame is executed by anopenframe statement, it is important that the calling frame be able tocommunicate with the child frame. Consequently, the openframe statementreturns a reference variable of type FrameExec to the calling frame. For thecalling frame to use this value, you must capture the FrameExec object of thechild frame in a variable. The syntax is:[FrameExec_var =] openframe framename ([parameterlist])The calling frame can also use the returned FrameExec object with theSendUserEvent method to communicate with the child frame. For moreinformation, see Inter-Frame Communication Techniques (see page 333).How You Can Pass Control While Closing the Parent: Gotoframe StatementThe gotoframe statement closes the calling frame and opens a new frame thatreplaces the calling frame. OpenROAD transfers control to the called frame,and the user cannot return to the calling frame.Because the gotoframe statement closes the calling frame and therefore doesnot return to it, it has no return value. You should use this statement whenyou do not want users to return to the calling frame; for example, when youwant an interim frame that the user fills out between using one frame andanother.104 Programming Guide