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

RadTileList

Class

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:

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

Inheritance: objectRadTileList

Constructors

RadTileList()

Initializes a new instance of the RadTileList class.

public RadTileList()

Fields

AutoGenerateTileProperty

DependencyProperty

Represents the AutoGenerateTile dependency property.

public static readonly DependencyProperty AutoGenerateTileProperty

CanUserSelectProperty

DependencyProperty

Identifies the CanUserSelect dependency property.

public static readonly DependencyProperty CanUserSelectProperty

GroupHeaderHeightProperty

DependencyProperty

Represents the GroupHeaderHeight dependency property.

public static readonly DependencyProperty GroupHeaderHeightProperty

GroupHeaderVisibilityProperty

DependencyProperty

Represents the GroupHeaderVisibility dependency property.

public static readonly DependencyProperty GroupHeaderVisibilityProperty

GroupOffsetProperty

DependencyProperty

Represents the GroupOffset dependency property.

public static readonly DependencyProperty GroupOffsetProperty

GroupTemplateProperty

DependencyProperty

Represents the GroupTemplate dependency property.

public static readonly DependencyProperty GroupTemplateProperty

HorizontalTilesAlignmentProperty

DependencyProperty

Represents the HorizontalTilesAlignment dependency property.

public static readonly DependencyProperty HorizontalTilesAlignmentProperty

OrientationProperty

DependencyProperty

Represents the TilesOrientation dependency property.

public static readonly DependencyProperty OrientationProperty

PanoramaBackgroundProperty

DependencyProperty

Represents the PanoramaBackground dependency property.

public static readonly DependencyProperty PanoramaBackgroundProperty

SelectedIndexProperty

DependencyProperty

Represents the SelectedItem dependency property.

public static readonly DependencyProperty SelectedIndexProperty

SelectedItemProperty

DependencyProperty

Represents the SelectedItem dependency property.

public static readonly DependencyProperty SelectedItemProperty

SelectionChangedEvent

RoutedEvent

Identifies the SelectionChanged routed event.

public static readonly RoutedEvent SelectionChangedEvent

SelectionModeProperty

DependencyProperty

Identifies the SelectionMode dependency property.

public static readonly DependencyProperty SelectionModeProperty

SelectionMouseButtonProperty

DependencyProperty

Identifies the SelectionMouseButton dependency property.

public static readonly DependencyProperty SelectionMouseButtonProperty

TilePlaceHolderSideProperty

DependencyProperty

Represents the TilePlaceHolderSide Property.

public static readonly DependencyProperty TilePlaceHolderSideProperty

TileReorderModeProperty

DependencyProperty

Represents the TileReorderMode dependency property.

public static readonly DependencyProperty TileReorderModeProperty

VerticalTilesAlignmentProperty

DependencyProperty

Represents the VerticalTilesAlignment dependency property.

public static readonly DependencyProperty VerticalTilesAlignmentProperty

Properties

AutoGenerateTile

bool

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

public bool AutoGenerateTile { get; set; }

CanUserSelect

bool

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

public bool CanUserSelect { get; set; }

Property Value:

true if user can select; otherwise, false.

GroupHeaderHeight

GridLength

Gets or sets the height of the group header.

public GridLength GroupHeaderHeight { get; set; }

GroupHeaderVisibility

Visibility

Gets or sets the visibility of the groups' headers.

public Visibility GroupHeaderVisibility { get; set; }

GroupMember

string

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

public string GroupMember { get; set; }

GroupOffset

double

Gets or sets the distance between the groups.

public double GroupOffset { get; set; }

Groups

ObservableCollection<TileGroup>

Gets the collection used to generate the groups of RadTileList.

public ObservableCollection<TileGroup> Groups { get; }

GroupTemplate

DataTemplate

Gets or sets the template for the group overlay.

public DataTemplate GroupTemplate { get; set; }

HorizontalTilesAlignment

HorizontalAlignment

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

public HorizontalAlignment HorizontalTilesAlignment { get; set; }

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.

public Orientation Orientation { get; set; }

