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

RadCardView is control that layouts its items as cards based on CardLayout property.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.Data.dll

Syntax:

C#
[TelerikToolboxCategory("Data")]
public class RadCardView : Control

Inheritance: objectRadCardView

Constructors

Initializes a new instance of the Telerik.Windows.Controls.RadCardView class.

C#
public RadCardView()

Fields

Identifies the AutoGenerateDataFieldDescriptors dependency property.

C#
public static readonly DependencyProperty AutoGenerateDataFieldDescriptorsProperty

CanUserSelectProperty

DependencyProperty

Identifies the CanUserSelect dependency property.

C#
public static readonly DependencyProperty CanUserSelectProperty

Identifies the CanUserSortDescriptors dependency property.

C#
public static readonly DependencyProperty CanUserSortDescriptorsProperty

CanUserSortGroupsProperty

DependencyProperty

Identifies the CanUserSortGroups dependency property.

C#
public static readonly DependencyProperty CanUserSortGroupsProperty

Identifies the CardBeginningEdit routed event.

C#
public static readonly RoutedEvent CardBeginningEditEvent

Identifies the CardDataFieldBeginningEdit routed event.

C#
public static readonly RoutedEvent CardDataFieldBeginningEditEvent

Identifies the CardDataFieldEditEnded routed event.

C#
public static readonly RoutedEvent CardDataFieldEditEndedEvent

Identifies the CardDataFieldPreparedEditor routed event.

C#
public static readonly RoutedEvent CardDataFieldPreparedEditorEvent

Identifies the CardDataFieldValidated routed event.

C#
public static readonly RoutedEvent CardDataFieldValidatedEvent

Identifies the CardDataFieldValidating routed event.

C#
public static readonly RoutedEvent CardDataFieldValidatingEvent

Identifies the CardEditEnded routed event.

C#
public static readonly RoutedEvent CardEditEndedEvent

Identifies the CardEditEnding routed event.

C#
public static readonly RoutedEvent CardEditEndingEvent

CardEditTemplateProperty

DependencyProperty

Identifies the CardEditTemplate dependency property.

C#
public static readonly DependencyProperty CardEditTemplateProperty

CardHeaderTemplateProperty

DependencyProperty

Identifies the Telerik.Windows.Controls.RadCardView.CardHeaderTemplate dependency property.

C#
public static readonly DependencyProperty CardHeaderTemplateProperty

CardLayoutProperty

DependencyProperty

Identifies the Telerik.Windows.Controls.RadCardView.CardLayout dependency property.

C#
public static readonly DependencyProperty CardLayoutProperty

CardMarginProperty

DependencyProperty

Identifies the Telerik.Windows.Controls.RadCardView.CardMargin dependency property.

C#
public static readonly DependencyProperty CardMarginProperty

Identifies the CardReadOnlyTemplate dependency property.

C#
public static readonly DependencyProperty CardReadOnlyTemplateProperty

Identifies the CardValidating routed event.

C#
public static readonly RoutedEvent CardValidatingEvent

CellLoadedEvent

RoutedEvent

Identifies the CellLoaded routed event.

C#
public static readonly RoutedEvent CellLoadedEvent

Identifies the CellUnloaded routed event.

C#
public static readonly RoutedEvent CellUnloadedEvent

CollapsedLengthProperty

DependencyProperty

Identifies the Telerik.Windows.Controls.RadCardView.CollapsedLength dependency property.

C#
public static readonly DependencyProperty CollapsedLengthProperty

ControlPanelItemsProperty

DependencyProperty

Identifies the ControlPanelItems dependency property.

C#
public static readonly DependencyProperty ControlPanelItemsProperty

Identifies the DataFieldDescriptorsButtonVisibility dependency property.

C#
public static readonly DependencyProperty DataFieldDescriptorsButtonVisibilityProperty

Identifies the DataFieldDescriptors dependency property.

C#
public static readonly DependencyProperty DataFieldDescriptorsProperty

FilteredEvent

RoutedEvent

Occurs after filtering.

C#
public static readonly RoutedEvent FilteredEvent

Identifies the FilteringDropDownStaysOpen dependency property.

C#
public static readonly DependencyProperty FilteringDropDownStaysOpenProperty

FilteringEvent

RoutedEvent

Occurs before filtering.

C#
public static readonly RoutedEvent FilteringEvent

GroupedEvent

RoutedEvent

Occurs after grouping was performed.

C#
public static readonly RoutedEvent GroupedEvent

GroupingEvent

