BoundImageDashboardItem.ImageDimension Property
Gets or sets the dimension that provides data for the BoundImageDashboardItem.
Namespace: DevExpress.DashboardCommon
Assembly: DevExpress.Dashboard.v20.1.Core.dll
NuGet Packages: DevExpress.Dashboard.Core, DevExpress.WindowsDesktop.Dashboard.Core
Declaration
Property Value
Type | Default | Description |
---|---|---|
Dimension | *null* | A Dimension object that provides data for the BoundImageDashboardItem. |
Remarks
Note that the ImageDimension dimension can provide images in two ways, depending on the data binding mode (BoundImageDashboardItem.DataBindingMode).
- The ImageDimension provides images as byte arrays.
The ImageDimension provides parts of URIs used to locate images. For instance, the URI pattern below specifies the path to the folder containing required images.
C:\Users\Public\Documents\DevExpress Demos 20.1\Components\Data\ProductDetailsImages{0}.jpg
Dimension values will be inserted at the position of the {0} placeholder.
To learn more, see Providing Images.
Example
The following example shows how to use a Bound Image dashboard item to display a specified image accessible by a predefined URI.
Note
Example on GitHub: https://github.com/DevExpress-Examples/how-to-bind-a-bound-image-dashboard-item-to-data-in-code-t382366
Imports System.Windows.Forms
Imports DevExpress.DashboardCommon
Imports DevExpress.DataAccess.ConnectionParameters
Imports DevExpress.DataAccess.Sql
Imports DevExpress.XtraEditors
Namespace Dashboard_BoundImage
Partial Public Class Form1
Inherits XtraForm
Public Sub New()
InitializeComponent()
Dim dashboard As New Dashboard()
Dim xmlParams As New XmlFileConnectionParameters()
xmlParams.FileName = "..\..\Data\DashboardProductDetails.xml"
Dim xmlDataSource As New DashboardSqlDataSource("Data Source 1", xmlParams)
Dim selectQuery As SelectQuery = SelectQueryFluentBuilder.AddTable("Products").
SelectColumns("Id", "Name", "Description").Build("Query 1")
xmlDataSource.Queries.Add(selectQuery)
xmlDataSource.Fill()
dashboard.DataSources.Add(xmlDataSource)
Dim boundImage As New BoundImageDashboardItem()
boundImage.DataSource = xmlDataSource
boundImage.DataMember = "Query 1"
boundImage.DataBindingMode = ImageDataBindingMode.Uri
boundImage.ImageDimension = New Dimension("Name")
boundImage.UriPattern = "..\..\ProductDetailsImages\{0}.jpg"
boundImage.SizeMode = ImageSizeMode.Stretch
Dim comboBox As New ListBoxDashboardItem()
comboBox.ShowCaption = False
comboBox.DataSource = xmlDataSource
comboBox.DataMember = "Query 1"
comboBox.FilterDimensions.Add(New Dimension("Name"))
comboBox.ListBoxType = ListBoxDashboardItemType.Radio
comboBox.ShowAllValue = False
dashboard.Items.AddRange(comboBox, boundImage)
dashboardViewer1.Dashboard = dashboard
End Sub
End Class
End Namespace
Related GitHub Examples
The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ImageDimension property.
Note
The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.