PanoramaBackground

object

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

public object PanoramaBackground { get; set; }

SelectedIndex

int

Gets or sets the selected item.

public int SelectedIndex { get; set; }

SelectedItem

object

Gets or sets the selected item.

public object SelectedItem { get; set; }

SelectedItems

ObservableCollection<object>

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

public ObservableCollection<object> SelectedItems { get; }

Property Value:

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

Remarks:

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

SelectionMode

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

public SelectionMode SelectionMode { get; set; }

SelectionMouseButton

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

public SelectionMouseButton SelectionMouseButton { get; set; }

Property Value:

The selection mouse button.

TilePlaceHolderSide

double

Gets or sets the TilePlaceHolderSide.

public double TilePlaceHolderSide { get; set; }

TileReorderMode

Gets or sets the allowed ways user can reorder tiles.

public TileReorderMode TileReorderMode { get; set; }

VerticalTilesAlignment

VerticalAlignment

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

public VerticalAlignment VerticalTilesAlignment { get; set; }

Methods

ClearContainerForItemOverride(DependencyObject, object)

protected override void ClearContainerForItemOverride(DependencyObject element, object item)

Parameters:elementDependencyObjectitemobject

GetContainerForItemOverride()

DependencyObject

Creates a Tile.

protected override DependencyObject GetContainerForItemOverride()

Returns:

DependencyObject

IsItemItsOwnContainerOverride(object)

bool

protected override bool IsItemItsOwnContainerOverride(object item)

Parameters:itemobjectReturns:

bool

OnApplyTemplate()

public override void OnApplyTemplate()

OnCreateAutomationPeer()

AutomationPeer

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

protected override AutomationPeer OnCreateAutomationPeer()

Returns:

AutomationPeer

The type-specific AutomationPeer implementation.

OnInitialized(EventArgs)

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

protected override void OnInitialized(EventArgs e)

Parameters:eEventArgs

The RoutedEventArgs that contains the event data.

OnItemContainerStyleChanged(Style, Style)

protected override void OnItemContainerStyleChanged(Style oldItemContainerStyle, Style newItemContainerStyle)

Parameters:oldItemContainerStyleStylenewItemContainerStyleStyle

OnItemContainerStyleSelectorChanged(StyleSelector, StyleSelector)

protected override void OnItemContainerStyleSelectorChanged(StyleSelector oldItemContainerStyleSelector, StyleSelector newItemContainerStyleSelector)

Parameters:oldItemContainerStyleSelectorStyleSelectornewItemContainerStyleSelectorStyleSelector

OnItemsChanged(NotifyCollectionChangedEventArgs)

protected override void OnItemsChanged(NotifyCollectionChangedEventArgs e)

Parameters:eNotifyCollectionChangedEventArgs

OnItemTemplateSelectorChanged(DataTemplateSelector, DataTemplateSelector)

protected override void OnItemTemplateSelectorChanged(DataTemplateSelector oldItemTemplateSelector, DataTemplateSelector newItemTemplateSelector)

Parameters:oldItemTemplateSelectorDataTemplateSelectornewItemTemplateSelectorDataTemplateSelector

OnKeyUp(KeyEventArgs)

protected override void OnKeyUp(KeyEventArgs e)

Parameters:eKeyEventArgs

PrepareContainerForItemOverride(DependencyObject, object)

Prepares the specified element to display the specified item.

protected override void PrepareContainerForItemOverride(DependencyObject element, object item)

Parameters:elementDependencyObject

Element used to display the specified item.

itemobject

Specified item.

SelectAll()

Selects all items.

public void SelectAll()

UnselectAll()

Unselects all items.

public void UnselectAll()

Events

AutoGeneratingTile

EventHandler<AutoGeneratingTileEventArgs>

Occurs when a tile is being generated.

public event EventHandler<AutoGeneratingTileEventArgs> AutoGeneratingTile

SelectionChanged

SelectionChangedEventHandler

Occurs when the selected items have changed.

public event SelectionChangedEventHandler SelectionChanged