Skip to main content

GridViewBatchEditSettings.HighlightSummaryItems Property

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

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v22.1.dll


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 Bootstrap Controls BootstrapGridViewEditingSettings
ASP.NET MVC Extensions MVCxGridViewEditingSettings
ASP.NET Web Forms Controls ASPxGridViewEditingSettings


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.

GridView - HighlightSummaryItems Property


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" />

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);


GridView - BatchEditSummaryDisplayText Event


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

Online Demo

Client Summary Calculation

See Also