Skip to main content
Tab

GridViewBatchEditSettings.HighlightSummaryItems Property

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

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v22.1.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 Bootstrap Controls BootstrapGridViewEditingSettings
.BatchEditSettings.HighlightSummaryItems
ASP.NET MVC Extensions MVCxGridViewEditingSettings
.BatchEditSettings.HighlightSummaryItems
ASP.NET Web Forms Controls ASPxGridViewEditingSettings
.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.

GridView - HighlightSummaryItems Property

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:

GridView - BatchEditSummaryDisplayText Event

Note

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

Online Demo

Client Summary Calculation

See Also