DashboardViewer.SingleFilterDefaultValue Event
OBSOLETE
The SingleFilterDefaultValue event is now obsolete. Use MasterFilterDefaultValues instead.
Use MasterFilterDefaultValues instead.
Namespace: DevExpress.DashboardWin
Assembly: DevExpress.Dashboard.v24.1.Win.dll
NuGet Package: DevExpress.Win.Dashboard
Declaration
[Browsable(false)]
[Obsolete("The SingleFilterDefaultValue event is now obsolete. Use MasterFilterDefaultValues instead.")]
public event SingleFilterDefaultValueEventHandler SingleFilterDefaultValue
Event Data
The SingleFilterDefaultValue event's data class is SingleFilterDefaultValueEventArgs. The following properties provide information specific to this event:
Property | Description |
---|---|
DashboardItemName | Gets the name of the dashboard item for which the SingleFilterDefaultValue event was raised. |
FilterValue | Gets the default filter value. |
The event data class exposes the following methods:
Method | Description |
---|---|
GetAvailableSelections() | Returns records identifying elements that can be selected in the current state of the master filter item. |
SetFilterValue(DashboardDataRow) | Specifies the default filter value. |
SetFilterValue(IList) | Specifies the default filter value. |
Example
This example demonstrates how to initialize master filter in a dashboard loaded in the DashboardViewer control. The code for the DashboardDesigner control is the same, because the DashboardDesigner’s events have the same name and functionality.
The following code initializes master filter items:
- The DashboardViewer.MasterFilterDefaultValues event is handled to apply filtering to Grid and Tree View.
- The DashboardViewer.RangeFilterDefaultValue event is used to select the specified date range in the Range Filter.
Master filter initialization can apply one item’s master filter to another master filter item - a mutual filtering occurs. In that scenario, the MasterFilterDefaultValues event has limitations if the Neutral Filter mode is disabled.
using DevExpress.DashboardCommon;
using System;
using System.Linq;
namespace Dashboard_MFDefaultValues
{
public partial class Form1 : DevExpress.XtraEditors.XtraForm {
public Form1() {
InitializeComponent();
dashboardViewer1.UseNeutralFilterMode = true;
dashboardViewer1.ConfigureDataConnection += DashboardViewer1_ConfigureDataConnection;
dashboardViewer1.MasterFilterDefaultValues += DashboardViewer1_MasterFilterDefaultValues;
dashboardViewer1.RangeFilterDefaultValue += DashboardViewer1_RangeFilterDefaultValue;
dashboardViewer1.Dashboard = new Dashboard1();
}
private void DashboardViewer1_ConfigureDataConnection(object sender, DashboardConfigureDataConnectionEventArgs e)
{
ExtractDataSourceConnectionParameters connParameters = e.ConnectionParameters as ExtractDataSourceConnectionParameters;
connParameters.FileName = "Data\\SalesPerson.dat";
}
private void DashboardViewer1_MasterFilterDefaultValues(object sender, MasterFilterDefaultValuesEventArgs e) {
if (e.ItemComponentName == "gridDashboardItem1") {
e.FilterValues = e.AvailableFilterValues.Where(v => (string)v["Sales Person"] == "Laura Callahan");
}
if (e.ItemComponentName == "treeViewDashboardItem1") {
e.FilterValues = e.AvailableFilterValues.Where(v => (string)v["Category"] == "Beverages" ||
(string)v["Product"] == "Aniseed Syrup");
}
}
private void DashboardViewer1_RangeFilterDefaultValue(object sender, RangeFilterDefaultValueEventArgs e) {
if (e.DashboardItemName == "rangeFilterDashboardItem1") {
e.Range = new RangeFilterSelection(new DateTime(2015, 06, 01), new DateTime(2016, 04, 01));
}
}
}
}