ClassRadCardViewElement
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, IDataItemSourceInheritance: objectDisposableObjectRadObjectRadElementVisualElementRadComponentElementRadItemUIItemBaseLightVisualElementRadListViewElementRadCardViewElement
Implements:
Inherited Members
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
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
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
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
visualItem
The visual item that represents the card being edited.
initializable
The initializable object that supports initialization operations.
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
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
args
CardViewItemFormattingEventArgs
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
valueChangingArgs
ListViewItemValueChangingEventArgs
The ListViewItemValueChangingEventArgs instance containing the event data for the value change operation.
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 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