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

Represents a control that displays a collection of tiles in a list format, allowing for easy organization and interaction with the items. The RadTileList supports features like auto-generation of tiles, grouping, and selection handling, as well as layout management for tiles in a customizable manner. It provides various properties to control the appearance and behavior of the tiles, including TileReorderMode for reordering tiles, Grouping capabilities based on a specified property, and support for touch interactions for handling drag-and-drop scenarios.

Definition

Namespace:Telerik.Windows.Controls

Assembly:Telerik.Windows.Controls.dll

Syntax:

C#
[TelerikToolboxCategory("Navigation")]
public class RadTileList : ItemsControl

Inheritance: objectRadTileList

Constructors

Initializes a new instance of the RadTileList class.

C#
public RadTileList()

Fields

AutoGenerateTileProperty

DependencyProperty

Represents the AutoGenerateTile dependency property.

C#
public static readonly DependencyProperty AutoGenerateTileProperty

CanUserSelectProperty

DependencyProperty

Identifies the CanUserSelect dependency property.

C#
public static readonly DependencyProperty CanUserSelectProperty

GroupHeaderHeightProperty

DependencyProperty

Represents the GroupHeaderHeight dependency property.

C#
public static readonly DependencyProperty GroupHeaderHeightProperty

Represents the GroupHeaderVisibility dependency property.

C#
public static readonly DependencyProperty GroupHeaderVisibilityProperty

GroupOffsetProperty

DependencyProperty

Represents the GroupOffset dependency property.

C#
public static readonly DependencyProperty GroupOffsetProperty

GroupTemplateProperty

DependencyProperty

Represents the GroupTemplate dependency property.

C#
public static readonly DependencyProperty GroupTemplateProperty

Represents the HorizontalTilesAlignment dependency property.

C#
public static readonly DependencyProperty HorizontalTilesAlignmentProperty

OrientationProperty

DependencyProperty

Represents the TilesOrientation dependency property.

C#
public static readonly DependencyProperty OrientationProperty

PanoramaBackgroundProperty

DependencyProperty

Represents the PanoramaBackground dependency property.

C#
public static readonly DependencyProperty PanoramaBackgroundProperty

SelectedIndexProperty

DependencyProperty

Represents the SelectedItem dependency property.

C#
public static readonly DependencyProperty SelectedIndexProperty

SelectedItemProperty

DependencyProperty

Represents the SelectedItem dependency property.

C#
public static readonly DependencyProperty SelectedItemProperty

Identifies the SelectionChanged routed event.

C#
public static readonly RoutedEvent SelectionChangedEvent

SelectionModeProperty

DependencyProperty

Identifies the SelectionMode dependency property.

C#
public static readonly DependencyProperty SelectionModeProperty

Identifies the SelectionMouseButton dependency property.

C#
public static readonly DependencyProperty SelectionMouseButtonProperty

TilePlaceHolderSideProperty

DependencyProperty

Represents the TilePlaceHolderSide Property.

C#
public static readonly DependencyProperty TilePlaceHolderSideProperty

TileReorderModeProperty

DependencyProperty

Represents the TileReorderMode dependency property.

C#
public static readonly DependencyProperty TileReorderModeProperty

Represents the VerticalTilesAlignment dependency property.

C#
public static readonly DependencyProperty VerticalTilesAlignmentProperty

Properties

Gets or sets a value indicating whether tiles will be auto-generated.

C#
public bool AutoGenerateTile { get; set; }

Gets or sets a value indicating whether the user can select a tile.

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

true if user can select; otherwise, false.

Gets or sets the height of the group header.

C#
public GridLength GroupHeaderHeight { get; set; }

Gets or sets the visibility of the groups' headers.

C#
public Visibility GroupHeaderVisibility { get; set; }

Gets or sets a property name that indicates the member to group by.

C#
public string GroupMember { get; set; }

Gets or sets the distance between the groups.

C#
public double GroupOffset { get; set; }

Gets the collection used to generate the groups of RadTileList.

C#
public ObservableCollection<TileGroup> Groups { get; }

GroupTemplate

DataTemplate

