RangeFilterDashboardItem Class

A Range Filter dashboard item that allows end-users to apply filtering to other dashboard items.

Namespace: DevExpress.DashboardCommon
Assembly: DevExpress.Dashboard.v18.1.Core.dll
Syntax
[DashboardItemType("RANGEFILTER")]
public class RangeFilterDashboardItem : SeriesDashboardItem, IDashboardComponent, IComponent, ISupportInitialize, IDisposable, IChangeService, ISupportPrefix, ICurrencyCultureNameProvider, ISliceDataQueryProvider, IDimensionAxes, IMasterFilter, IMasterFilterItem, IDataItemRepositoryProvider, IDataSourceSchemaProvider, IDataItemContainerContext, IDataItemContext, IColorSchemeContext, IFormatRulesContext, IFiltersProvider, IInteractivityOptionsProvider, IArgumentsDashboardItem, IDateTimePeriodContext

The Range Filter allows end-users to apply filtering to other dashboard items. It displays a chart with selection thumbs above that allow you to filter out values displayed along the argument axis.

MainFeatures_RangeFilter

The following documentation is available.

Note

The Range Filter dashboard item cannot be bound to the OLAP data source.

Examples

The following example demonstrates how to bind a Range Filter dashboard item to data in code.

In this example, the Range Filter is used to apply filtering to a pivot dashboard item's data.

´╗┐using System;
using System.Windows.Forms;
using DevExpress.DashboardCommon;
using DevExpress.DataAccess;

namespace Dashboard_CreateRangeFilter {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }
        private RangeFilterDashboardItem CreateRangeFilter(DashboardObjectDataSource dataSource) {

            // Creates a Range Filter dashboard item and specifies its data source.
            RangeFilterDashboardItem rangeFilter = new RangeFilterDashboardItem();            
            rangeFilter.DataSource = dataSource;

            // Creates a new series of the Area type and adds this series to the Series collection to
            // display it within the Range Filter.
            SimpleSeries salesAmountSeries = new SimpleSeries(SimpleSeriesType.Area);
            rangeFilter.Series.Add(salesAmountSeries);

            // Specifies a measure to provide data used to calculate the Y-coordinate of the data points.
            salesAmountSeries.Value = new Measure("Extended Price");

            // Specifies a dimension to provide Range Filter argument values.
            rangeFilter.Argument = new Dimension("OrderDate");

            // Specifies a group interval for argument values.
            rangeFilter.Argument.DateTimeGroupInterval = DateTimeGroupInterval.MonthYear;           

            return rangeFilter;
        }
        private void Form1_Load(object sender, EventArgs e) {

            // Creates a dashboard and sets it as the currently opened dashboard in the dashboard viewer.
            dashboardViewer1.Dashboard = new Dashboard();

            // Creates a data source and adds it to the dashboard data source collection.
            DashboardObjectDataSource dataSource = new DashboardObjectDataSource();
            dataSource.DataSource = (new nwindDataSetTableAdapters.SalesPersonTableAdapter()).GetData();
            dashboardViewer1.Dashboard.DataSources.Add(dataSource);

            // Creates a Range Filter dashboard item with the specified data source 
            // and adds it to the Items collection to display within the dashboard.
            RangeFilterDashboardItem rangeFilter = CreateRangeFilter(dataSource);
            dashboardViewer1.Dashboard.Items.Add(rangeFilter);

            // Creates a pivot and adds it to the dashboard. 
            // Range Filter applies filtering to pivot data.
            PivotDashboardItem pivot = CreatePivot(dataSource);
            dashboardViewer1.Dashboard.Items.Add(pivot);

            // Reloads data in the data sources.
            dashboardViewer1.ReloadData();
        }
    }
}
Inheritance
RangeFilterDashboardItem
See Also