The layout page is primarily designed to be the top-level page of the web UI. The idea is to set up a layout page as the navigation URL for the browser, so the layout page fills the browser window. You then arrange your functional windows within the layout page - a command window, a status line window, etc. This arrangement is similar to banner window in HTML TADS, but IFRAMEs are considerably more flexible; for example, they don't have to tile the main window, and you can size them in the full range of units CSS provides.
Layout windows aren't limited to the top level, though. Since you can put any HTML page within an IFRAME, you can put another layout window within an IFRAME, to further subdivide the space inside the IFRAME.
WebLayoutWindow : WebWindow
If the window already exists, this updates the window with the new layout settings.
'win' is a WebWindow object that will be displayed within the IFRAME. This method automatically loads the HTML resource from the WebWindow into the new IFRAME.
'name' is the name of the window. Each window within a layout must have a distinct name. This allows you to refer to the dimensions of other windows in 'pos' parameters. The name should be alphanumeric.
123 - a number, representing a number of pixels on the display
5em - 5 'em' units, relative to the main BODY font in the window
5en - 5 'en' units in the main BODY font
5ex - 5 'ex' units in the main BODY font
window.width - the width in pixels of the enclosing window
window.height - the height in pixels of the enclosing window
50% - percentage of the width or height of the enclosing window
content.width - the width in pixels of the contents of the frame
content.height - the height in pixels of the contents of the frame
x.left - horizontal coordinate of leftmost edge of window 'x'
x.right - horizontal coordinate of rightmost edge of window 'x'
x.top - vertical coordinate of top edge of window 'x'
x.bottom - vertical coordinate of bottom edge of window 'x'
x.width - width in pixels of window 'x'
x.height - height in pixels of window 'x'
The "window" dimensions refer to the *enclosing* window. If this layout window is the main page of the UI, this is simply the browser window itself. For a layout window nested within another frame, this is the enclosing frame.
Percentage units apply to the enclosing window. When a percentage is used in the 'left' or 'width' slot, it applies to the width of the enclosing window; in the 'top' or 'height' slot, it applies to the height.
The "content" dimensions refer to the contents of the frame we're creating. This is the size of the contents as actually laid out in the browser.
"x.left" and so on refer to the dimensions of other frames *within this same layout window*. 'x' is the name of another window within the same layout, as specified by the 'name' argument given when the window was created.