Gets or sets the template for the group overlay.

C#
public DataTemplate GroupTemplate { get; set; }

HorizontalTilesAlignment

HorizontalAlignment

Gets or sets HorizontalAlignment of the tiles according to the TileListPanel they are placed.

C#
public HorizontalAlignment HorizontalTilesAlignment { get; set; }

Orientation

Orientation

Gets or sets the orientation of the control. When set to Vertical (default) tiles are arranged top to bottom and if a scrollbar is needed it is horizontal. When set to Horizontal tiles are arranged left to right and if a scrollbar is needed it is vertical.

C#
public Orientation Orientation { get; set; }

Gets or sets the content to be used as panorama effect background.

C#
public object PanoramaBackground { get; set; }

Gets or sets the selected item.

C#
public int SelectedIndex { get; set; }

Gets or sets the selected item.

C#
public object SelectedItem { get; set; }

Gets a collection that contains the data items corresponding to the selected rows.

C#
public ObservableCollection<object> SelectedItems { get; }
Property Value:

A collection of the data items corresponding to the selected rows.

If the SelectionMode property is set to Single, the SelectedItems list will contain only the SelectedItem property value.

SelectionMode

SelectionMode

Gets or sets the SelectionMode. This is a dependency property.

C#
public SelectionMode SelectionMode { get; set; }

Gets or sets which mouse button should be used for selection.

C#
public SelectionMouseButton SelectionMouseButton { get; set; }
Property Value:

The selection mouse button.

Gets or sets the TilePlaceHolderSide.

C#
public double TilePlaceHolderSide { get; set; }

Gets or sets the allowed ways user can reorder tiles.

C#
public TileReorderMode TileReorderMode { get; set; }

VerticalTilesAlignment

VerticalAlignment

Gets or sets VerticalAlignment of the tiles according to the TileListPanel they are placed.

C#
public VerticalAlignment VerticalTilesAlignment { get; set; }

Methods

C#
protected override void ClearContainerForItemOverride(DependencyObject element, object item)
Parameters:elementDependencyObjectitemobject

Creates a Tile.

C#
protected override DependencyObject GetContainerForItemOverride()
Returns:

DependencyObject

C#
protected override bool IsItemItsOwnContainerOverride(object item)
Parameters:itemobjectReturns:

bool

C#
public override void OnApplyTemplate()

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

C#
protected override AutomationPeer OnCreateAutomationPeer()
Returns:

AutomationPeer

The type-specific AutomationPeer implementation.

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

C#
protected override void OnInitialized(EventArgs e)
Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

C#
protected override void OnItemContainerStyleChanged(Style oldItemContainerStyle, Style newItemContainerStyle)
Parameters:oldItemContainerStyleStylenewItemContainerStyleStyle
C#
protected override void OnItemContainerStyleSelectorChanged(StyleSelector oldItemContainerStyleSelector, StyleSelector newItemContainerStyleSelector)
Parameters:oldItemContainerStyleSelectorStyleSelectornewItemContainerStyleSelectorStyleSelector
C#
protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)
Parameters:eNotifyCollectionChangedEventArgs
C#
protected override void OnItemTemplateSelectorChanged(DataTemplateSelector oldItemTemplateSelector, DataTemplateSelector newItemTemplateSelector)
Parameters:oldItemTemplateSelectorDataTemplateSelectornewItemTemplateSelectorDataTemplateSelector
C#
protected override void OnKeyUp(KeyEventArgs e)
Parameters:eKeyEventArgs

Prepares the specified element to display the specified item.

C#
protected override void PrepareContainerForItemOverride(DependencyObject element, object item)
Parameters:elementDependencyObject

Element used to display the specified item.

itemobject

Specified item.

Selects all items.

C#
public void SelectAll()

Unselects all items.

C#
public void UnselectAll()

Events

Occurs when a tile is being generated.

C#
public event EventHandler<AutoGeneratingTileEventArgs> AutoGeneratingTile

SelectionChanged

SelectionChangedEventHandler

Occurs when the selected items have changed.

C#
public event SelectionChangedEventHandler SelectionChanged