RoutedEvent

Occurs while grouping is being performed. (Cancelable).

C#
public static readonly RoutedEvent GroupingEvent

Identifies the GroupItemIndentation dependency property.

C#
public static readonly DependencyProperty GroupItemIndentationProperty

Identifies the GroupPanelBackground dependency property.

C#
public static readonly DependencyProperty GroupPanelBackgroundProperty

Identifies the GroupPanelForeground dependency property.

C#
public static readonly DependencyProperty GroupPanelForegroundProperty

GroupPanelItemStyleProperty

DependencyProperty

Identifies the GroupPanelItemStyle dependency property.

C#
public static readonly DependencyProperty GroupPanelItemStyleProperty

GroupPanelStyleProperty

DependencyProperty

Identifies the GroupPanelStyle dependency property.

C#
public static readonly DependencyProperty GroupPanelStyleProperty

IsFilteringAllowedProperty

DependencyProperty

Identifies the IsFilteringAllowedProperty dependency property.

C#
public static readonly DependencyProperty IsFilteringAllowedProperty

IsReadOnlyProperty

DependencyProperty

Identifies the IsReadOnly dependency property.

C#
public static readonly DependencyProperty IsReadOnlyProperty

Identifies the IsSynchronizedWithCurrentItem dependency property.

C#
public static readonly DependencyProperty IsSynchronizedWithCurrentItemProperty

ItemsSourceProperty

DependencyProperty

Identifies the Telerik.Windows.Controls.RadCardView.ItemsSource dependency property.

C#
public static readonly DependencyProperty ItemsSourceProperty

MajorLengthProperty

DependencyProperty

Identifies the Telerik.Windows.Controls.RadCardView.MajorLength dependency property.

C#
public static readonly DependencyProperty MajorLengthProperty

MinorLengthProperty

DependencyProperty

Identifies the Telerik.Windows.Controls.RadCardView.MinorLength dependency property.

C#
public static readonly DependencyProperty MinorLengthProperty

SelectedItemProperty

DependencyProperty

Represents the SelectedItem dependency property.

C#
public static readonly DependencyProperty SelectedItemProperty

Identifies the SelectionChanged routed event.

C#
public static readonly RoutedEvent SelectionChangedEvent

Identifies the ShowCardDataFieldDescriptorSortIndexes dependency property.

C#
public static readonly DependencyProperty ShowCardDataFieldDescriptorSortIndexesProperty

ShowGroupPanelProperty

DependencyProperty

Identifies the ShowGroupPanel dependency property.

C#
public static readonly DependencyProperty ShowGroupPanelProperty

SortedEvent

RoutedEvent

Occurs after sorting was performed.

C#
public static readonly RoutedEvent SortedEvent

SortingEvent

RoutedEvent

Identifies the Sorting routed event.

C#
public static readonly RoutedEvent SortingEvent

Properties

Gets or sets whether fields in the cards of the Telerik.Windows.Controls.RadCardView are generated automatically.

C#
public bool AutoGenerateDataFieldDescriptors { get; set; }

Gets or sets a value indicating whether the user can select card view items.

C#
public bool CanUserSelect { get; set; }
Property Value:

true if user can select; otherwise, false.

Gets or sets a value that indicates whether the user can sort.

C#
public bool CanUserSortDescriptors { get; set; }
Remarks:

You can set this behavior for individual CardDataFieldDescriptor by setting the CardDataFieldDescriptor.AllowSorting property. If the CardDataFieldDescriptor.AllowSorting property and the RadCardView.CanUserSort property are both set, a value of false will take precedence over a value of true.

Gets or sets a value indicating whether this instance can user sort groups.

C#
public bool CanUserSortGroups { get; set; }
Property Value:

true if this instance can user sort groups; otherwise, false.

CardEditTemplate

DataTemplate

Gets or sets the template that should be applied to cards when the card view is in edit mode.

C#
public DataTemplate CardEditTemplate { get; set; }

Gets or sets the data binding for the card header.

C#
public Binding CardHeaderBinding { get; set; }

CardHeaderTemplate

DataTemplate

Gets or sets the DataTemplate that will be applied for the Header of the CardItem.

C#
public DataTemplate CardHeaderTemplate { get; set; }

Gets or sets whether cards are layout in rows or columns.

C#
public CardLayout CardLayout { get; set; }

CardMargin

Thickness

Gets or sets the margin around each card.

C#
public Thickness CardMargin { get; set; }

Gets or sets the template that should be applied to cards when the card view is not in edit mode.

