AX1259

Setting the background color or image for an Axiom form

By default, the background color of the form web page is determined by the skin assigned to the form. If desired, you can use the following form-level settings to change this display:

Background Color
Background Image

The background color and image are not mutually exclusive. Any area not covered by the background image will display using the background color (whether it is explicitly set or determined by the skin).

It is also possible to configure a Panel component so that it extends to fill the entire page, and therefore effectively defines the background color of the form (for example, when using the Titled Panel component). In this case the background settings for the form still apply, but since the panel covers the entire page, they will not be seen (unless the panel is translucent).

Setting the background color

You can assign a background color to a form. The background color fills the entire tab or window where the form is being displayed.

To specify a background color for a form:

From the top of the Form Assistant task pane or the Form Designer dialog, click Edit form properties.
In the Form Properties dialog, edit the Background Color by selecting a color.

Click the [...] button to open the Choose Color dialog. You can select from the colors displayed at the top of the dialog, or you can enter a valid RGB or hexadecimal color code (such as #00FFFF for Aqua). Click OK to use the specified color.

TIP: You can also change the background color by editing the Background Color field at the top of the Form Control Sheet. If you are modifying the Form Control Sheet directly, then you must use a hexadecimal code. For an example list of colors and hexadecimal codes, see: http://www.w3.org/TR/css3-color/#svg-color (external link).

Setting the background image

You can display an image in the background of an Axiom form.

To specify a background image for a form:

From the top of the Form Assistant task pane or the Form Designer dialog, click Edit form properties.

In the Form Properties dialog, edit the following settings:

Item Description

Background Image

Item	Description
Background Image	Specifies the image file to use for the background image. Click the [...] button to browse to the image within the Reports Library. If the image is not already saved in the Reports Library, you can right-click a folder and select Import to import the image (if you have the appropriate rights to do so). The image must be in PNG or JPG format. NOTES: End users must have permission to the image file in order to see it rendered. It is recommended to create a dedicated Images folder in the Reports Library and store all images in this location. You can grant access to this folder using the Everyone role, or you can create subfolders and grant access to users and roles as needed. The next time you open this file after saving, the path to the image will be automatically converted into a system-managed document shortcut (you can tell the difference by the presence of a `_tid` parameter on the end of the shortcut). This is to make the file reference "repairable" in cases where the file is renamed or moved. Note that if the path is a result of a formula instead of directly within the cell, then the conversion will not occur and the file reference will not be repairable.
Image Repeat	The repeat behavior of the image. Select one of the following: Both (default): The image repeats in a tiled pattern both horizontally and vertically, covering the entire form background. Horizontal: The image repeats in a tiled pattern horizontally, starting at the top left corner of the form and extending all the way across. Vertical: The image repeats in a tiled pattern vertically, starting at the top left corner of the form and extending all the way down. None: The image is not repeated. The image displays in the top left corner of the form.

Specifies the image file to use for the background image.

Click the [...] button to browse to the image within the Reports Library. If the image is not already saved in the Reports Library, you can right-click a folder and select Import to import the image (if you have the appropriate rights to do so). The image must be in PNG or JPG format.

NOTES:

End users must have permission to the image file in order to see it rendered. It is recommended to create a dedicated Images folder in the Reports Library and store all images in this location. You can grant access to this folder using the Everyone role, or you can create subfolders and grant access to users and roles as needed.
The next time you open this file after saving, the path to the image will be automatically converted into a system-managed document shortcut (you can tell the difference by the presence of a _tid parameter on the end of the shortcut). This is to make the file reference "repairable" in cases where the file is renamed or moved. Note that if the path is a result of a formula instead of directly within the cell, then the conversion will not occur and the file reference will not be repairable.

Image Repeat

The repeat behavior of the image. Select one of the following:

Both (default): The image repeats in a tiled pattern both horizontally and vertically, covering the entire form background.
Horizontal: The image repeats in a tiled pattern horizontally, starting at the top left corner of the form and extending all the way across.
Vertical: The image repeats in a tiled pattern vertically, starting at the top left corner of the form and extending all the way down.
None: The image is not repeated. The image displays in the top left corner of the form.

TIP: You can also change the background image by editing the Background Image Path and Background Image Repeat fields at the top of the Form Control Sheet. If you are specifying the path manually, use the full path in the Axiom file system.