includeFrame Function

Use

Purpose

Converts multi-frame applications to single pages.

Syntax

includeFrame(~framename=<frame name>)

Parameters

Parameter	Meaning
`~framename`	Name of frame to be included.

Example

You could implement a simple two-frame application with the <frameset> ... </frameset> tag as follows:

<frameset rows=80,* FRAMEBORDER=0 BORDER=0 FRAMESPACING=0>
<frame name="FRAME_1" SRC="`wgateURL(~FrameName="FRAME_1")`" scrolling="no">
<frame name="FRAME_2" SRC="`wgateURL(~FrameName="FRAME_2")`">
</frameset>

To convert this application to a single frame HTML page, remove the <frameset> ... </frameset> structure and use the includeFrame function with the <table> ... </table> tag instead:

<table>
 <tr><td>`includeFrame(~framename="FRAME_1")`</td></tr>
 <tr><td>`includeFrame(~framename="FRAME_2")`</td></tr>
</table>

When you execute this code, FRAME_1 and FRAME_2 are still displayed in 2 rows, but as a single page rather than two separate frames.