Back to Devexpress

PivotGridFieldOptions.AllowSortBySummary Property

corelibraries-devexpress-dot-xtrapivotgrid-dot-pivotgridfieldoptions-2aeb7a41.md

latest4.1 KB
Original Source

PivotGridFieldOptions.AllowSortBySummary Property

Gets or sets whether end-users can sort the current row/column field values by other column/row summary values.

Namespace : DevExpress.XtraPivotGrid

Assembly : DevExpress.PivotGrid.v25.2.Core.dll

NuGet Packages : DevExpress.PivotGrid.Core, DevExpress.Win.Navigation

Declaration

csharp
[DefaultValue(DefaultBoolean.Default)]
public DefaultBoolean AllowSortBySummary { get; set; }
vb
<DefaultValue(DefaultBoolean.Default)>
Public Property AllowSortBySummary As DefaultBoolean

Property Value

TypeDefaultDescription
DefaultBooleanDefault

A DefaultBoolean value that specifies whether end-users can sort the current row/column field values by other column/row summary values.

|

Available values:

NameDescriptionReturn Value
True

The value is true.

|

0

| | False |

The value is false.

|

1

| | Default |

The value is specified by a global option or a higher-level object.

|

2

|

Property Paths

You can access this nested property as listed below:

Object TypePath to AllowSortBySummary
PivotGridFieldBase

.Options .AllowSortBySummary

|

Remarks

The AllowSortBySummary property is applied if the current field is a column field or row field. If the AllowSortBySummary property is set to True and the current field is a column field, end-users can sort the current field’s values by summary values in other rows. If the current field is a row field, end-users can sort the current field’s values by summary values in other columns. For end-users, this type of sorting is available via context menus, invoked when right-clicking an innermost column or row header.

In this example, selecting the “Sort ‘Product Name’ by This Column” option sorts values of the Product Name field by values in the clicked column:

If the AllowSortBySummary property is set to Default, the ability to sort the current field’s values by values in other rows/columns is specified by the PivotGridOptionsCustomization.AllowSortBySummary property.

To sort a field’s values by other columns/rows in code, use the PivotGridFieldBase.SortBySummaryInfo property.

See Also

AllowSortBySummary

SortBySummaryInfo

SortByColumnIndicatorImage

Sorting by Summary

PivotGridFieldOptions Class

PivotGridFieldOptions Members

DevExpress.XtraPivotGrid Namespace