Skip to content

Task(1048407): Avoided redundant words in WinForms Pivot Grid #1824

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
AravinthSundaramSF wants to merge 5 commits into
base: development
Choose a base branch
from
Open

Task(1048407): Avoided redundant words in WinForms Pivot Grid #1824

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
3969e8e
Task(1048407): Avoided redundant words in WinForms Pivot Grid
AravinthSundaramSF Sep 3, 2026
888bb52
Resolve Ci issues
AravinthSundaramSF Sep 3, 2026
69f4df6
Resolve CI errors
AravinthSundaramSF Sep 3, 2026
e7b44e0
Update redundant changes for PivotGrid "HowTo" files
AravinthSundaramSF Sep 4, 2026
6fb12a6
Update jenkins file to trigger CI
AravinthSundaramSF Sep 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion Jenkinsfile
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
node('content')
node('GithubContent')
{
timestamps
{
Expand Down
18 changes: 9 additions & 9 deletions WindowsForms/Pivot-Grid/Asynchronous-Data-Processing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@ documentation: ug

# Asynchronous Data Processing in WinForms Pivot Grid

Pivot grid control provides support for loading the data in a unique UI thread i.e., the pivot grid control can perform long running operations asynchronously on a background thread. It also loads the data asynchronously for every layout related operation in the pivot grid.
WinForms Pivot Grid provides support for loading the data in a unique UI thread i.e., the control can perform long running operations asynchronously on a background thread. It also loads the data asynchronously for every layout related operation.

## Enabling asynchronous loading

To enable the asynchronous loading support, the [EnableAsyncLoading](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControl.html#Syncfusion_Windows_Forms_PivotAnalysis_PivotGridControl_EnableAsyncLoading) property of pivot grid control is used.
To enable the asynchronous loading support, the [EnableAsyncLoading](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControl.html#Syncfusion_Windows_Forms_PivotAnalysis_PivotGridControl_EnableAsyncLoading) property of Pivot Grid control is used.

Refer to the below code sample to enable the asynchronous loading support in pivot grid.
Refer to the below code sample to enable the asynchronous loading support in Pivot Grid.

{% tabs %}

Expand All @@ -33,19 +33,19 @@ Me.pivotGridControl1.EnableAsyncLoading = True

{% endtabs %}

N> It is possible to find whether the pivot grid control is in asynchronous mode or not by using the [InAsyncMode](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControl.html#Syncfusion_Windows_Forms_PivotAnalysis_PivotGridControl_InAsyncMode) property of pivot grid.
N> It is possible to find whether the Pivot Grid control is in asynchronous mode or not by using the [InAsyncMode](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControl.html#Syncfusion_Windows_Forms_PivotAnalysis_PivotGridControl_InAsyncMode) property of pivot grid.

## Asynchronous operations

Pivot grid control provides support for asynchronous loading for every layout changes such as filtering, sorting, drag and drop operations that manipulate the pivot table field list.
Pivot Grid provides support for asynchronous loading for every layout changes such as filtering, sorting, drag and drop operations that manipulate the pivot table field list.

The below screenshot illustrates the asynchronous data processing while sorting the pivot column item "State".

![Asynchronous-Data-Processing_img1](Asynchronous-Data-Processing_images/Asynchronous-Data-Processing_img1.png)
![Asynchronous data processing during sorting](Asynchronous-Data-Processing_images/Asynchronous-Data-Processing_img1.png)

## Customizing loading icon

The loading icon can be customized by using the [BusyAnimationIcon](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControl.html#Syncfusion_Windows_Forms_PivotAnalysis_PivotGridControl_BusyAnimationIcon) property of pivot grid control.
The loading icon can be customized by using the [BusyAnimationIcon](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControl.html#Syncfusion_Windows_Forms_PivotAnalysis_PivotGridControl_BusyAnimationIcon) property of Pivot Grid control.

Refer to the below code sample to change the default loading icon that is used to denote asynchronous loading.

Expand All @@ -65,7 +65,7 @@ Me.pivotGridControl1.BusyAnimationIcon = Image.FromFile("Loading.gif")

{% endtabs %}

![Asynchronous-Data-Processing_img2](Asynchronous-Data-Processing_images/Asynchronous-Data-Processing_img2.png)
![Customized loading icon](Asynchronous-Data-Processing_images/Asynchronous-Data-Processing_img2.png)

## Disabling loading icon

Expand All @@ -89,7 +89,7 @@ Me.pivotGridControl1.BusyAnimationIcon = Nothing

## Events

Following are the events that are available to indicate the status of asynchronous loading operations in pivot grid control.
Following are the events that are available to indicate the status of asynchronous loading operations in Pivot Grid control.

* The **[AsyncLoadStarted](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControl.html)** event will be fired whenever the asynchronous operation gets started.
* The **[AsyncLoadCompleted](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControl.html)** event will be fired whenever the asynchronous operation gets completed.
Expand Down
30 changes: 15 additions & 15 deletions WindowsForms/Pivot-Grid/Cell-Selection.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@ documentation: ug

# Cell Selection in Windows Forms Pivot Grid

The pivot grid supports cell selection where you can select grid value cells similar to Microsoft Excel. Using this support, selected cells can be copied to clipboard or notepad. The custom operations can be performed on cell selection and also any control can be bound to the pivot grid based on its selected cell values.
WinForms Pivot Grid supports cell selection where you can select grid value cells similar to Microsoft Excel. Using this support, selected cells can be copied to clipboard or notepad. The custom operations can be performed on cell selection and also any control can be bound to the Pivot Grid based on its selected cell values.

## Enabling cell selection

The cell selection support can be enabled in the pivot grid by using the property of [AllowSelection](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControlBase.html#Syncfusion_Windows_Forms_PivotAnalysis_PivotGridControlBase_AllowSelection) property. Also the [AllowSelection](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridModelOptions.html#Syncfusion_Windows_Forms_Grid_GridModelOptions_AllowSelection) property in grid model's options should be set as "Any" to select multiple cells in the pivot grid.
The cell selection support can be enabled in Pivot Grid by using the property of [AllowSelection](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControlBase.html#Syncfusion_Windows_Forms_PivotAnalysis_PivotGridControlBase_AllowSelection) property. Also the [AllowSelection](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridModelOptions.html#Syncfusion_Windows_Forms_Grid_GridModelOptions_AllowSelection) property in grid model's options should be set as "Any" to select multiple cells in the control.

Refer to the below code sample to allow multi cell selection in pivot grid control.
Refer to the below code sample to allow multi cell selection in Pivot Grid control.

{% tabs %}

Expand All @@ -35,11 +35,11 @@ Me.pivotGridControl1.TableModel.Options.AllowSelection = GridSelectionFlags.Any

{% endtabs %}

![Cell-Selection_img1](Cell-Selection_images/Cell-Selection_img1.png)
![Multi-cell selection](Cell-Selection_images/Cell-Selection_img1.png)

## Excel like selection frame

Pivot grid provides support for Excel like selection and the Excel like selection frame can be enabled by setting the properties of [ExcelLikeSelectionFrame](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridModelOptions.html#Syncfusion_Windows_Forms_Grid_GridModelOptions_ExcelLikeSelectionFrame) and [ExcelLikeCurrentCell](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridModelOptions.html#Syncfusion_Windows_Forms_Grid_GridModelOptions_ExcelLikeCurrentCell) to `true`.
Pivot Grid provides support for Excel like selection and the Excel like selection frame can be enabled by setting the properties of [ExcelLikeSelectionFrame](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridModelOptions.html#Syncfusion_Windows_Forms_Grid_GridModelOptions_ExcelLikeSelectionFrame) and [ExcelLikeCurrentCell](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridModelOptions.html#Syncfusion_Windows_Forms_Grid_GridModelOptions_ExcelLikeCurrentCell) to `true`.

{% tabs %}

Expand All @@ -61,9 +61,9 @@ Me.pivotGridControl1.TableModel.Options.ExcelLikeCurrentCell = True

### Excel 2016 like selection frame

Pivot grid provides support to display the selection frame like Excel 2016 by using the [SelectionFrameOption](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridModelOptions.html#Syncfusion_Windows_Forms_Grid_GridModelOptions_SelectionFrameOption) property. By default, the selection frame is set as `Excel2016`.
Pivot Grid provides support to display the selection frame like Excel 2016 by using the [SelectionFrameOption](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridModelOptions.html#Syncfusion_Windows_Forms_Grid_GridModelOptions_SelectionFrameOption) property. By default, the selection frame is set as `Excel2016`.

Refer to the below code sample to set the Excel 2016 like selection frame for selecting cells in the pivot grid.
Refer to the below code sample to set the Excel 2016 like selection frame for selecting cells in the Pivot Grid.

{% tabs %}

Expand All @@ -89,13 +89,13 @@ Me.pivotGridControl1.TableModel.Options.SelectionFrameOption = SelectionFrameOpt

{% endtabs %}

![Cell-Selection_img2](Cell-Selection_images/Cell-Selection_img2.png)
![Excel 2016 selection frame](Cell-Selection_images/Cell-Selection_img2.png)

### Excel 2003 like selection frame

Pivot grid provides support to display the selection frame like Excel 2003 by using the [SelectionFrameOption](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridModelOptions.html#Syncfusion_Windows_Forms_Grid_GridModelOptions_SelectionFrameOption) property.
Pivot Grid provides support to display the selection frame like Excel 2003 by using the [SelectionFrameOption](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridModelOptions.html#Syncfusion_Windows_Forms_Grid_GridModelOptions_SelectionFrameOption) property.

Refer to the below code sample to set the Excel 2003 like selection frame for selecting cells in the pivot grid.
Refer to the below code sample to set the Excel 2003 like selection frame for selecting cells in the Pivot Grid.

{% tabs %}

Expand All @@ -121,11 +121,11 @@ Me.pivotGridControl1.TableModel.Options.SelectionFrameOption = SelectionFrameOpt

{% endtabs %}

![Cell-Selection_img3](Cell-Selection_images/Cell-Selection_img3.png)
![Excel 2003 selection frame](Cell-Selection_images/Cell-Selection_img3.png)

## Customizing selection border

The pivot grid control provides support to customize the default appearance of selection border in Excel-2016 like selection frame.
The Pivot Grid control provides support to customize the default appearance of selection border in Excel-2016 like selection frame.

N> The selection border appearance of Excel 2003 like selection frame cannot be modified.

Expand Down Expand Up @@ -153,7 +153,7 @@ Me.pivotGridControl1.TableModel.Options.SelectionBorderBrush = New SolidBrush(Co

N> The selection border color of Excel 2003 like selection frame is always black and it cannot be modified.

![Cell-Selection_img4](Cell-Selection_images/Cell-Selection_img4.png)
![Customized selection border color](Cell-Selection_images/Cell-Selection_img4.png)

### Changing selection border thickness

Expand All @@ -175,13 +175,13 @@ Me.pivotGridControl1.TableModel.Options.SelectionBorderThickness = 4

{% endtabs %}

![Cell-Selection_img5](Cell-Selection_images/Cell-Selection_img5.png)
![Customized selection border thickness](Cell-Selection_images/Cell-Selection_img5.png)

N> The selection border thickness of Excel 2003 like selection frame is always 2 and it cannot be customized.

## Events

* The **[SelectionChanged](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControlBase.html)** event occurs when the cells get selected in the pivot grid control. This event receives an argument namely [PivotGridSelectionChangedEventArgs](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridSelectionChangedEventArgs.html), which returns an IEnumerable collection of selected items. Each selected item contains the information about selected cell like column, row and value details.
* The **[SelectionChanged](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControlBase.html)** event occurs when the cells get selected in the Pivot Grid control. This event receives an argument namely [PivotGridSelectionChangedEventArgs](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridSelectionChangedEventArgs.html), which returns an IEnumerable collection of selected items. Each selected item contains the information about selected cell like column, row and value details.

* The **[SelectionFrameChanging](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.Grid.GridControlBase.html)** event occurs while changing the Excel like selection frame.

Expand Down
18 changes: 9 additions & 9 deletions WindowsForms/Pivot-Grid/Conditional-Formatting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,13 +9,13 @@ documentation: ug

# Conditional Formatting in Windows Forms Pivot Grid

Conditional formatting is a process of applying customized styles to the cells of pivot grid based on conditions specified by the users.
Conditional formatting is a process of applying customized styles to the cells of WinForms Pivot Grid based on conditions specified by the users.

## Adding conditional formats

Conditional formats can be created by using the instance of [NewRuleConditionalFormat](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.NewRuleConditionalFormat.html) and add it to the [NewRuleCollections](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridNewRuleConditionalFormat.html#Syncfusion_Windows_Forms_PivotAnalysis_PivotGridNewRuleConditionalFormat_NewRuleCollections) property of [PivotGridNewRuleConditionalFormat](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridNewRuleConditionalFormat.html). Then, the created instance of `PivotGridNewRuleConditionalFormat` needs to be added to the [NewRuleConditionalFormat](https://help.syncfusion.com/cr/windowsforms/Syncfusion.Windows.Forms.PivotAnalysis.PivotGridControlBase.html#Syncfusion_Windows_Forms_PivotAnalysis_PivotGridControlBase_NewRuleConditionalFormat) collection.

Refer to the below code sample to add conditional format in the pivot grid control.
Refer to the below code sample to add conditional format in the Pivot Grid control.

{% tabs %}

Expand Down Expand Up @@ -45,11 +45,11 @@ Me.pivotGridControl1.TableControl.NewRuleConditionalFormat.Add(newRuleFormat1)

{% endtabs %}

![Conditional-Formatting_img1](Conditional-Formatting_images/Conditional-Formatting_img1.png)
![Conditional Formatting](Conditional-Formatting_images/Conditional-Formatting_img1.png)

## Rule types

Following are the rule types that are supported by the pivot grid to apply conditional formats based on value cell ranges or conditions specified for a particular summary element.
Following are the rule types that are supported by the Pivot Grid to apply conditional formats based on value cell ranges or conditions specified for a particular summary element.

### Formatting all value cells based on their value range

Expand Down Expand Up @@ -103,7 +103,7 @@ Me.pivotGridControl1.TableControl.NewRuleConditionalFormat.Add(newRuleFormat1)

{% endtabs %}

![Conditional-Formatting_img2](Conditional-Formatting_images/Conditional-Formatting_img2.png)
![Formatting value cells by value range](Conditional-Formatting_images/Conditional-Formatting_img2.png)

### Formatting only value cells based on certain criteria

Expand Down Expand Up @@ -157,7 +157,7 @@ Me.pivotGridControl1.TableControl.NewRuleConditionalFormat.Add(newRuleFormat1)

{% endtabs %}

![Conditional-Formatting_img3](Conditional-Formatting_images/Conditional-Formatting_img3.png)
![Formatting cells that meet defined criteria](Conditional-Formatting_images/Conditional-Formatting_img3.png)

### Formatting top or bottom ranked value cells

Expand Down Expand Up @@ -201,7 +201,7 @@ Me.pivotGridControl1.TableControl.NewRuleConditionalFormat.Add(newRuleFormat1)

{% endtabs %}

![Conditional-Formatting_img4](Conditional-Formatting_images/Conditional-Formatting_img4.png)
![Formatting top or bottom ranked values](Conditional-Formatting_images/Conditional-Formatting_img4.png)

### Formatting only above or below average value cells

Expand Down Expand Up @@ -243,7 +243,7 @@ Me.pivotGridControl1.TableControl.NewRuleConditionalFormat.Add(newRuleFormat1)

{% endtabs %}

![Conditional-Formatting_img5](Conditional-Formatting_images/Conditional-Formatting_img5.png)
![Formatting above or below average values](Conditional-Formatting_images/Conditional-Formatting_img5.png)

### Formatting only unique or duplicate value cells

Expand Down Expand Up @@ -285,7 +285,7 @@ Me.pivotGridControl1.TableControl.NewRuleConditionalFormat.Add(newRuleFormat1)

{% endtabs %}

![Conditional-Formatting_img6](Conditional-Formatting_images/Conditional-Formatting_img6.png)
![Formatting unique or duplicate values](Conditional-Formatting_images/Conditional-Formatting_img6.png)

A demo sample is available in the following location.

Expand Down
Loading