C#
public DataTemplate CardReadOnlyTemplate { get; set; }

Gets or sets the collapsed length of a card.

C#
public double CollapsedLength { get; set; }

Gets or sets the control panel items.

C#
public ObservableCollection<IControlPanelItem> ControlPanelItems { get; set; }

Gets the collection that contains all the data field descriptors.

C#
public CardDataFieldDescriptorCollection DataFieldDescriptors { get; }

Gets or sets a value that indicates whether the data field descriptors button is visible.

C#
public Visibility DataFieldDescriptorsButtonVisibility { get; set; }
Property Value:

CardDataFieldDescriptors button visibility.

Gets or sets the property which controls whether the filtering dropdowns stay open when a click outside of the popups occurs. true if the popups will stay open, otherwise, false

C#
public bool FilteringDropDownStaysOpen { get; set; }

Gets or sets the indentation length for the nested group items.

C#
public double GroupItemIndentation { get; set; }

Gets or sets the color behind the content of the GroupPanel.

C#
public Brush GroupPanelBackground { get; set; }
Property Value:

The group panel background.

Gets or sets the foreground color of the GroupPanel.

C#
public Brush GroupPanelForeground { get; set; }
Property Value:

The group panel foreground.

Gets or sets the group panel cell style.

C#
public Style GroupPanelItemStyle { get; set; }
Property Value:

The group panel cell style.

Gets or sets the group panel style.

C#
public Style GroupPanelStyle { get; set; }
Property Value:

The group panel style.

Gets a value indicating whether the control is currently in edit mode.

C#
public bool IsEditing { get; }

Gets or sets a value indicating whether the control can be filtered through the UI.

C#
public bool IsFilteringAllowed { get; set; }
Property Value:

true if the control can be filtered through the UI; otherwise, false.

Gets or sets whether fields in the cards of the Telerik.Windows.Controls.RadCardView can be edited.

C#
public bool IsReadOnly { get; set; }

Gets or sets whether the current item is synchronized with the current item of the source collection.

C#
public bool IsSynchronizedWithCurrentItem { get; set; }

Gets or sets a collection used to generate the cards of the Telerik.Windows.Controls.RadCardView.

C#
public IEnumerable ItemsSource { get; set; }

Gets the keyboard command provider.

C#
public IKeyboardCommandProvider KeyboardCommandProvider { get; set; }
Property Value:

The keyboard command provider. This class provides command key mappings.

Gets or sets the major dimension of a card. Major dimension is the dimension in which cards are scrolled. When CardLayout is Rows, MajorLength is card width, otherwise it is height.

C#
public double MajorLength { get; set; }

Gets or sets the minor dimension of a card. Minor dimension is the opposite dimension in which cards are scrolled. When CardLayout is Rows, MinorLength is card height, otherwise it is width.

C#
public double MinorLength { get; set; }

Gets all pending commands.

C#
public List<ICommand> PendingCommands { get; }
Property Value:

The pending commands.

Gets the selected card view item.

C#
public object SelectedItem { get; set; }

Gets or sets a value indicating whether dataFieldDescriptor sort indexes are displayed.

C#
public bool ShowCardDataFieldDescriptorSortIndexes { get; set; }
Property Value:

A value indicating whether dataFieldDescriptor sort indexes are displayed.

Gets or sets a value indicating whether to show a group panel.

C#
public bool ShowGroupPanel { get; set; }

Methods

Collapse item or group.

C#
public void Collapse(object item)
Parameters:itemobject

Item that will be collapsed.

Executes all pending commands in a sequence.

C#
public void ExecutePendingCommand()

Expands item or group.

C#
public void Expand(object item)
Parameters:itemobject

Item that will be expanded.

Returns distinct values for a given cardDataFieldDescriptor.

C#
public IEnumerable GetDistinctValues(CardDataFieldDescriptor cardDataFieldDescriptor, bool filter, int? maximumValueCount)
Parameters:cardDataFieldDescriptorCardDataFieldDescriptor

The cardDataFieldDescriptor.

filterbool

A value indicating whether to filter the distinct values base on other cardDataFieldDescriptors' existing filters.

maximumValueCountint?

The maximum amount of distinct values to return. If you specify null for this parameter, then all distinct values will be returned.

Returns:

IEnumerable

An IEnumerable containing the distinct values.

Remarks:

