Image Settings
- 2 minutes to read
This topic describes various settings related to the representation of Image dashboard items.
Image Alignment
To specify how the image is aligned within the dashboard item, use the Alignment group in the Ribbon’s Design tab of the Image Tools (or Bound Image Tools) contextual tab set.
To do the same thing in code, specify the vertical and horizontal alignment separately. Use the ImageDashboardItem.HorizontalAlignment and ImageDashboardItem.VerticalAlignment properties to do this.
Image Size Mode
You can specify the image size mode that defines how the image fits within the dashboard item.
To do this, use the Size Mode group in the Ribbon’s Design tab.
The following table illustrates each size mode in two cases: when the image is smaller than the dashboard item, and vice versa.
| Size Mode | Image Smaller than Dashboard Item | Image Larger than Dashboard Item | Description |
|---|---|---|---|
| Clip |  |
 |
The image is clipped if it is larger than the ImageDashboardItem. |
| Stretch |  |
 |
The image within the ImageDashboardItem is stretched or shrunk to fit the size of the ImageDashboardItem. |
| Squeeze | |
 |
If the dimensions of the ImageDashboardItem exceed those of the image it contains, the image is shown full-size. Otherwise, the image is resized to fit the dimensions of the ImageDashboardItem. |
| Zoom |  |
|
The image is sized proportionally (without clipping), so that it best fits the ImageDashboardItem. If the aspect ratio of the ImageDashboardItem is the same as the aspect ratio of the image, it will be resized to fit into the ImageDashboardItem while maintaining its aspect ratio. Otherwise, the closest fitting side of the image (either the height or the width) will be sized to fit the dashboard item, and the remaining side (height or width) will be sized proportionally (leaving empty space). |
To specify the size mode in code, use the ImageDashboardItem.SizeMode property.