ClassRadCardView
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.
Definition
Namespace:Telerik.WinControls.UI
Assembly:Telerik.WinControls.UI.dll
Syntax:
[TelerikToolboxCategory("Data Controls")]
[ComplexBindingProperties("DataSource", "DataMember")]
[LookupBindingProperties("DataSource", "DisplayMember", "ValueMember", "CurrentItem")]
public class RadCardView : RadListView, IDropTarget, ISynchronizeInvoke, IWin32Window, IBindableComponent, IComponent, IDisposable, INotifyPropertyChanged, ISupportInitializeNotification, ISupportInitialize, IComponentTreeHandler, ILayoutHandler, IAnalyticsProvider, IFilterableInheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadListViewRadCardView
Implements:
Inherited Members
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
[Browsable(true)]
public override bool AllowArbitraryItemHeight { get; set; }Property Value
Overrides
CardTemplate
Gets the RadLayoutControl used as the card template that defines the layout and appearance of individual card items in the view.
Declaration
[Browsable(false)]
public RadLayoutControl CardTemplate { get; }Property Value
CardViewElement
Gets the card view element that provides the core functionality for displaying and managing card-based items with layout template support.
Declaration
[Browsable(false)]
public RadCardViewElement CardViewElement { get; }Property Value
DefaultSize
Gets the default size for the card view control, providing appropriate dimensions for typical card-based layouts.
ItemSize
Gets or sets the default size for individual card items, controlling the dimensions of each card in the view layout.
Declaration
[Browsable(true)]
public override Size ItemSize { get; set; }Property Value
Overrides
ItemSpacing
Gets or sets the spacing between individual card items, controlling the visual separation and layout density of cards in the view.
Declaration
[Browsable(true)]
public override int ItemSpacing { get; set; }Property Value
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
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.
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 CardViewItemCreatingEvent Value
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 CardViewItemFormattingEvent Value