Definition of Multi Frame Pages

#### Search Results

Search

# Definition of Multi Frame Pages

The definition of multi frame pages is done with the Layout Painter. When you create a new layout, a dialog appears in which you select a template. To create a multi frame page, you have to select the "Multi Frame Page" template. The Layout Painter will open just as usual, but instead of having the PAGE control as the highest control, you now see the control MFPAGE. You can reach a number of controls that are related to multi frame page management.

The following controls are "normal frame controls" (they are described below):

- MFPAGE - the top element of multi frame pages.

- MFCISFRAME - a frame in which an Application Designer HTML page is loaded.

- MFHTMLFRAME - a frame in which a normal HTML page is loaded.

- MFFRAMESET - an area that can be subdivided into frames itself.

The following controls are "workplace controls" (they are described in the section Application Designer Workplace Framework. The Application Designer workplace is based on these controls.

- MFWPFUNCTIONS

- MFWPACTIVEFUNCTIONS

- MFWPCONTENT

This document covers the following topics:

- MFPAGE

- MFCISFRAME

- MFHTMLFRAME

- MFFRAMESET

## MFPAGE

The MFPAGE is the top node of every multi frame page. It can be subdivided into frames or framesets.

Basic
separation | Specifies how the corresponding internally used frameset is subdivided: choose "rows" for subdividing into rows, "cols" for subdividing into columns. | Obligatory | rows cols
sizing | Defines the size of the contained sub-frames. If you have three sub-frames to show up inside the page then you might specify "200,200,*" to specify how the height (if SEPARATION is "rows") or the width (if SEPARATION is "cols") is distributed among the frames. You can specify per frame either a pixel value or a "*". | Obligatory |
comment | Comment without any effect on rendering and behaviour. The comment is shown in the layout editor's tree view. | Optional |
Appearance
border | Space between frames contained in the frameset that is internally built up. | Optional | 1 2 3 int-value
bordercolor | Sets the border color of the frame set. | Optional | #FF0000 #00FF00 #0000FF #FFFFFF #808080 #000000
frameborder | Defines if to display a border around the contained frames. Valid values are "true" or "false". | Optional | true false
framespacing | Defines the amount of additional space between the frames. Value is a pixel value. | Optional | 1 2 3 int-value
framesetstyle | Style passed to the HTML-frameset definition that is internally generated. | Optional | background-color: #FF0000 color: #0000FF font-weight: bold

## MFCISFRAME

The MFCISFRAME represents a frame in which an Application Designer page is shown. The name of the page is passed as a parameter.

Basic
target | Id of the frame. Must be unique inside the frameset page. Must only contain alphanumeric characters. The id is important! CIS offers certain methods inside the Model-class that allow an adapter to start operations for a certain frame (e.g. openeCIPageInFrame(...)). As part of the parameters of these methods a target-id is passed. The target-id is exactly the id you specify with the TARGET property. | Obligatory |
cisurl | URL of the page to be shown inside. Use /project/page.html as syntax, e.g. "/HTMLBasedGUI/empty.html". Do NOT use only page.html believing that you do not have to specify the project because the multi frame page runs in the same project than the page you want to open - you ALWAYS have to specify the project! | Obligatory |
comment | Comment without any effect on rendering and behaviour. The comment is shown in the layout editor's tree view. | Optional |
Appearance
resizable | Decision if the user is able to resize the frame. This property must be in synch with the definition in the "neighbour frames". If the neighbour frames do not support resizing then it will not be offered to the user as consequence. Valid values are "true" and "false". Default is "true". | Optional | true false
withborder | Boolean value defining if the frame has a border on its own. Default is "false". | Optional | true false
framestyle | Style that is passed to the HTML-FRAME definition that is internally generated. | Optional | background-color: #FF0000 color: #0000FF font-weight: bold
bordercolor | Sets the border color of the frame set. | Optional | #FF0000 #00FF00 #0000FF #FFFFFF #808080 #000000
marginheight | Defines top and bottom margin height. Value is a pixel value. Default is "0". | Optional | 1 2 3 int-value
marginwidth | Defines left and right margin width. Value is a pixel value. Default is "0". | Optional | 1 2 3 int-value
withownborder | Flag that indicates if started pages show an own border. Default is false. | Optional | true false
Unload Behaviour
unloadbehaviour | Reaction that CIS should take if the page inside the frame is closed. Possible values are "NOTHING" for doing nothing and "REMOVESESSION" for removing the session on server side. Do not define this property just "by accident" but leave it to the default ("NOTHING"). You only switch to "REMOVESESSION" if you want that the server side session is destroyed when leaving the page. This is the case if you have one page that clearly indicates the closing of a session at the point of time when the page is closed. | Optional | NOTHING REMOVESESSION

Applications can change the page that is shown inside the MFCISFRAME by using the method `Adapter.openCISPageInTarget(...)`.

## MFHTMLFRAME

The MFHTMLFRAME represents a frame in which a normal HTML page is shown. This page can be a static HTML page or any URL - e.g. a URL referring to a certain JSP page.

Basic
target | Id of the frame. Must be unique inside the frameset page. Must only contain alphanumeric characters. The id is important! CIS offers certain methods inside the Model-class that allow an adapter to start operations for a certain frame (e.g. openeCIPageInFrame(...)). As part of the parameters of these methods a target-id is passed. The target-id is exactly the id you specify with the TARGET property. | Obligatory |
url | URL to be opened inside the frame. The URL can be defined relative to the multi frame page or can be defined in an absolute way.. Example: You can define "../HTMLBasedGUI/workplace/header2.html" - or "http://www.softwareag.com". | Obligatory |
comment | Comment without any effect on rendering and behaviour. The comment is shown in the layout editor's tree view. | Optional |
Appearance
resizable | Decision if the user is able to resize the frame. This property must be in synch with the definition in the "neighbour frames". If the neighbour frames do not support resizing then it will not be offered to the user as consequence. Valid values are "true" and "false". Default is "true". | Optional | true false
withborder | Boolean value defining if the frame has a border on its own. Default is "false". | Optional | true false
scrolling | Boolean that indicates whether the frame can be scrolled. Default is true. | Optional | true false
framestyle | Style that is passed to the HTML-FRAME definition that is internally generated. | Optional | background-color: #FF0000 color: #0000FF font-weight: bold
bordercolor | Sets the border color of the frame set. | Optional | #FF0000 #00FF00 #0000FF #FFFFFF #808080 #000000
marginheight | Defines top and bottom margin height. Value is a pixel value. Default is "0". | Optional | 1 2 3 int-value
marginwidth | Defines left and right margin width. Value is a pixel value. Default is "0". | Optional | 1 2 3 int-value

## MFFRAMESET

The MFFRAMESET represents a frame that is internally again divided into frames. The MFFRAMESET definition decides whether to divide into rows or columns, and how to size the inner frames.

Basic
target | Id of the frame. Must be unique inside the frameset page. Must only contain alphanumeric characters. The id is important! CIS offers certain methods inside the Model-class that allow an adapter to start operations for a certain frame (e.g. openeCIPageInFrame(...)). As part of the parameters of these methods a target-id is passed. The target-id is exactly the id you specify with the TARGET property. | Obligatory |
separation | Specifies how the corresponding internally used frameset is subdivided: choose "rows" for subdividing into rows, "cols" for subdividing into columns. | Obligatory | rows cols
sizing | Defines the size of the contained sub-frames. If you have three sub-frames to show up inside the page then you might specify "200,200,*" to specify how the height (if SEPARATION is "rows") or the width (if SEPARATION is "cols") is distributed among the frames. You can specify per frame either a pixel value or a "*". | Obligatory |
comment | Comment without any effect on rendering and behaviour. The comment is shown in the layout editor's tree view. | Optional |
Appearance
border | Space between frames contained in the frameset that is internally built up. | Optional | 1 2 3 int-value
bordercolor | Sets the border color of the frame set. | Optional | #FF0000 #00FF00 #0000FF #FFFFFF #808080 #000000
frameborder | Defines if to display a border around the contained frames. Valid values are "true" or "false". | Optional | true false
framespacing | Defines the amount of additional space between the frames. Value is a pixel value. | Optional | 1 2 3 int-value
framesetstyle | Style passed to the HTML-frameset definition that is internally generated. | Optional | background-color: #FF0000 color: #0000FF font-weight: bold

### On this page

- MFPAGE
- MFCISFRAME
- MFHTMLFRAME
- MFFRAMESET