All docs
V20.2
21.1 (EAP/Beta)
20.2
20.1
19.2
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
The page you are viewing does not exist in version 18.2. This link will take you to the root page.
18.1
The page you are viewing does not exist in version 18.1. This link will take you to the root page.
17.2
The page you are viewing does not exist in version 17.2. This link will take you to the root page.
Tab

GridViewBatchEditSettings.HighlightSummaryItems Property

Specifies whether the grid highlights summaries when their values are updated.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v20.2.dll

Declaration

[DefaultValue(false)]
public bool HighlightSummaryItems { get; set; }

Property Value

Type Default Description
Boolean

false

true, to highlight updated summaries; otherwise, false.

Property Paths

You can access this nested property as listed below:

Library Object Type Path to HighlightSummaryItems
ASP.NET Controls and MVC Extensions ASPxGridViewEditingSettings
.BatchEditSettings.HighlightSummaryItems
ASP.NET Bootstrap Controls BootstrapGridViewEditingSettings
.BatchEditSettings.HighlightSummaryItems
BootstrapGridViewEditingSettings
.BatchEditSettings.HighlightSummaryItems
ASP.NET MVC Extensions MVCxGridViewEditingSettings
.BatchEditSettings.HighlightSummaryItems

Remarks

The grid does not highlight its summaries when their values are recalculated in real time (EnableRealTimeSummaryRecalculation). To enable this functionality, set the HighlightSummaryItems property to true. The grid applies the following colors to summary values:

  • Green - The grid recalculated a summary value successfully.

  • Red - The grid failed to recalculate a summary value. A callback is required.

  • Grey - The grid failed to recalculate a summary value due to limitations.

NOTE

The grid highlights summary values only after a user modifies grid data cells.

<dx:ASPxGridView ID="GridView" runat="server" ...>
      ...
    <SettingsEditing Mode="Batch">
        <BatchEditSettings HighlightSummaryItems="True" />
    </SettingsEditing>
</dx:ASPxGridView>

Alternatively, you can handle the BatchEditSummaryDisplayText client-side event to specify custom visual styles.

function onBatchEditSummaryDisplayText(s, e) {
    if (e.summaryFieldName === "Total") {
        var isValueChanged = e.value !== e.serverValue;
        var hasLargeValue = e.value > 1300000;
        ASPxClientUtils.ToggleClassName(e.summaryElement, "summaryItemChangedValue", isValueChanged);
        ASPxClientUtils.ToggleClassName(e.summaryElement, "summaryItemLargeValue", hasLargeValue);
    }
}

Result:

NOTE

The BatchEditSummaryDisplayText event has higher priority over the HighlightSummaryItems property setting.

Online Demo

Client Summary Calculation

See Also