Background Image (BackImage)
Image used as background for the application window, form, or entity. This property can be set in ProcScript.
backimage=
@FileName | ^GlyphName
Usage
Dynamic? | Yes for entities, forms, and startup
shells No for area frames |
Supported in Grid? | No |
Dependencies: | See Image Properties |
Description
The specified image can be a glyph or an image file on the file system.
The Background Image property is dynamic and can be specified in ProcScript as BackImage using the following ProcScript instructions:
$windowproperties
—sets the background image for the form.$applproperties
—sets the background image for the application shell$entityproperties
—sets the background image for an entity.
You can also specify a default background image for entities, application shells, and forms using the DEFENTITY, SHELL, and WINDOW settings in the .ini file.
- DefEntity—for the default entity widget
- Shell—for application shells, and forms
- Window—for form components
Although it is possible to specify an absolute path to an image, it is preferable to specify a relative path using the IMAGES initialization setting.
Note: The BackImage property
replaces the image window property, which was not dynamic. Existing forms that
have the image property set continue to work, but if the BackImage
property is
set, it takes precedence over image
.
Area Frames
You can specify the background image for area frames using entries in the [areaframes] section of the .ini. it is not possible to fo this in the Uniface IDE. For more information, see [areaframes].
Combining Background Image and Color
If both a background image and a background color are specified, the background image may obscure the background color. Since it possible to specify these properties in several places, you may get unexpected results. For example, if a default background image is specified for form windows in the .ini file:
[APPLICATION] window=uwindow(backimage=^I_OK)
and the Background Color is set in ProcScript:
$windowproperties()="backcolor=blue"
the complete property setting becomes:
backimage=^I_OK;backcolor=blue
In this case, the background color will not be visible.
Image Properties
The following properties can be applied to the image specified by Background Image.