ASPxCardView.SummaryDisplayText Event
Enables custom display text to be provided for any summary value.
Namespace: DevExpress.Web
Assembly: DevExpress.Web.v18.2.dll
Declaration
Event Data
The SummaryDisplayText event's data class is ASPxCardViewSummaryDisplayTextEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| EncodeHtml | Gets or sets a value that specifies whether the summary display text keeps any of its values that are HTML as HTML, or instead, strips out the HTML markers. Inherited from ASPxGridSummaryDisplayTextEventArgs. |
| Item | Gets a summary item whose value is being processed. |
| Text | Gets or sets the display text for the summary value currently being processed. Inherited from ASPxGridSummaryDisplayTextEventArgs. |
| Value | Gets the processed summary value. Inherited from ASPxGridSummaryDisplayTextEventArgs. |
Remarks
The SummaryDisplayText event is raised for total summaries.
Initialy, the event parameter’s ASPxGridSummaryDisplayTextEventArgs.Text property contains the text currently displayed in the summary panel. To provide custom text, assign it to this property.
Example
The example below demonstrates how to calculate a summary in the CategoryID column based on the value in the ASPxSpinEdit residing below. Here is how the project works:1) A custom callback is sent to the server within the editor’s client side NumberChanged event handler.2) Handle the SummaryDisplayText event to calculate the required summary value and set the e.Text parameter.
Note
A complete sample project is available at https://github.com/DevExpress-Examples/aspxcardview-how-to-implement-a-summary-whose-value-depends-upon-an-external-editor-value-t333558
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
public partial class _Default : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
}
protected void ASPxCardView1_SummaryDisplayText(object sender, DevExpress.Web.ASPxCardViewSummaryDisplayTextEventArgs e)
{
if (e.Item.FieldName == "CategoryID")
e.Text = string.Format("Sum = {0}", Convert.ToDouble(e.Value) * Convert.ToDouble(ASPxSpinEdit1.Value));
}
}