New to Telerik UI for WinFormsStart a free 30-day trial

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:

C#
[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, IFilterable

Inheritance: objectMarshalByRefObjectComponentControlScrollableControlRadControlRadListViewRadCardView...

Implements: IAnalyticsProviderIBindableComponentIComponentIComponentTreeHandlerIDisposableIDropTargetIFilterableILayoutHandlerINotifyPropertyChangedISupportInitializeISupportInitializeNotificationISynchronizeInvokeIWin32Window...

Inherited Members RadListView.OnLoad(Size)RadListView.RadListView_Initialized(object, EventArgs)RadListView.CreateChildItems(RadElement)RadListView.BeginUpdate()RadListView.EndUpdate()RadListView.FindItemByKey(object)RadListView.FindItemByKey(object, bool)RadListView.Select(ListViewDataItem[])RadListView.BeginEdit()RadListView.EndEdit()RadListView.CancelEdit()RadListView.ExpandAll()RadListView.CollapseAll()RadListView.CheckSelectedItems()RadListView.UncheckSelectedItems()RadListView.CheckAllItems()RadListView.UncheckAllItems()RadListView.OnLostFocus(EventArgs)RadListView.OnGotFocus(EventArgs)RadListView.IsInputKey(Keys)RadListView.OnMouseDown(MouseEventArgs)RadListView.OnMouseUp(MouseEventArgs)RadListView.OnMouseMove(MouseEventArgs)RadListView.OnKeyDown(KeyEventArgs)RadListView.OnKeyPress(KeyPressEventArgs)RadListView.OnMouseWheel(MouseEventArgs)RadListView.OnThemeNameChanged(ThemeNameChangedEventArgs)RadListView.CanEditElementAtDesignTime(RadElement)RadListView.CreateAccessibilityInstance()RadListView.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadListView.CaseSensitiveColumnNamesRadListView.CheckBoxesPositionRadListView.CheckBoxesAlignmentRadListView.SelectLastAddedItemRadListView.HorizontalScrollStateRadListView.VerticalScrollStateRadListView.ThreeStateModeRadListView.AllowDragDropRadListView.ShowGridLinesRadListView.EnableLassoSelectionRadListView.EnableKineticScrollingRadListView.HotTrackingRadListView.EnableColumnSortRadListView.GroupItemSizeRadListView.GroupIndentRadListView.FilterDescriptorsRadListView.FilterPredicateRadListView.IsDataBoundRadListView.GroupsRadListView.ValueMemberRadListView.DisplayMemberRadListView.CheckedMemberRadListView.EnableSortingRadListView.EnableFilteringRadListView.EnableGroupingRadListView.EnableCustomGroupingRadListView.SortDescriptorsRadListView.GroupDescriptorsRadListView.DataSourceRadListView.DataMemberRadListView.SelectedItemRadListView.SelectedIndexRadListView.CurrentItemRadListView.CurrentColumnRadListView.IsEditingRadListView.ColumnsRadListView.ItemsRadListView.ShowColumnHeadersRadListView.ShowGroupsRadListView.SelectedItemsRadListView.CheckedItemsRadListView.ShowCheckBoxesRadListView.AllowColumnResizeRadListView.AllowColumnReorderRadListView.FullRowSelectRadListView.AllowArbitraryItemWidthRadListView.MultiSelectRadListView.AllowEditRadListView.AllowRemoveRadListView.ActiveEditorRadListView.ViewTypeRadListView.ListViewElementRadListView.HeaderHeightRadListView.KeyboardSearchResetIntervalRadListView.KeyboardSearchEnabledRadListView.FindStringComparerRadListView.CheckOnClickModeRadListView.AutoSizeColumnsModeRadListView.GroupExpandedRadListView.GroupExpandingRadListView.BindingContextChangedRadListView.BindingCompletedRadListView.SelectedItemChangingRadListView.SelectedItemsChangedRadListView.SelectedItemChangedRadListView.SelectedIndexChangedRadListView.ViewTypeChangedRadListView.ViewTypeChangingRadListView.ItemMouseDownRadListView.ItemMouseUpRadListView.ItemMouseMoveRadListView.ItemMouseHoverRadListView.ItemMouseEnterRadListView.ItemMouseLeaveRadListView.ItemMouseClickRadListView.ItemMouseDoubleClickRadListView.ItemCheckedChangingRadListView.ItemCheckedChangedRadListView.VisualItemFormattingRadListView.ItemCreatingRadListView.VisualItemCreatingRadListView.CellFormattingRadListView.ItemDataBoundRadListView.CurrentItemChangedRadListView.CurrentItemChangingRadListView.EditorRequiredRadListView.ItemEditingRadListView.EditorInitializedRadListView.ItemEditedRadListView.ValidationErrorRadListView.ItemValidatingRadListView.ItemValueChangedRadListView.ItemValueChangingRadListView.ColumnCreatingRadListView.CellCreatingRadListView.ItemRemovingRadListView.ItemRemovedRadControl.isResizing2RadControl.isDisposing2RadControl.invalidResizeRectRadControl.isAccessibilityRequestedRadControl.Dispose(bool)RadControl.Construct()RadControl.CreateBehavior()RadControl.CreateRootElement()RadControl.InitializeRootElement(RootRadElement)RadControl.LoadElementTree()RadControl.LoadElementTree(Size)RadControl.SetBackColorThemeOverrides()RadControl.ResetBackColorThemeOverrides()RadControl.SetForeColorThemeOverrides()RadControl.ResetForeColorThemeOverrides()RadControl.OnKeyUp(KeyEventArgs)RadControl.OnPreviewKeyDown(PreviewKeyDownEventArgs)RadControl.OnClick(EventArgs)RadControl.OnDoubleClick(EventArgs)RadControl.OnMouseEnter(EventArgs)RadControl.OnMouseLeave(EventArgs)RadControl.OnMouseHover(EventArgs)RadControl.OnMouseCaptureChanged(EventArgs)RadControl.OnCreateControl()RadControl.OnHandleDestroyed(EventArgs)RadControl.OnParentChanged(EventArgs)RadControl.OnFontChanged(EventArgs)RadControl.OnForeColorChanged(EventArgs)RadControl.OnBackColorChanged(EventArgs)RadControl.OnEnabledChanged(EventArgs)RadControl.OnBindingContextChanged(EventArgs)RadControl.OnLocationChanged(EventArgs)RadControl.OnPaddingChanged(EventArgs)RadControl.OnRightToLeftChanged(EventArgs)RadControl.OnPaint(PaintEventArgs)RadControl.OnLayout(LayoutEventArgs)RadControl.OnAutoSizeChanged(EventArgs)RadControl.WndProc(ref Message)RadControl.OnInvalidated(RadElement)RadControl.OnCaptureLosing()RadControl.OnThemeChanged()RadControl.OnToolTipTextNeeded(object, ToolTipTextNeededEventArgs)RadControl.OnScreenTipNeeded(object, ScreenTipNeededEventArgs)RadControl.ProcessMnemonic(char)RadControl.ProcessFocusRequested(RadElement)RadControl.ProcessCaptureChangeRequested(RadElement, bool)RadControl.ProcessAutoSizeChanged(bool)RadControl.GetInputElement()RadControl.BeginInit()RadControl.EndInit()RadControl.OnNotifyPropertyChanged(string)RadControl.GetPreferredSize(Size)RadControl.SetBoundsCore(int, int, int, int, BoundsSpecified)RadControl.GetRootElementDesiredSize(int, int, int, int)RadControl.OnZoomGesture(ZoomGestureEventArgs)RadControl.OnRotateGesture(RotateGestureEventArgs)RadControl.OnPanGesture(PanGestureEventArgs)RadControl.OnTwoFingerTapGesture(GestureEventArgs)RadControl.OnPressAndTapGesture(PressAndTapGestureEventArgs)RadControl.OnGesture(GestureEventArgs)RadControl.ProcessGesture(Message)RadControl.EnableGesture(GestureType)RadControl.DisableGesture(GestureType)RadControl.Refresh()RadControl.SuspendUpdate()RadControl.ResumeUpdate()RadControl.ResumeUpdate(bool)RadControl.InvokeLayoutCallback(LayoutCallback)RadControl.RegisterHostedControl(RadHostItem)RadControl.UnregisterHostedControl(RadHostItem, bool)RadControl.ResolveStyleGroupForElement(StyleGroup, RadObject)RadControl.GetPlainText()RadControl.ShouldSerializeProperty(RadProperty)RadControl.ShouldSerializeProperty(RadProperty, RadObject)RadControl.ResetProperty(RadProperty, RadObject)RadControl.ProcessCodedUIMessage(ref IPCMessage)RadControl.FindPropertyInChildren(RadControl, IPCMessage)RadControl.ScaleControl(SizeF, BoundsSpecified)RadControl.PerformRadAutoScale(BoundsSpecified?)RadControl.GetMonitorDpiScaleFactor(Control)RadControl.SetRadAutoScale(bool)RadControl.EnableDpiScalingRadControl.EnableRadAutoScaleRadControl.EnableRadFormInitialDpiScalingRadControl.EnableImageDpiScalingRadControl.EnableSvgImagesRadControl.IsLoadedRadControl.ElementTreeRadControl.UseCompatibleTextRenderingDefaultValueRadControl.BehaviorRadControl.RootElementRadControl.PaddingRadControl.ThemeNameRadControl.TextRadControl.EnableThemingRadControl.ThemeClassNameRadControl.ImageListRadControl.ImageScalingSizeRadControl.UseCompatibleTextRenderingRadControl.AutoSizeRadControl.MaximumSizeRadControl.MinimumSizeRadControl.FocusableRadControl.SiteRadControl.CausesValidationRadControl.IsInitializingRadControl.SmallImageListRadControl.SmallImageScalingSizeRadControl.IsDesignModeRadControl.IsDisplayedRadControl.FocusedElementRadControl.AllowShowFocusCuesRadControl.ShowItemToolTipsRadControl.CommandBindingsRadControl.EnableKeyMapRadControl.BackColorRadControl.ForeColorRadControl.FontRadControl.ValidationCancelRadControl.EnableAnalyticsRadControl.AnalyticsNameRadControl.EnableRadAccessibilityObjectsRadControl.EnableCodedUITestsRadControl.EnableCodedUITestsDefaultValueRadControl.EnableUIAutomationRadControl.EnableUIAutomationDefaultValueRadControl.ElementInvalidatedRadControl.ToolTipTextNeededRadControl.ScreenTipNeededRadControl.ThemeNameChangedRadControl.InitializedRadControl.PropertyChangedRadControl.ZoomGestureRadControl.RotateGestureRadControl.PanGestureRadControl.TwoFingerTapGestureRadControl.PressAndTapGesture...

Constructors

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

C#
public RadCardView()

Properties

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

C#
[Browsable(true)]
public override bool AllowArbitraryItemHeight { get; set; }

Overrides: RadListView.AllowArbitraryItemHeight

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

C#
[Browsable(false)]
public RadLayoutControl CardTemplate { get; }

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

C#
[Browsable(false)]
public RadCardViewElement CardViewElement { get; }

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

C#
protected override Size DefaultSize { get; }
Property Value:

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

Overrides: RadListView.DefaultSize

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

C#
[Browsable(true)]
public override Size ItemSize { get; set; }

Overrides: RadListView.ItemSize

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

C#
[Browsable(true)]
public override int ItemSpacing { get; set; }

Overrides: RadListView.ItemSpacing

Methods

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

C#
public void CloseCustomizeDialog()

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

C#
protected override RadListViewElement CreateListViewElement()
Returns:

RadListViewElement

A new RadCardViewElement configured for card view operations.

Overrides: RadListView.CreateListViewElement()

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.

C#
protected override void OnVisibleChanged(EventArgs e)
Parameters:eEventArgs

An EventArgs that contains the event data.

Overrides: RadControl.OnVisibleChanged(EventArgs)

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.

C#
public void ShowCustomizeDialog()

Events

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.

C#
public event CardViewItemCreatingEventHandler CardViewItemCreating

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.

C#
public event CardViewItemFormattingEventHandler CardViewItemFormatting