The 'filter' parameter specifies whether distinct values should be filtered according to other cardDataFieldDescriptors' active filters. For example, if we have countries and players and we have filtered by CountryX, when we request all distinct players, if 'filter' is true we will get players from CountryX only. If 'filter' is false we will get all distinct players.

Returns the first 1000 distinct values for the given cardDataFieldDescriptor.

C#
public IEnumerable GetDistinctValues(CardDataFieldDescriptor cardDataFieldDescriptor, bool filter)
Parameters:cardDataFieldDescriptorCardDataFieldDescriptor

The cardDataFieldDescriptor.

filterbool

A value indicating whether to filter the distinct values based on other cardDataFieldDescriptors' existing filters.

Returns:

IEnumerable

An IEnumerable containing the distinct values.

Remarks:

The 'filter' parameter specifies whether distinct values should be filtered according to other cardDataFieldDescriptors' active filters. For example, if we have countries and players and we have filtered by CountryX, when we request all distinct players, if 'filter' is true we will get players from CountryX only. If 'filter' is false we will get all distinct players.

Invoked when ApplyTemplate is called.

C#
public override void OnApplyTemplate()
C#
protected virtual void OnAutoGeneratingDataFieldDescriptor(CardViewAutoGeneratingDataFieldDescriptorEventArgs e)
Parameters:eCardViewAutoGeneratingDataFieldDescriptorEventArgs

Returns class-specific AutomationPeer implementations for the Windows Presentation Foundation (WPF) infrastructure.

C#
protected override AutomationPeer OnCreateAutomationPeer()
Returns:

AutomationPeer

The type-specific AutomationPeer implementation.

Called when the CardViewGroupPanel is changed.

C#
protected virtual void OnGroupPanelChanged(CardViewGroupPanel oldPanel, CardViewGroupPanel newPanel)
Parameters:oldPanelCardViewGroupPanel

The old panel.

newPanelCardViewGroupPanel

The new panel.

Raises the event. This method is invoked whenever is set to true internally.

C#
protected override void OnInitialized(EventArgs e)
Parameters:eEventArgs
C#
protected override void OnKeyDown(KeyEventArgs e)
Parameters:eKeyEventArgs
C#
protected override void OnMouseDown(MouseButtonEventArgs e)
Parameters:eMouseButtonEventArgs

Invoked when an unhandled System.Windows.Input.Mouse.PreviewMouseWheel attached event reaches an element in its route that is derived from this class. Implement this method to add class handling for this event.

C#
protected override void OnPreviewMouseWheel(MouseWheelEventArgs e)
Parameters:eMouseWheelEventArgs

Scrolls the card containing the data item into view.

C#
public void ScrollIntoView(object item)
Parameters:itemobject

The data item to scroll into view.

Events

Occurs before a data field descriptor is auto-generated and added to the DataFieldDescriptors collection.

C#
public event EventHandler<CardViewAutoGeneratingDataFieldDescriptorEventArgs> AutoGeneratingDataFieldDescriptor

Occurs before an edit operation is started.

C#
public event EventHandler<CardViewItemCancelEventArgs> CardBeginningEdit

Occurs before a card's data field is edited.

C#
public event EventHandler<CardDataFieldCancelEventArgs> CardDataFieldBeginningEdit

Occurs after a card's data field is edited.

C#
public event EventHandler<CardDataFieldEditEndedEventArgs> CardDataFieldEditEnded

Occurs when a card's data field editor is prepared for editing.

C#
public event EventHandler<CardDataFieldPreparedEditorEventArgs> CardDataFieldPreparedEditor

Occurs after a card's data field is validated.

C#
public event EventHandler<CardDataFieldValidatedEventArgs> CardDataFieldValidated

Occurs before a card's data field is validated.

C#
public event EventHandler<CardDataFieldValidatingEventArgs> CardDataFieldValidating

Occurs after an edit operation is finished.

C#
public event EventHandler<CardViewEditEndedEventArgs> CardEditEnded

Occurs before an edit operation is finished.

C#
public event EventHandler<CardViewEditEndingEventArgs> CardEditEnding

Occurs when a card is being validated.

C#
public event EventHandler<CardViewItemCancelEventArgs> CardValidating

Occurs when the CardDataFieldDescriptor distinct values is about to be loaded.

C#
public event EventHandler<CardViewDistinctValuesLoadingEventArgs> DistinctValuesLoading

Occurs when a field filter editor has been created. This event allows you to modify certain properties of the editor.

C#
public event EventHandler<CardViewFilterEditorCreatedEventArgs> FieldFilterEditorCreated

Occurs after filter operation.

