A Page Area is a rectangular area drawn on a page that can be used to accommodate elements supported by the Freeform Report Designer. Once areas are added to a template, their positions and sizes can be modified as desired, allowing easier and more flexible control over the overall layout of the template. Areas are supported in PDF output only.
A page area has two modes: Container for Elements and Non-container. These two modes have different element wrapping mechanism. Detailed information is provided in a later section.
Note:
Although Freeform Report Designer supports both HTML and PDF as output types, some elements and features are not supported in both formats. See Element Restrictions for Output Types on page 417 for detail information.
Page areas can be created using the Master Layout view which can be accessed using the View menu. If the master layout view is selected on a page that does not have page areas, the initial view is blank.
To enter area inserting mode, select one of the following options:
• Select the menu option FormatÆInsert Area (PDF Only)
• Click the Insert Area (PDF Only) button, as shown below.
|
|
Figure 296: Insert Area (PDF Only) Button |
To add an area, use the mouse to draw the area at the desired position and size. A sequence number is placed at the top-left corner of each area. The sequence number determines the order in which the areas are used in the document flow. If the new area is added when no area on the page is selected, the new area becomes the last area on the page. Otherwise, it is inserted before the selected area in the sequence.
The ordering can be changed after the areas have been created. To enter area ordering mode, select one of the following options:
• Select the menu option FormatÆOrder Area (PDF Only)
• Click the Order Areas (PDF Only) button, as shown below.
|
|
Figure 297: Order Areas (PDF Only) Button |
The cursor is changed to a hand cursor. To change the sequencing of the areas, click each area in the desired order. Once every area has been clicked, Freeform Report Designer returns to its inserting mode.
Page areas are available in two modes: Container and Non-container. By default, newly added areas are set to the Non-container type. Changing the area mode can be done via the Page Properties dialog, which is started by selecting the menu option FileÆPage Setup. This section mainly discusses the different behaviors of the two modes.
For page areas set to the Non-container mode, their sizes, although can be adjusted on the Master Layout view, are not enlarged automatically according to the size of the added elements. Elements flow from the first area to the last area on the page, and when the contents overflow the last area, an additional page appears with the same areas created and the elements flow again from the first to the last area.
Non-container page areas are not supported in HTML outputs.
When areas are set to Container, the contents of the areas do not flow from one area to the next; instead, each area has totally separate element flow, and when their contents do not fit the size of the areas, the contents are partially printed and any leftover contents are discarded. Furthermore, the areas are not repeated across pages.
Adding elements to areas can be done in a similar way as adding elements to a page. First, select the area on the page layout view. Click one of the element buttons and the Freeform Report designer enters element insertion mode, then add the element in the same way as described in the previous sections.
To open the Area Properties window, select the master layout view and double-click inside the area. The Area Properties window is shown below.
|
|
Figure 298: Area Properties Window |
The properties in this window are organized into five sections: Position, Size, Background, Border, and Padding Space. These sections are described below.
The Position section specifies the position of the area on the page in relation to other areas. The X” and Y” values represent the distance in inches from the top left printable edge of the template. To set a relative Y” value, select Relative, specify an area sequence number, and enter the value in inches under which the area is placed.
The Size values set the width and height of the area in inches.
For the Width value, there are two radio buttons.
• When Fixed is selected, enter the desired width value in inches;
• When Adjust to Fit Content (HTML Only) is selected, this sets the area width to automatically fit the content.
For the Height value, there are three radio buttons.
• When Fixed is selected, enter the desired height value in inches;
• When Adjust to Fit Content is selected, this sets the area height to automatically fit the content.
• When Auto Scroll (HTML Only) is selected, scrolling bars will appear horizontally and/or vertically when the content of the area overflows the area height, which is the value specified in the Fixed field. This option applies to HTML output only.
Note:
When you are adding Lightweight charts into areas, be aware that the sizes of LCharts are in pixels, but Freeform Report Designer uses inches to define the sizes.
The Color radio button is selected by default. Select a background color by clicking the down-arrow button on the right and select the desired color, or clicking Others and selecting a color from the Color Selector. Refer to Selecting Colors within Property Windows on page 496 for more information.
In the Border area, select a border type from the drop-down list and select a border color. For a description of selecting colors, see Selecting Colors within Property Windows on page 496. Area Border Line styles other than a single line are supported in PDF output only.
The Padding Space area is used to determine how much blank space, or padding, is between the data and the edge of the area. The values are entered in points.
To add an Area Break to the template, select the menu option InsertÆArea Break.
An area break serves a similar function as the page break. However, instead of advancing the printing to the next page, an area break moves the flow to the next area on the page. If the area break is in the last area, it functions in the same way as a page break. Adding breaks to page areas can precisely place the area elements into intended areas.
Area break is supported in PDF output only.