General Information
.NET Subscription
Desktop
Web
Controls and Extensions
Mainteinance Mode
Enterprise and Analytic Tools
Quality Assurance and Productivity
Frameworks and Libraries
General Information
.NET Subscription
Desktop
Web
Controls and Extensions
Mainteinance Mode
Enterprise and Analytic Tools
Quality Assurance and Productivity
Frameworks and Libraries
ASPxTreeList.HtmlDataCellPrepared Event
Enables the settings of individual cells to be changed.
Namespace: DevExpress.Web.ASPxTreeList
Assembly: DevExpress.Web.ASPxTreeList.v19.2.dll
Declaration
public event TreeListHtmlDataCellEventHandler HtmlDataCellPrepared
Public Event HtmlDataCellPrepared As TreeListHtmlDataCellEventHandler
Event Data
The HtmlDataCellPrepared event handler receives an argument of the TreeListHtmlDataCellEventArgs type. The following properties provide information specific to this event.
Property | Description |
---|---|
Cell | Gets the processed data cell. |
CellValue | Gets the processed cell's value. |
Column | Gets the data column that owns the cell currently being processed. |
Level | Gets the nesting level of a node which contains the processed data cell. |
NodeKey | Gets the key value of a node which contains the processed cell. |
Remarks
The HtmlDataCellPrepared event is raised for each data cell within the ASPxTreeList when the corresponding table cell has been created. You can handle this event to change the style settings of individual cells.
The processed cell is identified by the event parameter's TreeListHtmlDataCellEventArgs.Cell property. Its value is returned by the TreeListHtmlDataCellEventArgs.CellValue property. The column and node where the processed cell resides can be obtained via the TreeListHtmlDataCellEventArgs.Column and TreeListHtmlRowEventArgs.Row properties.
Examples
This example shows how to paint individual data cells and entire nodes depending upon the ASPxTreList's data. The ASPxTreeList.HtmlDataCellPrepared event is handled to custom paint budgets that are greater than $1,000,000.
The ASPxTreeList.HtmlRowPrepared event is handled to custom paint departments located at Monterey.
The image below shows the result:
using System.Drawing;
protected void treeList_HtmlRowPrepared(object sender, TreeListHtmlRowEventArgs e) {
if(Object.Equals(e.GetValue("Location"), "Monterey"))
e.Row.BackColor = Color.FromArgb(211, 235, 183);
}
protected void treeList_HtmlDataCellPrepared(object sender, TreeListHtmlDataCellEventArgs e) {
if(e.Column.Name == "budget") {
decimal value = (decimal)e.CellValue;
e.Cell.BackColor = GetBudgetColor(value);
if(value > 1000000M)
e.Cell.Font.Bold = true;
}
}
Imports System.Drawing
Protected Sub treeList_HtmlRowPrepared(ByVal sender As Object, ByVal e As TreeListHtmlRowEventArgs)
If Object.Equals(e.GetValue("Location"), "Monterey") Then
e.Row.BackColor = Color.FromArgb(211, 235, 183)
End If
End Sub
Protected Sub treeList_HtmlDataCellPrepared(ByVal sender As Object,_
ByVal e As TreeListHtmlDataCellEventArgs)
If e.Column.Name = "budget" Then
Dim value As Decimal = CDec(e.CellValue)
e.Cell.BackColor = GetBudgetColor(value)
If value > 1000000D Then
e.Cell.Font.Bold = True
End If
End If
End Sub