C#
public event EventHandler<CardViewFilteredEventArgs> Filtered

Occurs before filter operation.

C#
public event EventHandler<CardViewFilteringEventArgs> Filtering

Occurs before the filter operators of the filtering control are loaded. Use this event if you want to remove one or more of the filter operators or if you want to change the one selected by default.

C#
public event EventHandler<FilterOperatorsLoadingEventArgs> FilterOperatorsLoading

Occurs after grouping was performed.

C#
public event EventHandler<CardViewGroupedEventArgs> Grouped

Occurs while grouping is performed. (Cancelable).

C#
public event EventHandler<CardViewGroupingEventArgs> Grouping

SelectionChanged

SelectionChangedEventHandler

Occurs when the selected card view item has changed.

C#
public event SelectionChangedEventHandler SelectionChanged

Occurs after sorted was performed.

C#
public event EventHandler<CardViewSortedEventArgs> Sorted

Occurs before RadCardView performs sorting.

C#
public event EventHandler<CardViewSortingEventArgs> Sorting
In this article
DefinitionConstructorsRadCardView()FieldsAutoGenerateDataFieldDescriptorsPropertyCanUserSelectPropertyCanUserSortDescriptorsPropertyCanUserSortGroupsPropertyCardBeginningEditEventCardDataFieldBeginningEditEventCardDataFieldEditEndedEventCardDataFieldPreparedEditorEventCardDataFieldValidatedEventCardDataFieldValidatingEventCardEditEndedEventCardEditEndingEventCardEditTemplatePropertyCardHeaderTemplatePropertyCardLayoutPropertyCardMarginPropertyCardReadOnlyTemplatePropertyCardValidatingEventCellLoadedEventCellUnloadedEventCollapsedLengthPropertyControlPanelItemsPropertyDataFieldDescriptorsButtonVisibilityPropertyDataFieldDescriptorsPropertyFilteredEventFilteringDropDownStaysOpenPropertyFilteringEventGroupedEventGroupingEventGroupItemIndentationPropertyGroupPanelBackgroundPropertyGroupPanelForegroundPropertyGroupPanelItemStylePropertyGroupPanelStylePropertyIsFilteringAllowedPropertyIsReadOnlyPropertyIsSynchronizedWithCurrentItemPropertyItemsSourcePropertyMajorLengthPropertyMinorLengthPropertySelectedItemPropertySelectionChangedEventShowCardDataFieldDescriptorSortIndexesPropertyShowGroupPanelPropertySortedEventSortingEventPropertiesAutoGenerateDataFieldDescriptorsCanUserSelectCanUserSortDescriptorsCanUserSortGroupsCardEditTemplateCardHeaderBindingCardHeaderTemplateCardLayoutCardMarginCardReadOnlyTemplateCollapsedLengthControlPanelItemsDataFieldDescriptorsDataFieldDescriptorsButtonVisibilityFilteringDropDownStaysOpenGroupItemIndentationGroupPanelBackgroundGroupPanelForegroundGroupPanelItemStyleGroupPanelStyleIsEditingIsFilteringAllowedIsReadOnlyIsSynchronizedWithCurrentItemItemsSourceKeyboardCommandProviderMajorLengthMinorLengthPendingCommandsSelectedItemShowCardDataFieldDescriptorSortIndexesShowGroupPanelMethodsCollapse(object)ExecutePendingCommand()Expand(object)GetDistinctValues(CardDataFieldDescriptor, bool, int?)GetDistinctValues(CardDataFieldDescriptor, bool)OnApplyTemplate()OnAutoGeneratingDataFieldDescriptor(CardViewAutoGeneratingDataFieldDescriptorEventArgs)OnCreateAutomationPeer()OnGroupPanelChanged(CardViewGroupPanel, CardViewGroupPanel)OnInitialized(EventArgs)OnKeyDown(KeyEventArgs)OnMouseDown(MouseButtonEventArgs)OnPreviewMouseWheel(MouseWheelEventArgs)ScrollIntoView(object)EventsAutoGeneratingDataFieldDescriptorCardBeginningEditCardDataFieldBeginningEditCardDataFieldEditEndedCardDataFieldPreparedEditorCardDataFieldValidatedCardDataFieldValidatingCardEditEndedCardEditEndingCardValidatingDistinctValuesLoadingFieldFilterEditorCreatedFilteredFilteringFilterOperatorsLoadingGroupedGroupingSelectionChangedSortedSorting
Not finding the help you need?
Contact Support