Class RadCardViewElement

Represents the main element of RadCardView that provides the core functionality for displaying and managing card-based data items with customizable layout templates.

Inheritance
System.Object
DisposableObject
RadObject
RadElement
VisualElement
RadComponentElement
RadItem
UIItemBase
LightVisualElement
RadListViewElement
RadCardViewElement
Inherited Members
System.Object.Equals(System.Object)
System.Object.Equals(System.Object, System.Object)
System.Object.ReferenceEquals(System.Object, System.Object)
System.Object.GetHashCode()
System.Object.GetType()
System.Object.MemberwiseClone()
Namespace: Telerik.WinControls.UI
Assembly: Telerik.WinControls.UI.dll

Syntax

public class RadCardViewElement : RadListViewElement, INotifyPropertyChanged, ICustomTypeDescriptor, ISupportSystemSkin, IComponent, IDisposable, IBindableComponent, ISupportDrag, ISupportDrop, IShortcutProvider, IStylableElement, IStylableNode, IPrimitiveElement, IShapedElement, IFillElement, IBorderElement, IBoxStyle, IBoxElement, IDrawFillElement, IImageElement, ITextPrimitive, ITextProvider, IDataItemSource

Constructors

RadCardViewElement()

Initializes a new instance of the RadCardViewElement class with default settings, configuring the view type for icons-based card display.

Declaration
public RadCardViewElement()

Properties

CardTemplate

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

Declaration
public RadLayoutControl CardTemplate { get; }
Property Value
RadLayoutControl

ViewType

This property is not relevant for this class.

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

Overrides

Methods

BeginEdit()

Begins an edit operation on the currently selected item, allowing in-place editing of the card content if a current column is available.

Declaration
public override bool BeginEdit()
Returns
System.Boolean

true if the edit operation was successfully initiated; otherwise, false.
Overrides

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()

CreateViewElement()

Creates and returns a specialized view element for the card view that handles card-specific layout and rendering operations.

Declaration
protected override BaseListViewElement CreateViewElement()
Returns
BaseListViewElement

A new CardListViewElement configured for card-based item display and management.
Overrides

InitializeEditor(BaseListViewVisualItem, ISupportInitialize, IInputEditor)

Initializes the editor for in-place editing of card items, setting up the editor with the appropriate visual item and data context.

Declaration
protected override void InitializeEditor(BaseListViewVisualItem visualItem, ISupportInitialize initializable, IInputEditor editor)
Parameters
BaseListViewVisualItem visualItem

The visual item that represents the card being edited.
System.ComponentModel.ISupportInitialize initializable

The initializable object that supports initialization operations.
IInputEditor editor

The input editor that will handle the editing operations.
Overrides

OnCardViewItemCreating(CardViewItemCreatingEventArgs)

Raises the CardViewItemCreating event when a new layout control item is being created, providing an opportunity to customize the item before it is added to the card.

Declaration
protected virtual void OnCardViewItemCreating(CardViewItemCreatingEventArgs args)
Parameters
CardViewItemCreatingEventArgs args

A CardViewItemCreatingEventArgs that contains the event data including the item being created and customization options.

OnCardViewItemFormatting(CardViewItemFormattingEventArgs)

Raises the CardViewItemFormatting event when a layout control item needs formatting, allowing custom styling and configuration of card elements.

Declaration
protected virtual void OnCardViewItemFormatting(CardViewItemFormattingEventArgs args)
Parameters
CardViewItemFormattingEventArgs args

A CardViewItemFormattingEventArgs that contains the event data including the item being formatted and formatting options.

OnLoaded()

Called when the element has been successfully loaded, including all its children, and handles the integration of the card template into the control hierarchy.

Declaration
protected override void OnLoaded()
Overrides

SetSelectedItemValue(ListViewItemValueChangingEventArgs, Object)

Sets the value of the selected item during editing operations, handling value validation and change notifications for card item updates.

Declaration
protected override void SetSelectedItemValue(ListViewItemValueChangingEventArgs valueChangingArgs, object newValue)
Parameters
ListViewItemValueChangingEventArgs valueChangingArgs

The ListViewItemValueChangingEventArgs instance containing the event data for the value change operation.
System.Object newValue

The new value to be assigned to the selected item.
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 in CardListViewVisualItem, 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

Extension Methods