CustomControlProviderBase.Interactivity Property

Gets methods that allow you to configure interactivity settings.

Namespace: DevExpress.DashboardWin

Assembly: DevExpress.Dashboard.v25.1.Win.dll

NuGet Package: DevExpress.Win.Dashboard

Declaration

C#

protected ICustomItemInteractivityProvider Interactivity { get; }

VB.NET

Protected ReadOnly Property Interactivity As ICustomItemInteractivityProvider

Property Value

Type	Description
ICustomItemInteractivityProvider	An object that contains methods to configure interactivity settings.

Remarks

Use the Interactivity property to configure interactivity settings as drill-down or master filter after you supported interactivity for a custom item. To support interactivity, apply SupportInteractivityAttribute to the CustomItemMetadata object’s properties.

The following code snippet uses the Interactivity property’s methods to set the master filter for a custom Funnel item:

The ChartSelectedItemsChanged event occurs every time you click on a Funnel’s value in the UI. The ICustomItemInteractivityProvider.SetMasterFilter(Object) method sets a new selected value, and calls the SetSelection method once the value changes. CustomControlProviderBase.SetSelection(CustomItemSelection) updates a custom control according to the current master filter selection. Every master filter selection change calls the CustomControlProviderBase.SetSelection(CustomItemSelection) method. The UpdateSelectionMode method updates the ChartControl.SelectionMode property according to the actual master filter mode.

C#

using System.Linq;
using System.Windows.Forms;
using DevExpress.DashboardCommon;
using DevExpress.DashboardWin;

namespace TutorialsCustomItems {
  public class FunnelItemControlProvider : CustomControlProviderBase {
    //...
    void ChartSelectedItemsChanged(object sender, SelectedItemsChangedEventArgs e){
        if (chart.SelectedItems.Count == 0 && Interactivity.CanClearMasterFilter)
            Interactivity.ClearMasterFilter();
        else if (Interactivity.CanSetMasterFilter)
            Interactivity.SetMasterFilter(chart.SelectedItems.OfType<DashboardFlatDataSourceRow>());
    }

    void ChartSelectedItemsChanging(object sender, SelectedItemsChangingEventArgs e){
        if (Interactivity.MasterFilterMode == DashboardItemMasterFilterMode.Single && e.NewItems.OfType<DashboardFlatDataSourceRow>().Count() == 0)
            e.Cancel = true;
    }

    protected override void SetSelection(CustomItemSelection selection){
            chart.ClearSelection();
            foreach (DashboardFlatDataSourceRow item in selection.GetDashboardFlatDataSourceRows(flatData))
                chart.SelectedItems.Add(item);
    }

    void UpdateSelectionMode(){
      switch (Interactivity.MasterFilterMode){
          case DashboardItemMasterFilterMode.Single:
              chart.SelectionMode = ElementSelectionMode.Single;
              break;
          case DashboardItemMasterFilterMode.Multiple:
              chart.SelectionMode = ElementSelectionMode.Extended;
              break;
          default:
              chart.SelectionMode = ElementSelectionMode.None;
              break;
        }
    }
  }
}

VB.NET

Imports System.Linq
Imports System.Windows.Forms
Imports DevExpress.DashboardCommon
Imports DevExpress.DashboardWin

Namespace TutorialsCustomItems
Public Class FunnelItemControlProvider
    Inherits CustomControlProviderBase
  '...
    Private Sub ChartSelectedItemsChanged(ByVal sender As Object, ByVal e As SelectedItemsChangedEventArgs)
        If chart.SelectedItems.Count = 0 AndAlso Interactivity.CanClearMasterFilter Then
            Interactivity.ClearMasterFilter()
        ElseIf Interactivity.CanSetMasterFilter Then
            Interactivity.SetMasterFilter(chart.SelectedItems.OfType(Of DashboardFlatDataSourceRow)())
        End If
    End Sub

    Private Sub ChartSelectedItemsChanging(ByVal sender As Object, ByVal e As SelectedItemsChangingEventArgs)
      If Interactivity.MasterFilterMode = DashboardItemMasterFilterMode.Single AndAlso e.NewItems.OfType(Of DashboardFlatDataSourceRow)().Count() = 0 Then
        e.Cancel = True
      End If
    End Sub

    Protected Overrides Sub SetSelection(ByVal selection As CustomItemSelection)
        chart.ClearSelection()
        For Each item As DashboardFlatDataSourceRow In selection.GetDashboardFlatDataSourceRows(flatData)
          chart.SelectedItems.Add(item)
        Next item
    End Sub
    Private Sub UpdateSelectionMode()
      Select Case Interactivity.MasterFilterMode
        Case DashboardItemMasterFilterMode.Single
          chart.SelectionMode = ElementSelectionMode.Single
        Case DashboardItemMasterFilterMode.Multiple
          chart.SelectionMode = ElementSelectionMode.Extended
        Case Else
          chart.SelectionMode = ElementSelectionMode.None
      End Select
    End Sub
  End Class
End Namespace

Refer to the following tutorial for more information on how to configure master filtering and drill-down for a custom Funnel item: Create an Interactive Data-Aware Item.