ClassRadListView
Represents a custom Control implementation that may be used to visualize data in a list with different layout strategies.
Definition
Namespace:Telerik.UI.Xaml.Controls.Data
Assembly:Telerik.WinUI.Controls.dll
Syntax:
public class RadListView : RadControl, IView, IElementPresenter
Inheritance: objectRadControlRadListView
Implements:
Inherited Members
Constructors
RadListView()
Initializes a new instance of the RadListView class.
Declaration
public RadListView()
Fields
CurrentItemProperty
Identifies the CurrentItem dependency property.
Declaration
public static readonly DependencyProperty CurrentItemProperty
Field Value
DependencyProperty
DisabledStateOpacityProperty
Identifies the DisabledStateOpacity dependency property.
Declaration
public static readonly DependencyProperty DisabledStateOpacityProperty
Field Value
DependencyProperty
EmptyContentDisplayModeProperty
Identifies the EmptyContentDisplayMode dependency property.
Declaration
public static readonly DependencyProperty EmptyContentDisplayModeProperty
Field Value
DependencyProperty
EmptyContentProperty
Identifies the EmptyContent dependency property.
Declaration
public static readonly DependencyProperty EmptyContentProperty
Field Value
DependencyProperty
EnsureCurrentItemIntoViewProperty
Identifies the EnsureCurrentItemIntoView dependency property.
Declaration
public static readonly DependencyProperty EnsureCurrentItemIntoViewProperty
Field Value
DependencyProperty
GroupHeaderDisplayModeProperty
Identifies the GroupHeaderStyleSelector dependency property.
Declaration
public static readonly DependencyProperty GroupHeaderDisplayModeProperty
Field Value
DependencyProperty
GroupHeaderStyleProperty
Identifies the GroupHeaderStyle dependency property.
Declaration
public static readonly DependencyProperty GroupHeaderStyleProperty
Field Value
DependencyProperty
GroupHeaderStyleSelectorProperty
Identifies the GroupHeaderStyleSelector dependency property.
Declaration
public static readonly DependencyProperty GroupHeaderStyleSelectorProperty
Field Value
DependencyProperty
GroupHeaderTemplateProperty
Identifies the GroupHeaderTemplate dependency property.
Declaration
public static readonly DependencyProperty GroupHeaderTemplateProperty
Field Value
DependencyProperty
GroupHeaderTemplateSelectorProperty
Identifies the GroupHeaderTemplateSelector dependency property.
Declaration
public static readonly DependencyProperty GroupHeaderTemplateSelectorProperty
Field Value
DependencyProperty
IncrementalLoadingBufferItemsCountProperty
Identifies the IncrementalLoadingBufferItemsCount dependency property.
Declaration
public static readonly DependencyProperty IncrementalLoadingBufferItemsCountProperty
Field Value
DependencyProperty
IncrementalLoadingModeProperty
Identifies the IncrementalLoadingMode dependency property.
Declaration
public static readonly DependencyProperty IncrementalLoadingModeProperty
Field Value
DependencyProperty
IsActionOnSwipeEnabledProperty
Identifies the IsActionOnSwipeEnabled dependency property.
Declaration
public static readonly DependencyProperty IsActionOnSwipeEnabledProperty
Field Value
DependencyProperty
IsBusyIndicatorEnabledProperty
Identifies the IsBusyIndicatorEnabled dependency property.
Declaration
public static readonly DependencyProperty IsBusyIndicatorEnabledProperty
Field Value
DependencyProperty
IsItemReorderEnabledProperty
Identifies the IsItemReorderEnabled dependency property.
Declaration
public static readonly DependencyProperty IsItemReorderEnabledProperty
Field Value
DependencyProperty
IsPullToRefreshActiveProperty
Identifies the IsPullToRefreshActive dependency property.
Declaration
public static readonly DependencyProperty IsPullToRefreshActiveProperty
Field Value
DependencyProperty
IsPullToRefreshEnabledProperty
Identifies the IsPullToRefreshEnabled dependency property.
Declaration
public static readonly DependencyProperty IsPullToRefreshEnabledProperty
Field Value
DependencyProperty
IsSynchronizedWithCurrentItemProperty
Identifies the IsSynchronizedWithCurrentItem dependency property.
Declaration
public static readonly DependencyProperty IsSynchronizedWithCurrentItemProperty
Field Value
DependencyProperty
ItemAddedAnimationProperty
Identifies the ItemAddedAnimation dependency property.
Declaration
public static readonly DependencyProperty ItemAddedAnimationProperty
Field Value
DependencyProperty
ItemAnimationModeProperty
Identifies the ItemAnimationMode dependency property.
Declaration
public static readonly DependencyProperty ItemAnimationModeProperty
Field Value
DependencyProperty
ItemRemovedAnimationProperty
Identifies the ItemRemovedAnimation dependency property.
Declaration
public static readonly DependencyProperty ItemRemovedAnimationProperty
Field Value
DependencyProperty
ItemStyleProperty
Identifies the ItemStyle dependency property.
Declaration
public static readonly DependencyProperty ItemStyleProperty
Field Value
DependencyProperty
ItemStyleSelectorProperty
Identifies the ItemStyleSelector dependency property.
Declaration
public static readonly DependencyProperty ItemStyleSelectorProperty
Field Value
DependencyProperty
ItemSwipeDirectionProperty
Identifies the ItemSwipeDirection dependency property.
Declaration
public static readonly DependencyProperty ItemSwipeDirectionProperty
Field Value
DependencyProperty
ItemTemplateProperty
Identifies the ItemTemplate dependency property.
Declaration
public static readonly DependencyProperty ItemTemplateProperty
Field Value
DependencyProperty
ItemTemplateSelectorProperty
Identifies the ItemTemplateSelector dependency property.
Declaration
public static readonly DependencyProperty ItemTemplateSelectorProperty
Field Value
DependencyProperty
ItemsSourceProperty
Identifies the ItemsSource dependency property.
Declaration
public static readonly DependencyProperty ItemsSourceProperty
Field Value
DependencyProperty
LayoutDefinitionProperty
Identifies the LayoutDefinition dependency property.
Declaration
public static readonly DependencyProperty LayoutDefinitionProperty
Field Value
DependencyProperty
ListFooterProperty
Identifies the ListFooter dependency property.
Declaration
public static readonly DependencyProperty ListFooterProperty
Field Value
DependencyProperty
ListHeaderProperty
Identifies the ListHeader dependency property.
Declaration
public static readonly DependencyProperty ListHeaderProperty
Field Value
DependencyProperty
OrientationProperty
Identifies the Orientation dependency property.
Declaration
public static readonly DependencyProperty OrientationProperty
Field Value
DependencyProperty
PullToRefreshScrollModeProperty
Identifies the PullToRefreshScrollMode dependency property.
Declaration
public static readonly DependencyProperty PullToRefreshScrollModeProperty
Field Value
DependencyProperty
RealizedItemsBufferScaleProperty
Identifies the RealizedItemsBufferScale dependency property.
Declaration
public static readonly DependencyProperty RealizedItemsBufferScaleProperty
Field Value
DependencyProperty
ReorderModeProperty
Identifies the ReorderMode dependency property.
Declaration
public static readonly DependencyProperty ReorderModeProperty
Field Value
DependencyProperty
SelectedItemProperty
Identifies the SelectedItem dependency property.
Declaration
public static readonly DependencyProperty SelectedItemProperty
Field Value
DependencyProperty
SelectionModeProperty
Identifies the SelectionMode dependency property.
Declaration
public static readonly DependencyProperty SelectionModeProperty
Field Value
DependencyProperty
SwipeActionContentProperty
Identifies the SwipeActionContent dependency property.
Declaration
public static readonly DependencyProperty SwipeActionContentProperty
Field Value
DependencyProperty
Properties
AggregateDescriptors
Gets the collection of AggregateDescriptorBase objects that defines the current aggregate functions to be applied when the data view is computed.
Declaration
public AggregateDescriptorCollection AggregateDescriptors { get; }
Property Value
CommandService
Gets the CommandService instance that manages the commanding behavior of this instance.
Declaration
public CommandService CommandService { get; }
Property Value
Commands
Gets the collection with all the custom commands registered with the CommandService. Custom commands have higher priority than the built-in (default) ones.
Declaration
public CommandCollection<RadListView> Commands { get; }
Property Value
CurrentItem
Gets the object instance from the ItemsSource that is currently considered as Current.
DisabledStateOpacity
Gets or sets the value of the opacity used when the ListView is disabled.
Declaration
public double DisabledStateOpacity { get; set; }
Property Value
The value of the opacity used when the ListView is disabled.
EmptyContent
Gets or sets the content that will be displayed when there are no items in the list view.
EmptyContentDisplayMode
Gets or sets a value that specifies when the EmptyContent will be displayed.
Declaration
public EmptyContentDisplayMode EmptyContentDisplayMode { get; set; }
Property Value
EnsureCurrentItemIntoView
Gets or sets a value indicating whether the CurrentItem should always be automatically scrolled into view.
Declaration
public bool EnsureCurrentItemIntoView { get; set; }
Property Value
FilterDescriptors
Gets the collection of FilterDescriptorBase objects that defines the current filtering within this instance.
Declaration
public FilterDescriptorCollection FilterDescriptors { get; }
Property Value
GroupDescriptors
Gets the collection of GroupDescriptorBase objects that defines the current grouping within this instance. Multiple group descriptors define multiple group levels.
Declaration
public GroupDescriptorCollection GroupDescriptors { get; }
Property Value
GroupHeaderDisplayMode
Gets or sets the ListViewGroupHeaderDisplayMode instance.
Declaration
public ListViewGroupHeaderDisplayMode GroupHeaderDisplayMode { get; set; }
Property Value
GroupHeaderStyle
Gets or sets a Style that is applied to the group headers.
Declaration
public Style GroupHeaderStyle { get; set; }
Property Value
Style
GroupHeaderStyleSelector
Gets or sets the StyleSelector that provides logic for customizing the appearance for each group header.
Declaration
public StyleSelector GroupHeaderStyleSelector { get; set; }
Property Value
StyleSelector
GroupHeaderTemplate
Gets or sets a DataTemplate that represents the template applied to the group headers.
Declaration
public DataTemplate GroupHeaderTemplate { get; set; }
Property Value
DataTemplate
GroupHeaderTemplateSelector
Gets or sets the DataTemplateSelector that provides logic for customizing the DataTemplate for each group header.
Declaration
public DataTemplateSelector GroupHeaderTemplateSelector { get; set; }
Property Value
DataTemplateSelector
IncrementalLoadingBufferItemsCount
Gets or sets the incremental loading buffer items count.
Declaration
public int IncrementalLoadingBufferItemsCount { get; set; }
Property Value
The incremental loading buffer items count.
IncrementalLoadingMode
Gets or sets a value that specifies the incremental loading mode.
Declaration
public BatchLoadingMode IncrementalLoadingMode { get; set; }
Property Value
IsActionOnSwipeEnabled
Gets or sets a value indicating whether swipe gesture will display the item actions.
IsBusyIndicatorEnabled
Gets or sets a value indicating whether a busy indicator will appear when the data from the source is being loaded.
IsItemReorderEnabled
Gets or sets a value indicating whether the reorder functionality is enabled.
IsPullToRefreshActive
Gets or sets a value indicating whether the is pull to refresh active.
Declaration
public bool IsPullToRefreshActive { get; set; }
Property Value
true if the pull to refresh is active; otherwise, false.
IsPullToRefreshEnabled
Gets or sets a value indicating whether the pull to refresh is enabled.
IsSynchronizedWithCurrentItem
Gets or sets a value indicating whether the SelectedItem and CurrentItem are synchronized.
Declaration
public bool IsSynchronizedWithCurrentItem { get; set; }
Property Value
ItemAddedAnimation
Gets or sets an animation that is played when an item is added.
Declaration
public RadAnimation ItemAddedAnimation { get; set; }
Property Value
ItemAnimationMode
Gets or sets a value that specifies how the item animations are played.
Declaration
public ItemAnimationMode ItemAnimationMode { get; set; }
Property Value
ItemRemovedAnimation
Gets or sets an animation that is played when an item is removed.
Declaration
public RadAnimation ItemRemovedAnimation { get; set; }
Property Value
ItemStyle
Gets or sets a Style that is applied to each visual item in the control.
Declaration
public Style ItemStyle { get; set; }
Property Value
Style
ItemStyleSelector
Gets or sets the StyleSelector that provides logic for customizing the appearance for each visual item in the control.
Declaration
public StyleSelector ItemStyleSelector { get; set; }
Property Value
StyleSelector
ItemSwipeDirection
Gets or sets the swipe direction of the item.
Declaration
public ListViewItemSwipeDirection ItemSwipeDirection { get; set; }
Property Value
ItemSwipeOffset
Gets or sets the item's swipe offset.
Declaration
public Thickness ItemSwipeOffset { get; set; }
Property Value
Thickness
ItemSwipeThreshold
Gets or sets the item's swipe threshold.
ItemTemplate
Gets or sets a DataTemplate that represents the template applied to each visual item in the control.
Declaration
public DataTemplate ItemTemplate { get; set; }
Property Value
DataTemplate
ItemTemplateSelector
Gets or sets the DataTemplateSelector that provides logic for customizing the DataTemplate for each visual item in the control.
Declaration
public DataTemplateSelector ItemTemplateSelector { get; set; }
Property Value
DataTemplateSelector
ItemsSource
Gets or sets the source used to generate the content of the control.
LayoutDefinition
Gets or sets the the layout definition that specifies how the elements will be rendered.
Declaration
public LayoutDefinitionBase LayoutDefinition { get; set; }
Property Value
ListFooter
Gets or sets the content of the footer element.
ListHeader
Gets or sets the content of the header element.
Orientation
Gets or sets the orientation of the control.
Declaration
public Orientation Orientation { get; set; }
Property Value
Orientation
PullToRefreshScrollMode
Gets or sets the scroll mode of pull to refresh indicator.
Declaration
public PullToRefreshScrollMode PullToRefreshScrollMode { get; set; }
Property Value
RealizedItemsBufferScale
Gets or sets the relative to viewport size buffer scale that will be used to realize items outside viewport. Default value is 1.
Declaration
public double RealizedItemsBufferScale { get; set; }
Property Value
ReorderMode
Gets or sets the reorder mode of the RadListView.
Declaration
public ListViewReorderMode ReorderMode { get; set; }
Property Value
ScrollOffset
Gets the scroll offset of the control.
ScrollToCurrentItemOnTap
Gets or sets a value indicating whether if the listView should scroll to the current item on tap.
Declaration
protected bool ScrollToCurrentItemOnTap { get; set; }
Property Value
SelectedItem
Gets or sets the selected item of the RadListView.
SelectedItems
Gets the currently selected items within this instance.
Declaration
public BindableCollection<object> SelectedItems { get; }
Property Value
SelectionMode
Gets or sets the selection mode of the RadListView. The default value is Single.
Declaration
public DataControlsSelectionMode SelectionMode { get; set; }
Property Value
SortDescriptors
Gets the collection of SortDescriptorBase objects that defines the current sorting within this instance. Multiple sort descriptors define a sorting operation by multiple keys.
Declaration
public SortDescriptorCollection SortDescriptors { get; }
Property Value
SwipeActionContent
Gets or sets the content of the second item action control.
Methods
ApplyTemplateCore()
Called when the Framework is called. Inheritors should override this method should they have some custom template-related logic. This is done to ensure that the property is properly initialized.
ClearContainerForGroupHeader(ListViewGroupHeader)
Undoes the effects of the PrepareContainerForGroupHeader method.
Declaration
protected virtual void ClearContainerForGroupHeader(ListViewGroupHeader item)
Parameters
item
ClearContainerForItem(RadListViewItem)
Undoes the effects of the PrepareContainerForItem method.
Declaration
protected virtual void ClearContainerForItem(RadListViewItem item)
Parameters
item
DeselectAll()
Clears the current selection state.
Declaration
public void DeselectAll()
DeselectItem(object)
Removes the selection for the specified data item and removes it from the SelectedItems collection.
EndItemSwipe()
Ends all currently running drag operations.
Declaration
public void EndItemSwipe()
GetContainerForGroupHeader()
Return the element used to display the group header.
Declaration
protected virtual ListViewGroupHeader GetContainerForGroupHeader()
Returns
GetContainerForGroupHeader(bool)
Return the element used to display the group header.
Declaration
protected virtual ListViewGroupHeader GetContainerForGroupHeader(bool isFrozen)
Parameters
isFrozen
Returns
GetContainerForItem()
Return the element used to display the given item.
Declaration
protected virtual RadListViewItem GetContainerForItem()
Returns
GetDataView()
Gets the IDataViewCollection instance that can be used to traverse and/or manipulate the data after all the Sort, Group and Filter operations are applied.
InvalidateLoadDataControl()
Invalidate the ListViewLoadDataControl.
Declaration
protected void InvalidateLoadDataControl()
InvalidateUI()
Recycles all containers and rebuilds the UI.
Declaration
protected virtual void InvalidateUI()
MeasureOverride(Size)
Called in the measure layout pass to determine the desired size.
Declaration
protected override Size MeasureOverride(Size availableSize)
Parameters
availableSize
Size
The available size that was given by the layout system.
Returns
Size
Overrides
MoveCurrentTo(object)
Tries to change the CurrentItem to the specified object. Returns value indicating if the operation is successful.
OnCreateAutomationPeer()
Declaration
protected override AutomationPeer OnCreateAutomationPeer()
Returns
AutomationPeer
Overrides
OnGroupHeaderTap(ListViewGroupHeader)
Throws the command when group header gets tapped.
Declaration
protected virtual void OnGroupHeaderTap(ListViewGroupHeader header)
Parameters
header
The tapped header.
OnTemplateApplied()
Occurs when the method has been called and the template is already successfully applied.
Declaration
protected override void OnTemplateApplied()
Overrides
PrepareContainerForGroupHeader(ListViewGroupHeader, GroupHeaderContext)
Prepare the element to act as the ItemUI for the corresponding group header.
Declaration
protected virtual void PrepareContainerForGroupHeader(ListViewGroupHeader groupHeader, GroupHeaderContext context)
Parameters
groupHeader
context
PrepareContainerForItem(RadListViewItem, object)
Prepare the element to act as the ItemUI for the corresponding item.
Declaration
protected virtual void PrepareContainerForItem(RadListViewItem item, object context)
Parameters
item
context
PrepareLoadDataControl(ListViewLoadDataControl)
Prepare the ListViewLoadDataControl.
Declaration
protected virtual void PrepareLoadDataControl(ListViewLoadDataControl control)
Parameters
control
RebuildUI()
Invalidates the measure of the RadListView content panel.
Declaration
public void RebuildUI()
ScrollIndexIntoView(int)
Attempts to bring the specified index into view asynchronously.
Declaration
public void ScrollIndexIntoView(int index)
Parameters
index
The index to scroll to.
ScrollIndexIntoView(int, Action)
Attempts to bring the specified index into view asynchronously.
ScrollItemIntoView(object)
Attempts to bring the specified data item into view asynchronously.
Declaration
public void ScrollItemIntoView(object item)
Parameters
item
The data item to scroll to.
ScrollItemIntoView(object, Action)
Attempts to bring the specified data item into view asynchronously.
ScrollToPosition(Point)
Scrolls the RadListView to the specified position.
Declaration
public void ScrollToPosition(Point position)
Parameters
position
Point
The position to scroll to.
SelectAll()
Selects all the items as defined by the SelectionMode property.
Declaration
public void SelectAll()
SelectItem(object)
Selects the specified data item and adds it in the SelectedItems collection.
UnapplyTemplateCore()
Removes the current control template. Occurs when a template has already been applied and a new one is applied.
Declaration
protected override void UnapplyTemplateCore()
Overrides
UnloadCore()
Called within the handler of the event. Allows inheritors to provide their specific logic.
Declaration
protected override void UnloadCore()
Overrides
Events
CurrentItemChanged
Occurs when the CurrentItem property has changed.
CurrentItemChanging
Occurs when the CurrentItem property is about to change. The event may be canceled to prevent the actual change.
Declaration
public event CurrentChangingEventHandler CurrentItemChanging
Event Value
CurrentChangingEventHandler
RefreshRequested
Occurs when Pull to refresh is initiated.
ReorderEnded
Declaration
public event EventHandler<ReorderEndedEventArgs> ReorderEnded
Event Value
ReorderStarting
Declaration
public event EventHandler<ReorderStartingEventArgs> ReorderStarting
Event Value
SelectionChanged
Occurs when the currently selected items change.
Declaration
public event EventHandler<ListViewSelectionChangedEventArgs> SelectionChanged
Event Value