ASPxAutoCompleteBoxBase.ItemTextCellPrepared Event
Occurs on the server side before a text cell has been rendered.
Namespace: DevExpress.Web
Assembly: DevExpress.Web.v24.1.dll
NuGet Package: DevExpress.Web
Declaration
Event Data
The ItemTextCellPrepared event's data class is ListBoxItemTextCellPreparedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| Column | Gets the column that owns a cell that is about to be processed. |
| Item | Gets an item object related to the event. |
| TextCell | Gets the currently processed cell of the editor. |
Remarks
Write a ItemTextCellPrepared event handler to customize the cell appearance (CssClass, Tooltip, control styles) before it is rendered.
The editor’s content is customized using the ASPxAutoCompleteBoxBase.ItemTemplate property.
To set an attribute to a processed item, use the client SetItemTextCellAttribute(itemIndex, textCellIndex, attributeName, attributeValue) method.
function OnClick(s, e) {
comboBox.SetItemTextCellAttribute(5, 1, "your_attribute_name", "attribute_value");
}
Example
The following example illustrates how to customize the appearance of combo box items.
string GetItemTooltip(ListEditItem item) {
return string.Format("Country: {0}\r\nCity: {1} \r\nAddress: {2}",
item.GetFieldValue("Country"), item.GetFieldValue("City"), item.GetFieldValue("Address"));
}
protected void customersComboBox_ItemTextCellPrepared(object sender, ListBoxItemTextCellPreparedEventArgs e) {
if(e.Column.FieldName == "ContactName") {
string contactTitle = e.Item.GetFieldValue("ContactTitle").ToString();
if(contactTitle == "Owner") {
e.TextCell.CssClass += " owner";
e.TextCell.ToolTip = "Owner";
}
}
if(e.Column.FieldName == "Phone")
e.TextCell.CssClass += " phone";
}
protected void customersComboBox_ItemRowPrepared(object sender, ListBoxItemRowPreparedEventArgs e) {
e.Row.ToolTip = GetItemTooltip(e.Item);
}