Class RadCardView

Represents a card view control that displays a collection of labeled items as cards, where each item is represented by a ListViewDataItem and rendered using a customizable card template with layout controls.

Inheritance
System.Object
RadControl
RadListView
RadCardView
Inherited Members
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

[TelerikToolboxCategory("Data Controls")]
public class RadCardView : RadListView, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IPCHost, IAnalyticsProvider, IFilterable

Constructors

RadCardView()

Initializes a new instance of the RadCardView class with default settings, enabling arbitrary item height and configuring horizontal orientation for the card layout.

Declaration
public RadCardView()

Properties

AllowArbitraryItemHeight

Gets or sets a value indicating whether individual card items can have different heights, allowing for dynamic sizing based on content requirements.

Declaration
public override bool AllowArbitraryItemHeight { get; set; }
Property Value
System.Boolean

Overrides

AllowColumnReorder

This property is not relevant for this class.

Declaration
public override bool AllowColumnReorder { get; set; }
Property Value
System.Boolean

Overrides

AllowColumnResize

This property is not relevant for this class.

Declaration
public override bool AllowColumnResize { get; set; }
Property Value
System.Boolean

Overrides

CardTemplate

Gets the RadLayoutControl used as the card template that defines the layout and appearance of individual card items in the view.

Declaration
public RadLayoutControl CardTemplate { get; }
Property Value
RadLayoutControl

CardViewElement

Gets the card view element that provides the core functionality for displaying and managing card-based items with layout template support.

Declaration
public RadCardViewElement CardViewElement { get; }
Property Value
RadCardViewElement

DefaultSize

Gets the default size for the card view control, providing appropriate dimensions for typical card-based layouts.

Declaration
protected override Size DefaultSize { get; }
Property Value
System.Drawing.Size

A System.Drawing.Size structure representing the default width and height of 200x250 pixels.
Overrides

FullRowSelect

This property is not relevant for this class.

Declaration
public override bool FullRowSelect { get; set; }
Property Value
System.Boolean

Overrides

HeaderHeight

This property is not relevant for this class.

Declaration
public override float HeaderHeight { get; set; }
Property Value
System.Single

Overrides

ItemSize

Gets or sets the default size for individual card items, controlling the dimensions of each card in the view layout.

Declaration
public override Size ItemSize { get; set; }
Property Value
System.Drawing.Size

Overrides

ItemSpacing

Gets or sets the spacing between individual card items, controlling the visual separation and layout density of cards in the view.

Declaration
public override int ItemSpacing { get; set; }
Property Value
System.Int32

Overrides

ShowColumnHeaders

This property is not relevant for this class.

Declaration
public override bool ShowColumnHeaders { get; set; }
Property Value
System.Boolean

Overrides

ShowGridLines

This property is not relevant for this class.

Declaration
public override bool ShowGridLines { get; set; }
Property Value
System.Boolean

Overrides

ViewType

This property is not relevant for this class.

Declaration
public override ListViewType ViewType { get; set; }
Property Value
ListViewType

Overrides

Methods

CloseCustomizeDialog()

Closes the RadCardViewCustomizeDialog and removes the currently selected item from customize mode, returning the card view to its normal display state.

Declaration
public void CloseCustomizeDialog()

CreateListViewElement()

Creates and returns a new instance of the RadCardViewElement that provides the specialized functionality for card-based item display and management.

Declaration
protected override RadListViewElement CreateListViewElement()
Returns
RadListViewElement

A new RadCardViewElement configured for card view operations.
Overrides

OnVisibleChanged(EventArgs)

Handles the visible changed event by updating the card template layout, rebuilding the layout tree, and refreshing the card items layout to ensure proper display.

Declaration
protected override void OnVisibleChanged(EventArgs e)
Parameters
System.EventArgs e

An System.EventArgs that contains the event data.
Overrides

ShowCustomizeDialog()

Displays the RadCardViewCustomizeDialog for the card template and puts the currently selected item into customize mode, allowing users to modify the card layout and appearance.

Declaration
public void ShowCustomizeDialog()

Events

CardViewItemCreating

Occurs when a new LayoutControlItemBase is being created for a card item, allowing customization of the layout control item before it is added to the card template.

Declaration
public event CardViewItemCreatingEventHandler CardViewItemCreating
Event Type
CardViewItemCreatingEventHandler

CardViewItemFormatting

Occurs when a LayoutControlItemBase in the card template needs to be formatted, providing an opportunity to customize the appearance and behavior of individual card elements.

Declaration
public event CardViewItemFormattingEventHandler CardViewItemFormatting
Event Type
CardViewItemFormattingEventHandler

CellCreating

This event is not relevant for this class.

Declaration
public override event ListViewCellElementCreatingEventHandler CellCreating
Event Type
ListViewCellElementCreatingEventHandler

Overrides

CellFormatting

This event is not relevant for this class.

Declaration
public override event ListViewCellFormattingEventHandler CellFormatting
Event Type
ListViewCellFormattingEventHandler

Overrides

ViewTypeChanged

This event is not relevant for this class.

Declaration
public override event EventHandler ViewTypeChanged
Event Type
System.EventHandler

Overrides

ViewTypeChanging

This event is not relevant for this class.

Declaration
public override event ViewTypeChangingEventHandler ViewTypeChanging
Event Type
ViewTypeChangingEventHandler

Overrides

Extension Methods