ASPxCardView.CardLayoutCreated Event
The event occurs when the card layout is created.
Namespace: DevExpress.Web
Assembly: DevExpress.Web.v24.1.dll
NuGet Package: DevExpress.Web
Declaration
Event Data
The CardLayoutCreated event's data class is ASPxCardViewCardLayoutCreatedEventArgs. The following properties provide information specific to this event:
| Property | Description |
|---|---|
| IsEditingCard | Gets whether the card is in edit mode. |
| Properties | Contains settings related to the FormLayout used in the processed card. |
| VisibleIndex | Gets the visible index of the processed card. |
The event data class exposes the following methods:
| Method | Description |
|---|---|
| FindLayoutItemByColumn(String) | Returns a layout item that belongs to the specified column. |
| FindLayoutItemOrGroup(String) | Returns a layout item or group object with the specified name. |
Remarks
The card view raises the CardLayoutCreated event for each data card when the corresponding card layout is created. You can handle this event to change card styles or settings based on cell values.
In addition to the event argument properties, you can use the FindLayoutItemByColumn(String) and FindLayoutItemOrGroup(String) methods to access and modify layout items or groups.
The following example illustrates how to use the FindLayoutItemByColumn(String) method to find a card’s layout items that belong to the specified columns. It also allows you to change these items’ visibility and column-span if the card is in edit mode.
protected void ASPxCardView1_CardLayoutCreated(object sender, ASPxCardViewCardLayoutCreatedEventArgs e) {
// Applies the card layout to the Edit Form only
if(e.IsEditingCard) {
ASPxCardView cardView = sender as ASPxCardView;
if(cardView.IsNewCardEditing) {
LayoutItem itemOrderID = e.FindLayoutItemByColumn(cardView.KeyFieldName);
itemOrderID.ClientVisible = false;
LayoutItem itemProductName = e.FindLayoutItemByColumn("ProductName");
itemProductName.ColumnSpan = 2;
}
}
}