New to Telerik UI for WinForms? Start a free 30-day trial

RadCardViewElement

Class

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

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

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

Inheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadListViewElementRadCardViewElement...

Implements: IBindableComponentIBorderElementIBoxElementIBoxStyleIComponentICustomTypeDescriptorIDataItemSourceIDisposableIDrawFillElementIFillElementIImageElementINotifyPropertyChangedIPrimitiveElementIShapedElementIShortcutProviderIStylableElementIStylableNodeISupportDragISupportDropISupportSystemSkinITextPrimitiveITextProvider...

Constructors

RadCardViewElement()

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

public RadCardViewElement()

Properties

CardTemplate

RadLayoutControl

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

public RadLayoutControl CardTemplate { get; }

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.

public override bool BeginEdit()

Returns:

bool

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

Overrides: RadListViewElement.BeginEdit()

CloseCustomizeDialog()

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

public void CloseCustomizeDialog()

CreateViewElement()

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

protected override BaseListViewElement CreateViewElement()

Returns:

BaseListViewElement

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

Overrides: RadListViewElement.CreateViewElement()

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.

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

Parameters:visualItemBaseListViewVisualItem

The visual item that represents the card being edited.

initializableISupportInitialize

The initializable object that supports initialization operations.

editorIInputEditor

The input editor that will handle the editing operations.

Overrides: RadListViewElement.InitializeEditor(BaseListViewVisualItem, ISupportInitialize, IInputEditor)

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.

protected virtual void OnCardViewItemCreating(CardViewItemCreatingEventArgs args)

Parameters:argsCardViewItemCreatingEventArgs

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.

protected virtual void OnCardViewItemFormatting(CardViewItemFormattingEventArgs args)

Parameters:argsCardViewItemFormattingEventArgs

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.

protected override void OnLoaded()

Overrides: LightVisualElement.OnLoaded()

SetSelectedItemValue(ListViewItemValueChangingEventArgs, object)

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

protected override void SetSelectedItemValue(ListViewItemValueChangingEventArgs valueChangingArgs, object newValue)

Parameters:valueChangingArgsListViewItemValueChangingEventArgs

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

newValueobject

The new value to be assigned to the selected item.

Overrides: RadListViewElement.SetSelectedItemValue(ListViewItemValueChangingEventArgs, object)

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.

public void ShowCustomizeDialog()

Events

CardViewItemCreating

CardViewItemCreatingEventHandler

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.

public event CardViewItemCreatingEventHandler CardViewItemCreating

CardViewItemFormatting

CardViewItemFormattingEventHandler

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.

public event CardViewItemFormattingEventHandler CardViewItemFormatting