Image (deprecated)

Edit online
Draft comment:
This topic only applies to BAW, and is located in the BAW repository. Last updated on 2025-03-13 12:15
Image creates an area that contains an image from a web file or URL source.
When you drop an Image view onto the layout of a coach or view, it displays a default image. When you set the binding or the Image configuration property to point to an image file, the view displays the image when you run the human service. The Image configuration property takes precedence over the binding if both are set.

Restrictions and limitations

Restrictions
In the Positioning properties, you must use pixels as the unit to set the height and width of an image. You cannot use a percentage value. For example, you can set an image to be 300px wide and 200px high but you cannot set it to be 80% wide and 25% high.

Data binding

Set the data binding for the view in the General properties tab.
Table 1. Data binding for Image
Binding description Data type
Contains the location of the image to be displayed by the view. Typically, you bind the view to an image stored as a web file and the URL is a relative path to retrieve the file from the server. When you bind the view to a variable, the variable must contain a URL that is resolvable on the server.
Tip: Absolute URLs are acceptable, however, relative URLs are generally a better choice in order to avoid potential security warnings.

You can use the binding or the Image configuration property to specify the image. If you use the Image configuration property, the binding is ignored. To set a different image for different screen sizes, you must use the Image configuration property.

 URL

Theme definitions

The design mode of the theme editor contains a simulation of this view. If you hover over the simulation, it lists the theme definitions that determine the appearance of the view. For information on the theme editor, see Creating themes.

Configuration properties

Set or modify view configuration in the Configuration properties tab.
Screen size
A configuration property that has the Screen Sizes icon The Screen Sizes icon beside the property name can have different values for each screen size. If you do not set a value, the screen size inherits the value of the next larger screen size as its default value.
Table 2. Configuration properties for Image
Configuration property Description Data type
Image screen sizes icon Contains the location of the image that the view displays. Typically, you set the view to an image stored as a web file and the URL is a relative path to retrieve the file from the server. When you set the view to a variable, the variable must contain a URL that is resolvable on the server.
Tip: Absolute URLs are acceptable, however, relative URLs are generally a better choice in order to avoid potential security warnings.

If you set the Image configuration property, the binding is ignored.

 URL
Alternate text Describe the image to make it accessible for users and technologies that cannot see the image. String
Caption screen sizes icon Provide a caption for the image String
Caption position screen sizes icon Set whether the caption is above or below the image.

The default value is Above.

 CaptionVerticalPositionSelection
Caption alignment screen sizes icon Set whether the caption aligns to the left side or right side of the image, or is centered.

The default value is left.

 CaptionHorizontalPositionSelection