Web Connection User Guide : Web Connection category : Visual Parts : Frame Set Page
Frame Set Page
Use the Frame Set Page part to create a web page that uses frames. In HTML, a frameset is specified instead of the body of a page, then the body element appears in the "noframes" area of a frameset page. A frameset contains a set of frames and additional framesets. A frame contains the URL of a page. If your client's browser does not support frames, the text in the frameset's "noframes" area is displayed instead of the set of frames.
The Frame Set Page part in VA Smalltalk is a subclass of page, and implements the page as a frameset. The contents of the page are the contents of the "noframes" area of the frameset. Anything you drop on a frameset in VA Smalltalk will only appear in a browser that doesn't support frames.
The contents of the frames are set using the properties of the Frame Set Page part.
To add a Frame Set Page part, delete the page, then select the Web Connection Category ( Web Connection Category), then the Frame Set Page part ( Frame Set Page icon). You can also add the part using the Add Part dialog and specifying the class name, AbtHtmlFrameSetPage.
If you are using session data, initialize the session data on the Frame Set Page part rather than on a page part. Note that the session data value is initialized on the Frame Set Page part. This is important! If you do not set the session data on the frameset part, but then use session data on a page part used in a frame, users will be able to reset their session data by refreshing the frame with the refresh or reload button on the web browser. Furthermore, if the session data is not established on the frameset part, each frame may end up using its own session data rather than sharing a single session data value. These effects are caused by the way browsers refresh frames in framesets. To avoid problems with session data, initialize the session data on the frameset part even if it is not needed until later.
To set up the contents of the frames in a frameset, we open its settings and change the frameSet property. The frameSet property describes a single frame, with values such as columns and columnUnits or rows and rowUnits (one or the other), and a collection of frames in that frameset. A frame can either have a URL pointing to a part or page, or it can have another nested frameset. If an item in the frames collection is a frameset, then the frame information about that item is ignored. To assign initial values to a frameset property in the property prompter, uncheck the "Set value to nil" checkbox. You will have to resize the frames property prompter to see all the information about each frame.
Frame Set Page Properties
The Frame Set Page part has the following properties:
The Page part has the following properties:
• scripts
• title
 
activeLinkColor
Use the activeLinkColor property to specify the color of active links.
backgroundColor
Use the backgroundColor property to set the background color of the page.
backgroundImage
Use the backgroundImage property to specify the image you want to use at run time for the background, or wallpaper, of the page. You can specify any image file that is supported by the Web browser used at run time, provided the image is in a location accessible to the browser.
This property is equivalent to the background attribute of the HTML body element.
backgroundImageFile
Use the backgroundImageFile property to specify the file containing the graphic you want to use for the page background at edit time. You can use any graphic file type supported by VA Smalltalk.
Note:
The backgroundImageFile property affects only the appearance of the page in the Composition Editor at edit time. It has no effect on the generated HTML and will not cause a graphic to appear in Web browsers at run time. In order to display a runtime graphic, you must specify a location for a graphic using the backgroundImage property.
eventHandlers
Use the eventHandlers property to define any event handlers for this part. Event handlers provide the ability to detect and react to events that occur while an HtmlPage is loaded in a Web browser. An example of an event handler is mouse over, where you can specify when the mouse moves over an HTML element, something happens, usually a JavaScript is executed..
extraAttributes
Use the extraAttributes property to specify any additional HTML attributes that you want included in the HTML tagging generated by the part. You can use this property to include HTML attributes that are not directly supported by VA Smalltalk.
frameSet
Use the frameSet property to specify all of the frames and framesets used in the page.
generateBodyElement
Use the generateBodyElement property to specify whether you want to includes the body element within the HTML generated by the page. The body element delimits the actual content of the page, separating it from the header information such as the title element.
linkColor
Use the linkColor property to specify the color of linked text on the page.
This property is equivalent to the link attribute of the HTML body element.
metaTagArea
Use the metaTagArea to specify content for and include a meta tag in the header of your HTML Page or Frame Set Page. The HTML meta tag is used to specify keywords or descriptions that are used by some search engines. These tags allow you to exert some level of control over how your site is represented by the search engines that read meta tag data.
partName
In the Part name field, type the name you want to use to describe the part. For non-visual parts, this text appears under the icon for the part on the free-form surface.
The name of the part can consist of alphanumeric characters, and must be unique from all other parts on the layout surface.
This field is optional. If you do not specify a part name, VA Smalltalk generates a unique name based on the class name of the part.
scripts
Use the scripts property to specify code to be used on the HtmlPage. The script is included in the header of the generated HTML page.
styleSheets
Use the styleSheets property to specify styles to be included in the header of the generated HTML page.
textColor
Use the textColor property to specify the color of the text on the page.
This property is equivalent to the text attribute of the HTML body element.
title
Use the title property to specify the title of the page. The title appears in the title bar of the Web browser at run time.
visitedLinkColor
Use the visitedLinkColor property to specify the text color of links the user has previously selected.
This attribute is equivalent to the vlink attribute of the HTML body tag.
Last modified date: 06/24/2018