Programming Guide - Actian

How You Can Invoke Frames• Prompt statementA frame executing a prompt statement, directly or indirectly, is alwaysblocked.• WaitFor method callA frame that executes a WaitFor method is blocked until the methodcompletes.Pop-up FramesThe openframe, callframe, and gotoframe statements enable you to open aframe as a pop-up frame. Pop-up frames are closely connected to the callingframe, always displaying on a layer above it and never iconifyingindependently of it (the pop-up is always iconified whenever the calling frameis iconified).Pop-up frames are useful when you want to force the user to provideinformation or acknowledge a warning prior to continuing the action of thecalling frame. Because the pop-up can never be hidden by the calling frame, itserves the purpose of gathering information better than an ordinary calledframe (which could get lost behind the calling frame).In addition to enabling you to define your own frames as pop-ups, OpenROADprovides four types of predefined pop-up frames. This section discusses userspecifiedand predefined pop-up frames.How You Can Create Your Own Pop-up FramesYou specify a frame as pop-up by setting IsPopup to TRUE in the optionlistwhen you invoke the frame's Property Inspector.User-specified pop-up frames can be invoked to display on top of active as wellas inactive parent frames. To access an active parent frame that has beencovered by a child pop-up, the user must move it adjacent to the pop-up. Theparent can never overlay the pop-up, which prevents the pop-up from beinghidden by the parent. You can specify the usual frame attributes for a pop-upframe, such as resizability.Pop-up frames must be called by a parent frame or procedure. Starting framescannot be pop-ups. If a pop-up is specified as the starting frame for anapplication, it is treated as a standard frame at runtime, as is a pop-up framerun from the Go menu of the Frame Editor.If a pop-up frame is invoked by an object that is not itself viewable, such as aprocedure or ghost frame, it displays in relation to the closest viewableancestor (for example, the frame that called the procedure).108 Programming Guide