ASPxCardViewBehaviorSettings.AllowSelectByCardClick Property
Gets or sets a value that specifies whether selection via card clicks is available within the ASPxCardView.
Namespace: DevExpress.Web
Assembly: DevExpress.Web.v24.1.dll
NuGet Package: DevExpress.Web
Declaration
Property Value
Type | Default | Description |
---|---|---|
Boolean | false |
|
Property Paths
You can access this nested property as listed below:
Library | Object Type | Path to AllowSelectByCardClick |
---|---|---|
ASP.NET Web Forms Controls | ASPxCardView |
|
ASP.NET MVC Extensions | CardViewSettings |
|
Remarks
In addition to a command column’s check boxes, the ASPxCardView provides an easy way to select single or multiple cards simply by clicking them. To enable this mode, set the AllowSelectByCardClick property to true.
When the AllowSelectByCardClick is enabled, clicking any card clears the previous selection and selects this card.
To select multiple cards, click them while holding down the CTRL key. Clicking a card in this manner toggles its selected state and preserves the selection. To select contiguous cards, click the first card you want to select. Then, hold down the SHIFT key and click the last card. You can continue to customize the selection by clicking individual cards while holding down the CTRL key.
Note
Multiple card selection is available if the ASPxCardViewBehaviorSettings.AllowSelectSingleCardOnly property is disabled.
Example
Web Forms:
<dx:ASPxCardView ID="CardView" ClientInstanceName="cardView" runat="server" DataSourceID="EmployeesDataSource" Width="100%" KeyFieldName="EmployeeID" OnPreRender="CardView_PreRender">
<ClientSideEvents SelectionChanged="OnCardSelectionChanged" />
<SettingsBehavior AllowSelectByCardClick="true" />
<SettingsPager>
<SettingsTableLayout ColumnCount="2" RowsPerPage="2" />
</SettingsPager>
<CardLayoutProperties ColCount="2">
<Items>
...
</Items>
<Styles LayoutItem-Caption-Font-Bold="true" />
</CardLayoutProperties>
<Columns>
....
</Columns>
</dx:ASPxCardView>
MVC:
@Html.DevExpress().CardView(
settings => {
settings.Name = "CardView";
settings.CallbackRouteValues = new { Controller = "FocusingAndSelection", Action = "SelectionPartial" };
settings.SettingsBehavior.AllowSelectByCardClick = true;
...
}).Bind(Model).GetHtml()