Workbench User Guide : Generating Frames from Predefined Templates : The mastdetl Templates : The explosion Template
 
Share this page          
The explosion Template
The explosion frame template is used to generate a frame that displays in greater detail a single row from the table field of a frame generated from the table_field, master_detail, or detail frame templates.
Typically, for queries with a large number of result columns, creating a table field that represents all of them is inconvenient. A better solution is to have a select number of critical columns reflected in the table field, and use an explosion frame to display the values of all the other columns for the current row of the table field.
Although similar in appearance to frames generated from the simple_field frame template, explosion frames do not perform queries and are not meant to run stand-alone. They depend on a parent table field, master-detail, or detail frame to provide them with the data to be displayed.
Note:  Explosion frames cannot call other frames generated from any of the other four mastdetl frame templates.
Create an Explosion Frame
You can create an explosion frame using the explosion frame template.
To create a frame using the explosion frame template
1. On the Develop tab, select the application in which you want to create the frame in the Applications portlet, and then select the header bar of the Components portlet to make it active.
2. Click File, New, User Frame.
The Create User Frame dialog appears.
3. Enter the component name in the Name field (for example, My_Explosion).
4. (Optional) Enter a comment for the component in the Remark field.
5. Select mastdetl from the Application list and the explosion template from the Template list.
6. Click Create.
The Select a Parent Frame dialog appears.
7. Specify the explosion frame's parent frame by selecting an application and a frame from the Application and Frame list fields, respectively, and then click OK.
The explosion frame is created and displayed in the Frame Editor.
8. (Optional) Specify the frame's properties using the Property Inspector. For example, set the IsResizeable property to TRUE.
For more information about using the Property Inspector, see Set Frame Properties.
Use an Explosion Frame
The generated explosion field frame provides a set of VCR buttons to navigate through each selected row, with its values updated automatically in the matrix of fields.
Because explosion frames are not meant to perform queries or run stand-alone, they are generally run from a parent table field frame, master-detail frame, or detail frame.
To see the detail frame in operation
1. In the Frame Editor, open the parent frame with which it is associated.
2. Click Debug, Go on the floating menu bar.
3. Highlight a row in the detail table, and then click the Open Row button to display the explosion frame.
Note:  The VCR buttons are not present if the parent is a master-detail frame running in asynchronous mode.
The Field menu provides commands to prevent a user from changing the values in one or more fields. A field cannot be edited by selecting a field and clicking Field, Freeze. The Unfreeze and Unfreeze All commands on the Field menu let you disable this feature for individual fields or all fields.