界面開發工具DevExpress WinForms使用教程：將Pivot Grid用作主篩選器項

---

下載DevExpress v20.2完整版 DevExpress v20.2漢化資源獲取

DevExpress WinForms能完美構建流暢、美觀且易于使用的應用程序，無論是Office風格的界面，還是分析處理大批量的業務數據，它都能輕松勝任！體驗？點擊下載>>

先決條件

• 平臺：Business Intelligence
• 產品：WinForms Dashboard

 本文演示如何使用Pivot dashboard項目像單選主過濾器項目一樣運行，此方法使用以下功能：按儀表板參數進行過濾、對基礎控件的訪問，條件格式設置以及用于訪問基礎數據的API方法。

 1. 在要用于過濾的Pivot item中創建一組與尺寸對應的儀表盤參數，本文使用四個參數：ProductParam、CategoryParam、CountryParam和CityParam，它們對應于按Periods Pivot item的Product Amount行和列部分中使用的Product、Category、Country和City。

2. 處理 事件，來從clicked元素獲取尺寸的值，并將其傳遞給儀表盤參數。

C#

void OnDashboardItemClick(object sender, DashboardItemMouseActionEventArgs e) {
if(e.DashboardItemName == "pivotDashboardItem1" && !skipFiltering) {
dashboardDesigner1.BeginUpdateParameters();
//clear all parameters
ClearPivotFilter();
//set selected columns and rows to parameters
SetParameterValue(e.GetAxisPoint("Column"));
SetParameterValue(e.GetAxisPoint("Row"));
dashboardDesigner1.EndUpdateParameters();
}
}

 skipFiltering變量指示是否按下Expand / Collapse 按鈕，在這種情況下，該變量用于跳過設置過濾器。

 3. 上面的代碼段未設置或清除單擊元素無法訪問的尺寸值，您需要設置僅與所選相交點對應的參數值，并在設置新的值之前清除儀表盤參數中的先前值。

創建以下用于清除參數值的方法：

C#

void ClearPivotFilter() {
PivotDashboardItem pivotItem = dashboardDesigner1.Dashboard.Items["pivotDashboardItem1"] as PivotDashboardItem;
ClearParameters(pivotItem.Columns);
ClearParameters(pivotItem.Rows);
}

void ClearParameters(DimensionCollection dimensions) {
foreach(var dimension in dimensions)
dashboardDesigner1.Parameters[GetParameterDataMember(dimension.DataMember)].SelectedValue = null;
}

 4. 當最終用戶單擊行或列中的 Expand / Collapse按鈕時，Dashboard Designer將引發事件，處理事件來在這種情況下跳過設置過濾器。

C#

bool skipFiltering = false;
private void dashboardDesigner1_DashboardItemControlCreated(object sender, DevExpress.DashboardWin.DashboardItemControlEventArgs e) {
if(e.DashboardItemName == "pivotDashboardItem1") {
e.PivotGridControl.MouseDown += PivotGridControl_MouseDown;
}
}

private void PivotGridControl_MouseDown(object sender, MouseEventArgs e) {
PivotGridControl pivot = sender as PivotGridControl;
PivotGridHitInfo hi = pivot.CalcHitInfo(e.Location);
skipFiltering = (hi.ValueInfo != null && hi.ValueInfo.ValueHitTest == PivotGridValueHitTest.ExpandButton);
}

 5. 要通過與Pivot Item相關的儀表盤參數篩選其儀表盤項時，請向這些項添加所有必須的尺寸。如果不想向最終用戶顯示尺寸，請將尺寸放置到"Hidden Dimensions" 部分。

然后將以下過濾器表達式添加到儀表盤項目：

Code

([Dimension1] = ?Dimension1Param Or ?Dimension1Param Is Null) And
([Dimension2] = ?Dimension2Param Or ?Dimension2Param Is Null) And
...
 ([DimensionN] = ?DimensionNParam Or ?DimensionNParam Is Null)

本示例使用以下表達式：

Code

([Product] = ?ProductParam Or ?ProductParam Is Null)
And ([Category] = ?CategoryParam Or ?CategoryParam Is Null)
And ([Country] = ?CountryParam Or ?CountryParam Is Null)
And ([City] = ?CityParam Or ?CityParam Is Null)

上面的步驟足以實現最少的過濾功能，進一步的步驟將改善UI操作。

1. Optional. To 突出顯示在Pivot Grid中選擇的單元格，請使用以下表達式添加格式規則：

 (?CityParam Is Not Null Or ?CountryParam Is Not Null Or ?ProductParam Is Not Null Or ?CategoryParam Is Not Null) And ([Product] = ?ProductParam Or ?ProductParam Is Null) And ([Category] = ?CategoryParam Or ?CategoryParam Is Null) And ([Country] = ?CountryParam Or ?CountryParam Is Null) And ([City] = ?CityParam Or ?CityParam Is Null)

2. Optional. 處理DashboardDesigner.CustomizeDashboardItemCaption事件，將Clear Master Filter按鈕添加到該項目的標題：

C#

void OnCustomizeDashboardItemCaption(object sender, CustomizeDashboardItemCaptionEventArgs e) {
if(e.DashboardItemName == "pivotDashboardItem1") {
DashboardToolbarItem showDataItem = new DashboardToolbarItem("Clear Master Filter",
new Action((args) => {
dashboardDesigner1.BeginUpdateParameters();
ClearPivotFilter();
dashboardDesigner1.EndUpdateParameters();
}));
showDataItem.Enabled = IsAnyFilterSet();
showDataItem.SvgImage = svgImageCollection1[0];
e.Items.Insert(0, showDataItem);
}
}

---

DevExpress技術交流群2：775869749      歡迎一起進群討論